Skip to content

Fix agent file naming: use .agent.md suffix#127976

Open
lewing wants to merge 1 commit intodotnet:mainfrom
lewing:fix-agent-md-naming
Open

Fix agent file naming: use .agent.md suffix#127976
lewing wants to merge 1 commit intodotnet:mainfrom
lewing:fix-agent-md-naming

Conversation

@lewing
Copy link
Copy Markdown
Member

@lewing lewing commented May 8, 2026

Two of the three custom agent files under .github/agents/ were missing the .agent.md suffix and were therefore silently not loaded by the Copilot CLI / VS Code / Claude Code:

Before After
.github/agents/extensions-reviewer.md .github/agents/extensions-reviewer.agent.md
.github/agents/system-net-review.md .github/agents/system-net-review.agent.md

Per the Copilot CLI plugin reference, agents are discovered as .agent.md files inside the agents directory. Without that suffix, the file is not registered as an agent.

The third agent file, agentic-workflows.agent.md, was already named correctly and is unchanged.

Why this matters

This fixes broken @-mentions in two skills that delegate to these agents:

  • .github/skills/extensions-review/SKILL.md says "For full code review, delegates to the @extensions-reviewer agent"
  • .github/skills/system-net-review/SKILL.md says "For full code review, delegates to the @system-net-review agent"

With the agents not being loaded, those @-mentions had nothing to resolve to. After this rename both delegations will work as documented.

What's in this PR

Pure file renames preserved via git mv (similarity 100%). No content changes. No other files reference these agents by filename — only by @-mention via the agent's name field, which is unaffected.

.github/agents/{extensions-reviewer.md => extensions-reviewer.agent.md} | 0
.github/agents/{system-net-review.md => system-net-review.agent.md}     | 0
2 files changed, 0 insertions(+), 0 deletions(-)

Per the GitHub Copilot CLI plugin reference, agent files in the
agents/ directory must end in .agent.md to be discovered.
See https://docs.github.com/en/copilot/reference/cli-plugin-reference

Two of the three agents under .github/agents/ were missing the suffix
and were therefore silently not loaded:

- extensions-reviewer.md  -> extensions-reviewer.agent.md
- system-net-review.md    -> system-net-review.agent.md

This also fixes broken @-mentions in two skills that delegate to
these agents:

- .github/skills/extensions-review/SKILL.md mentions @extensions-reviewer
- .github/skills/system-net-review/SKILL.md mentions @system-net-review

Both @-mentions previously had no agent to resolve to. The third
agent file (agentic-workflows.agent.md) was already named correctly
and is unchanged.

No content changes; pure file renames preserved via git mv.
Copilot AI review requested due to automatic review settings May 8, 2026 22:49
@dotnet-policy-service
Copy link
Copy Markdown
Contributor

Tagging subscribers to this area: @dotnet/area-meta
See info in area-owners.md if you want to be subscribed.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants