Re: [PATCH v5 0/6] agents: add skills for Fixes tags, stable tags, similar bugs, and commit messages

[Krzysztof Kozlowski <krzk@kernel.org>]

On 12/11/2026 15:42, Theodore Tso wrote:
> On Thu, Nov 12, 2026 at 02:49:09PM -0500, Krzysztof Kozlowski wrote:
>>
>> Specification is also documentation, just like for example specification
>> for our ABI. It's also located in Documentation directory.
> 
> Source and header files can also contain documentation.  But we don't
> put them in the Documentation directory because they do not contain
> *exclusively* documentation.

The type of file and its main purpose is a C unit file. Documentation is
only an addon to that.

Here, the main purpose and type of file is documentation. Specification
IS a documentation, just like in-kernel ABI specification is.

I found no other than RST and MD files in this patchset, so I really do
not understand why this is not documentation.

> 
> If the complaint is that it is visible when we run "ls", one

Yes, that's one complain and making it hidden is improving the
perception, but it does not solve the point - it's Documentation so
should be placed in respective directory.

> compromise might be to put the skills in .agents/skills.  This is a
> cross-harness standard which is supported by some code harneses
> (Google Antigravity, Github Copilot, etc.).  Some harneses (including
> Claude Code, Opencode) don't, but people who use these harneses can
> solve it by installing their own symlink from .claude/skills,
> .opencode/skills, etc. to the right place.

Why does it have to be in the top-level in the first place? There is no
point in making LLM stuff visible to humans, except maybe pleasing
people behind upcoming IPO...

Best regards,
Krzysztof