On 16 October 2026 16:28:21 BST, Sasha Levin <[email protected]> wrote: >Add agents/ as a home for skills and other resources for >coding assistants. Describe the skill layout in coding-assistants.rst, >together with the rule that skills only inspect and report, and add a >MAINTAINERS entry covering the directory.
I feel this "agents" would be ok, make sure not to let it conflict with the base agents.md file. Reviewed-by: Bradley Morgan <[email protected]> > >Assisted-by: LLM >Signed-off-by: Sasha Levin <[email protected]> >--- > Documentation/process/coding-assistants.rst | 14 ++++++++++++++ > MAINTAINERS | 6 ++++++ > 2 files changed, 20 insertions(+) > >diff --git a/Documentation/process/coding-assistants.rst >b/Documentation/process/coding-assistants.rst >index 051f0d819f68e..1efc7b08f09f8 100644 >--- a/Documentation/process/coding-assistants.rst >+++ b/Documentation/process/coding-assistants.rst >@@ -19,6 +19,20 @@ For guidelines on content generated by AI coding assistants >see: > > * Documentation/process/generated-content.rst > >+Agent resources >+=============== >+ >+Skills for coding assistants live under ``agents/skills/``, one directory per >+skill with a ``SKILL.md`` entry point in the `Agent Skills format >+<https://agentskills.io/specification>`_. Each skill points at the process >+documents that apply to its task and adds only what assistants tend to get >+wrong. >+ >+Skills inspect and report. They do not change files, create commits or tags, >+or send mail. A skill returns its result with the evidence for it, or says >what >+is missing. Do not fill a missing result with a guess or a placeholder, and do >+not finalize the work until it is resolved. >+ > Licensing and Legal Requirements > ================================ > >diff --git a/MAINTAINERS b/MAINTAINERS >index f53047aa8d3c1..9e522cda56f1b 100644 >--- a/MAINTAINERS >+++ b/MAINTAINERS >@@ -713,6 +713,12 @@ F: Documentation/filesystems/afs.rst > F: fs/afs/ > F: include/trace/events/afs.h > >+AGENT RESOURCES >+M: Sasha Levin <[email protected]> >+L: [email protected] >+S: Maintained >+F: agents/ >+ > AGPGART DRIVER > M: David Airlie <[email protected]> > L: [email protected] > --- Thanks! "I'm not a very positive person" - Linus torvalds
