[RFC PATCH 00/10] AGENTS.md and associated skills

Alex Bennée posted 10 patches 2 weeks ago
Patches applied successfully (tree, apply log)
git fetch https://github.com/patchew-project/qemu tags/patchew/20260505170105.228162-1-alex.bennee@linaro.org
Maintainers: "Alex Bennée" <alex.bennee@linaro.org>
There is a newer version of this series
MAINTAINERS                                   |   6 +
.agents/skills/checkpatch/SKILL.md            |  10 ++
.agents/skills/distil-mail-thread/SKILL.md    |  33 +++++
.../distil-mail-thread/scripts/parse_mail.py  |  64 +++++++++
.agents/skills/qemu-build/SKILL.md            |  50 +++++++
.agents/skills/qemu-code-explorer/SKILL.md    |  67 +++++++++
.../qemu-code-explorer/evals/evals.json       |  26 ++++
.agents/skills/qemu-code-reviewer/SKILL.md    |  74 ++++++++++
.agents/skills/qemu-issue-helper/SKILL.md     |  47 +++++++
.agents/skills/qemu-issue-triage/SKILL.md     |  91 ++++++++++++
.../qemu-issue-triage/assets/labels.txt       | 133 ++++++++++++++++++
.../skills/qemu-issue-triage/evals/evals.json |  18 +++
.../scripts/update_labels.sh                  |  16 +++
.agents/skills/qemu-testing/SKILL.md          |  53 +++++++
.gitignore                                    |   1 +
AGENTS.md                                     |  94 +++++++++++++
16 files changed, 783 insertions(+)
create mode 100644 .agents/skills/checkpatch/SKILL.md
create mode 100644 .agents/skills/distil-mail-thread/SKILL.md
create mode 100644 .agents/skills/distil-mail-thread/scripts/parse_mail.py
create mode 100644 .agents/skills/qemu-build/SKILL.md
create mode 100644 .agents/skills/qemu-code-explorer/SKILL.md
create mode 100644 .agents/skills/qemu-code-explorer/evals/evals.json
create mode 100644 .agents/skills/qemu-code-reviewer/SKILL.md
create mode 100644 .agents/skills/qemu-issue-helper/SKILL.md
create mode 100644 .agents/skills/qemu-issue-triage/SKILL.md
create mode 100644 .agents/skills/qemu-issue-triage/assets/labels.txt
create mode 100644 .agents/skills/qemu-issue-triage/evals/evals.json
create mode 100755 .agents/skills/qemu-issue-triage/scripts/update_labels.sh
create mode 100644 .agents/skills/qemu-testing/SKILL.md
create mode 100644 AGENTS.md
[RFC PATCH 00/10] AGENTS.md and associated skills
Posted by Alex Bennée 2 weeks ago
Not withstanding the current contributor policy there are a number of
areas that AI agents could be helpful for. This series introduces an
AGENTS.md file which is the basic guide to the source tree and a
number of "skills". Skills are like scripts except far less clearly
defined. However I have found the issue triage skill quite useful for
off-loading the drudgery of going through stuff by hand. I've also
used the issue helper to automate the task of starting a debug session
by pulling in test cases from the tracker.

These originally where a set of skills for ECA (eca.dev) but I've
ported them across to the agent agnostic .agents directory. There are
still some cases where the ECA heritage shows through though
(specifically the code explorer skill could be better).

I'm not suggesting this is ready for up-streaming but I'm posting the
collected set for comment and I'd be interested how well these hold up
across different agentic systems.

Alex.

Alex Bennée (10):
  AGENTS.md: add basic AGENTS.md for QEMU
  .agents/skills: add qemu-code-explorer skill
  .agents/skills: add qemu-code-reviewer skill
  .agents/skills: add qemu-issue-helper skill
  .agents/skills: add qemu-build skill
  .agents/skills: add qemu-testing skill
  .agents/skills: add skill to distil mail threads
  .agents/skills: add qemu-issue-triage agent skill
  .agents/skills: add checkpatch agent skill
  MAINTAINERS: add a section for AI agents

 MAINTAINERS                                   |   6 +
 .agents/skills/checkpatch/SKILL.md            |  10 ++
 .agents/skills/distil-mail-thread/SKILL.md    |  33 +++++
 .../distil-mail-thread/scripts/parse_mail.py  |  64 +++++++++
 .agents/skills/qemu-build/SKILL.md            |  50 +++++++
 .agents/skills/qemu-code-explorer/SKILL.md    |  67 +++++++++
 .../qemu-code-explorer/evals/evals.json       |  26 ++++
 .agents/skills/qemu-code-reviewer/SKILL.md    |  74 ++++++++++
 .agents/skills/qemu-issue-helper/SKILL.md     |  47 +++++++
 .agents/skills/qemu-issue-triage/SKILL.md     |  91 ++++++++++++
 .../qemu-issue-triage/assets/labels.txt       | 133 ++++++++++++++++++
 .../skills/qemu-issue-triage/evals/evals.json |  18 +++
 .../scripts/update_labels.sh                  |  16 +++
 .agents/skills/qemu-testing/SKILL.md          |  53 +++++++
 .gitignore                                    |   1 +
 AGENTS.md                                     |  94 +++++++++++++
 16 files changed, 783 insertions(+)
 create mode 100644 .agents/skills/checkpatch/SKILL.md
 create mode 100644 .agents/skills/distil-mail-thread/SKILL.md
 create mode 100644 .agents/skills/distil-mail-thread/scripts/parse_mail.py
 create mode 100644 .agents/skills/qemu-build/SKILL.md
 create mode 100644 .agents/skills/qemu-code-explorer/SKILL.md
 create mode 100644 .agents/skills/qemu-code-explorer/evals/evals.json
 create mode 100644 .agents/skills/qemu-code-reviewer/SKILL.md
 create mode 100644 .agents/skills/qemu-issue-helper/SKILL.md
 create mode 100644 .agents/skills/qemu-issue-triage/SKILL.md
 create mode 100644 .agents/skills/qemu-issue-triage/assets/labels.txt
 create mode 100644 .agents/skills/qemu-issue-triage/evals/evals.json
 create mode 100755 .agents/skills/qemu-issue-triage/scripts/update_labels.sh
 create mode 100644 .agents/skills/qemu-testing/SKILL.md
 create mode 100644 AGENTS.md

-- 
2.47.3


Re: [RFC PATCH 00/10] AGENTS.md and associated skills
Posted by Peter Maydell 1 week, 5 days ago
On Tue, 5 May 2026 at 18:03, Alex Bennée <alex.bennee@linaro.org> wrote:
>
> Not withstanding the current contributor policy there are a number of
> areas that AI agents could be helpful for. This series introduces an
> AGENTS.md file which is the basic guide to the source tree and a
> number of "skills". Skills are like scripts except far less clearly
> defined. However I have found the issue triage skill quite useful for
> off-loading the drudgery of going through stuff by hand. I've also
> used the issue helper to automate the task of starting a debug session
> by pulling in test cases from the tracker.
>
> These originally where a set of skills for ECA (eca.dev) but I've
> ported them across to the agent agnostic .agents directory. There are
> still some cases where the ECA heritage shows through though
> (specifically the code explorer skill could be better).
>
> I'm not suggesting this is ready for up-streaming but I'm posting the
> collected set for comment and I'd be interested how well these hold up
> across different agentic systems.

I guess my overall comment on this is some mix of:
 * how much of this is generically useful as opposed to
   stuff that's personally helpful to you and should remain
   part of your local setup / preferences?
 * how much do we want to put into git to start with?

I'm in favour of starting with an AGENTS.md that says basically:
 (1) "don't generate code for upstream, point the agent user at
      our AI policy"
 (2) "if you're looking for security issues, read our security
      policy to see what is in scope and what is not"
(in whatever language appears effective)

and then perhaps adding more things gradually where there's
a consensus that they're broadly useful.

thanks
-- PMM
Re: [RFC PATCH 00/10] AGENTS.md and associated skills
Posted by Daniel P. Berrangé 1 week, 5 days ago
On Thu, May 07, 2026 at 09:59:06AM +0100, Peter Maydell wrote:
> On Tue, 5 May 2026 at 18:03, Alex Bennée <alex.bennee@linaro.org> wrote:
> >
> > Not withstanding the current contributor policy there are a number of
> > areas that AI agents could be helpful for. This series introduces an
> > AGENTS.md file which is the basic guide to the source tree and a
> > number of "skills". Skills are like scripts except far less clearly
> > defined. However I have found the issue triage skill quite useful for
> > off-loading the drudgery of going through stuff by hand. I've also
> > used the issue helper to automate the task of starting a debug session
> > by pulling in test cases from the tracker.
> >
> > These originally where a set of skills for ECA (eca.dev) but I've
> > ported them across to the agent agnostic .agents directory. There are
> > still some cases where the ECA heritage shows through though
> > (specifically the code explorer skill could be better).
> >
> > I'm not suggesting this is ready for up-streaming but I'm posting the
> > collected set for comment and I'd be interested how well these hold up
> > across different agentic systems.
> 
> I guess my overall comment on this is some mix of:
>  * how much of this is generically useful as opposed to
>    stuff that's personally helpful to you and should remain
>    part of your local setup / preferences?
>  * how much do we want to put into git to start with?
> 
> I'm in favour of starting with an AGENTS.md that says basically:
>  (1) "don't generate code for upstream, point the agent user at
>       our AI policy"
>  (2) "if you're looking for security issues, read our security
>       policy to see what is in scope and what is not"
> (in whatever language appears effective)

Yes, we definitely need those two pieces.

> and then perhaps adding more things gradually where there's
> a consensus that they're broadly useful.

Personally I'm open to having much more in AGENTS.md in particular
since it doesn't cost us much from a maint POV to have it.

The skills I'm not so sure of, simply as I have little relevant
experience.

For a while Thomas Huth has been doing significant issue triage,
but he's stepped back from most of his QEMU work. If Alex intends
to pick up some of the slack using an agent for issue triage, I'd
be inclined to have the issue triage skills in git. Even if Alex
is the only one using it for now, it is good for redundancy if we
have the setup recorded.

With regards,
Daniel
-- 
|: https://berrange.com       ~~        https://hachyderm.io/@berrange :|
|: https://libvirt.org          ~~          https://entangle-photo.org :|
|: https://pixelfed.art/berrange   ~~    https://fstop138.berrange.com :|


Re: [RFC PATCH 00/10] AGENTS.md and associated skills
Posted by Philippe Mathieu-Daudé 1 week, 5 days ago
On 7/5/26 10:59, Peter Maydell wrote:
> On Tue, 5 May 2026 at 18:03, Alex Bennée <alex.bennee@linaro.org> wrote:
>>
>> Not withstanding the current contributor policy there are a number of
>> areas that AI agents could be helpful for. This series introduces an
>> AGENTS.md file which is the basic guide to the source tree and a
>> number of "skills". Skills are like scripts except far less clearly
>> defined. However I have found the issue triage skill quite useful for
>> off-loading the drudgery of going through stuff by hand. I've also
>> used the issue helper to automate the task of starting a debug session
>> by pulling in test cases from the tracker.
>>
>> These originally where a set of skills for ECA (eca.dev) but I've
>> ported them across to the agent agnostic .agents directory. There are
>> still some cases where the ECA heritage shows through though
>> (specifically the code explorer skill could be better).
>>
>> I'm not suggesting this is ready for up-streaming but I'm posting the
>> collected set for comment and I'd be interested how well these hold up
>> across different agentic systems.
> 
> I guess my overall comment on this is some mix of:
>   * how much of this is generically useful as opposed to
>     stuff that's personally helpful to you and should remain
>     part of your local setup / preferences?
>   * how much do we want to put into git to start with?

Parts could be shared under a 'qemu' folder within mainstream
review-prompts project:

  https://github.com/masoncl/review-prompts

> 
> I'm in favour of starting with an AGENTS.md that says basically:
>   (1) "don't generate code for upstream, point the agent user at
>        our AI policy"
>   (2) "if you're looking for security issues, read our security
>        policy to see what is in scope and what is not"
> (in whatever language appears effective)
> 
> and then perhaps adding more things gradually where there's
> a consensus that they're broadly useful.
> 
> thanks
> -- PMM
> 


Re: [RFC PATCH 00/10] AGENTS.md and associated skills
Posted by Daniel P. Berrangé 1 week, 5 days ago
On Thu, May 07, 2026 at 11:24:37AM +0200, Philippe Mathieu-Daudé wrote:
> On 7/5/26 10:59, Peter Maydell wrote:
> > On Tue, 5 May 2026 at 18:03, Alex Bennée <alex.bennee@linaro.org> wrote:
> > > 
> > > Not withstanding the current contributor policy there are a number of
> > > areas that AI agents could be helpful for. This series introduces an
> > > AGENTS.md file which is the basic guide to the source tree and a
> > > number of "skills". Skills are like scripts except far less clearly
> > > defined. However I have found the issue triage skill quite useful for
> > > off-loading the drudgery of going through stuff by hand. I've also
> > > used the issue helper to automate the task of starting a debug session
> > > by pulling in test cases from the tracker.
> > > 
> > > These originally where a set of skills for ECA (eca.dev) but I've
> > > ported them across to the agent agnostic .agents directory. There are
> > > still some cases where the ECA heritage shows through though
> > > (specifically the code explorer skill could be better).
> > > 
> > > I'm not suggesting this is ready for up-streaming but I'm posting the
> > > collected set for comment and I'd be interested how well these hold up
> > > across different agentic systems.
> > 
> > I guess my overall comment on this is some mix of:
> >   * how much of this is generically useful as opposed to
> >     stuff that's personally helpful to you and should remain
> >     part of your local setup / preferences?
> >   * how much do we want to put into git to start with?
> 
> Parts could be shared under a 'qemu' folder within mainstream
> review-prompts project:
> 
>  https://github.com/masoncl/review-prompts

IMHO it is more likely to stay updated and relevant if it is maintained
directly in qemu.git where it is visible to our manitainers.

With regards,
Daniel
-- 
|: https://berrange.com       ~~        https://hachyderm.io/@berrange :|
|: https://libvirt.org          ~~          https://entangle-photo.org :|
|: https://pixelfed.art/berrange   ~~    https://fstop138.berrange.com :|