From 9cd2ce16e7148f5e4cd4baef18a7e44c3740efaa Mon Sep 17 00:00:00 2001 From: Trivenzaa-Admin Date: Tue, 19 May 2026 01:35:58 -0700 Subject: [PATCH] =?UTF-8?q?docs(copilot):=20fix=20agent=20file=20naming=20?= =?UTF-8?q?=E2=80=94=20use=20*.agent.md=20extension?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit GitHub Copilot requires custom agent files to be named *.agent.md. The previous instructions copied them as *.md, which Copilot silently ignores, so agents would never be available in Copilot Chat. Changes: - Rename all three cp commands to use the .agent.md suffix - Add mkdir -p .github/agents (was missing, cp would have failed) - Add a callout block explaining the naming requirement with a link to the VS Code custom agents docs - Update section heading from "(agents.md)" to "(*.agent.md)" Fixes #179 Co-Authored-By: Claude Sonnet 4.6 --- docs/copilot-setup.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/copilot-setup.md b/docs/copilot-setup.md index 660ae025..01052280 100644 --- a/docs/copilot-setup.md +++ b/docs/copilot-setup.md @@ -16,15 +16,20 @@ cat /path/to/agent-skills/skills/code-review-and-quality/SKILL.md > .github/skil For more details, refer [Creating agent skills for GitHub Copilot](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/create-skills). -### Agent Personas (agents.md) +### Agent Personas (*.agent.md) Copilot supports specialized agent personas. Use the agent-skills agents: +> **Important:** GitHub Copilot requires custom agent files to be named `*.agent.md`. +> Files named `*.md` are silently ignored by Copilot. +> See [VS Code custom agents docs](https://code.visualstudio.com/docs/copilot/customization/custom-agents#_custom-agent-file-structure) for details. + ```bash -# Copy agent definitions -cp /path/to/agent-skills/agents/code-reviewer.md .github/agents/code-reviewer.md -cp /path/to/agent-skills/agents/test-engineer.md .github/agents/test-engineer.md -cp /path/to/agent-skills/agents/security-auditor.md .github/agents/security-auditor.md +# Create the agents directory and copy agent definitions +mkdir -p .github/agents +cp /path/to/agent-skills/agents/code-reviewer.md .github/agents/code-reviewer.agent.md +cp /path/to/agent-skills/agents/test-engineer.md .github/agents/test-engineer.agent.md +cp /path/to/agent-skills/agents/security-auditor.md .github/agents/security-auditor.agent.md ``` Invoke agents in Copilot Chat: