Re: [PATCH v3 1/7] agents: add infrastructure for agent resources

[Bradley Morgan]

On 16 October 2026 16:28:21 BST, Sasha Levin <sashal@xxxxxxxxxx> 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 <brads@xxxxxxxxxxxxxx>


>
>Assisted-by: LLM
>Signed-off-by: Sasha Levin <sashal@xxxxxxxxxx>
>---
> 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 <sashal@xxxxxxxxxx>
>+L:	workflows@xxxxxxxxxxxxxxx
>+S:	Maintained
>+F:	agents/
>+
> AGPGART DRIVER
> M:	David Airlie <airlied@xxxxxxxxxx>
> L:	dri-devel@xxxxxxxxxxxxxxxxxxxxx
>

--- Thanks!
"I'm not a very positive person" - Linus torvalds