On Wed, Oct 14, 2026 at 07:48:38PM +0200, Miguel Ojeda wrote:
On Thu, 08 Oct 2026 18:54:51 -0400 Sasha Levin <[email protected]> wrote:
I'm not sure whether this belongs under Documentation/ or in a separate
agents/ directory at the root. I'm open to changing the location.
Either way, we still need local setup to use these skills in at least a couple
popular tools, right?
One discussion point could be which markup language to use. If we were to do it
in `agents/`, I guess Markdown could be a possibility. But reStructuredText and
having it in `Documentation/` would allow to have it rendered and to "link"
things more easily, which could potentially be useful for certain skills.
Anyway, I tested it with a simple case invoking it explicitly, and it seems to
work, including one where it was not an actual bug (it complained about it :).
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.
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 :)
[1] https://agentskills.io/specification
--
Thanks,
Sasha
