On Wed, Oct 14, 2026 at 01:58:07PM -0500, Sasha Levin wrote:
> I'm following the specs[1] for these skills, and my testing showed it works
> fine with a few of the more common tools.
>
> We can open the markup language discussion, but I'm concerned that doing that
> will break some tools logic around importing these at skills.
Most modern LLM's can deal with .md, .rst, .txt, and even .html
(although I don't recommend HTML mostly because it's more
token-inefficient and it's easier to insert prompt-injection attacks
in the form of 1 point text that is a lot harder for humans to notice).
> This was one of the reasons I sent the first version as agents/ rather than
> something under Documentation/ - this really feels like coding in English vs
> writing docs for humans :)
My preference is agents/ because these skills really aren't docs at
all. This is especially true if some of future skills invoke python
scripts.
- Ted
