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

From: Theodore Tso

Date: Thu Nov 12 2026 - 11:02:43 EST


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.

If the complaint is that it is visible when we run "ls", one
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.

Cheers,

- Ted