Re: [PATCH v5 0/6] agents: add skills for Fixes tags, stable tags, similar bugs, and commit messages
From: Krzysztof Kozlowski
Date: Thu Nov 12 2026 - 09:09:49 EST
On 12/11/2026 14:46, Theodore Tso wrote:
> On Thu, Nov 12, 2026 at 09:26:09AM -0500, Krzysztof Kozlowski wrote:
>>
>> All these are docs (even if you call them as a skill, it's the same),
>> therefore they should be placed in Documentation, not in top-level. We
>> should not create one documentation for humans and another for agents.
>> It's just one documentation.
>
> Skills aren't necessarily *just* documentation. The skills
> specification[1] also defines a structured location in the skill's
> directory hierarchy for Python scripts or other executables.
Specification is also documentation, just like for example specification
for our ABI. It's also located in Documentation directory.
Agents supposedly "are just tools", thus just as sparse, smatch and
compilers such tools do not get another top-level directory.
Best regards,
Krzysztof