Re: [PATCH 0/2] agents: add portable agent skills and Fixes attribution

[Sasha Levin <sashal@kernel.org>]

On Wed, Oct 14, 2026 at 07:48:38PM +0200, Miguel Ojeda wrote:
>On Thu, 08 Oct 2026 18:54:51 -0400 Sasha Levin <sashal@kernel.org> 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