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

[Miguel Ojeda]

On Thu, Oct 15, 2026 at 4:43 PM Theodore Tso <tytso@xxxxxxx> wrote:
>
> I'm a bit confused why people are assuming that we would need to have
> copies of the same or similar content in Documentation/ and agents/.
> For agents are are *doing* somethiing --- for example, determining the
> correct commit for a Fixes: tag is not something I'd think would be relevant for Documentations.

I am confused -- I am not saying we will have copies between
`Documentation/` and `agents/` of similar content.

I am saying that `SKILL.md` is necessarily Markdown (please see
Sasha's patch), but most of the actual text is in the `.rst` instead,
and that such a split is more complicated than a single Markdown file,
especially if we don't plan to do any processing on it (as you say, it
is mostly text).

(I do think certain skills may want to point the agent to some
`Documentation/` by file path; that is fine.)

Cheers,
Miguel