github-copilot-custom-agents
Use for creating, reviewing, or debugging GitHub Copilot custom agents in Visual Studio Code, including .agent.md roles, tool restrictions, model selection, subagent permissions, and handoffs. Do not
SKILL.mdskills/github-copilot-custom-agents/SKILL.md
GitHubGitHub Copilot custom agents
Create a role only when its instructions and capability boundary recur. Tool restriction reduces capability but does not make model output a security boundary.
Workflow
- Define the role, non-goals, user/model invocation, allowed mutations, evidence, and exit condition.
- Inspect current tool, model, subagent, and host identifiers.
- Store workspace agents in
.github/agents/<name>.agent.md; default to workspace scope andtarget: vscodewhen host specificity matters. - Grant least privilege. Planning/audit roles receive read-only tools; editing or terminal tools require a stated job.
- Set
user-invocableanddisable-model-invocationindependently. Restrictagentsand include the agent tool only when delegation is required. - Make handoffs reviewable with
send: falseby default. Verify every target.
Rules
- Do not freeze a model name unless verified availability is part of the contract.
- Avoid duplicating repository instructions in the body; link to them.
- Keep agent frontmatter host-compatible. IDE-only
handoffsandargument-hintcan be ignored by other hosts. - Never grant mutation just because a built-in agent normally has it.
Read agent fields, use role patterns, and run verification.
Completion
The agent is discoverable in the intended host, hidden/invocable as designed, cannot access excluded tools, every handoff resolves without auto-submission unless approved, and artifact-based tests prove its positive and negative role boundaries.