How is this different from a README.md with a code block?
The code block isn't an executable script?
This strikes me as entirely logical in the short run, and an insane way of packaging software that we will certainly regret in the long run.
Re:Agent Skills
by joe_the_user on Tuesday February 03, 2026 @05:27PM
(#46878240)
"Just a document" can certainly contain a script or code or whatever.
Re:Agent Skills
by theshrike79 on Wednesday February 04, 2026 @02:43AM
(#46882716)
Of course, but the agent can't run a code block in a readme.
It _can_ run a PEP723 script without any specific setup (as long as uv and python are installed). It will automatically create a virtual environment AND install all dependencies. All with a single command without polluting the context with tons of setup.
Of course any LLM can write any script based on a document, but that's not very deterministic.
A good example is Anthropic's PDF creator skill. It has the basic english instructions as well as actual Python code to generate PDFs