custom-agents
This document describes the GitHub custom agent file format used by GitHub Copilot to provide repository-specific or task-specific instructions to AI coding agents.
npx skills add majiayu000/claude-skill-registry --skill custom-agents-github-gh-aw --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
--- name: custom-agents description: GitHub Custom Agent File Format Brief description of agent's purpose > # Multi-line description of agent's purpose Repository-wide coding standards Frontend development guidelines Agent specializing in creating and improving README files Specialized agent for writing comprehensive test suites Agent specialized in performing code reviews --- # GitHub Custom Agent File Format This document describes the GitHub custom agent file format used by GitHub Copilot to provide repository-specific or task-specific instructions to AI coding agents. ## Overview GitHub Copilot supports custom agent instructions through Markdown files with YAML frontmatter. These files allow you to define specialized agent behaviors, tool access, and custom workflows that tailor Copilot's behavior to your repository's needs. ## File Locations Custom agent files can be placed in several locations, each serving a different scope: ### 1. Repository-wide Instructions - **File**: `.github/copilot-instructions.md` - **Scope**: Applies to all code generation in the repository - **Use case**: General coding standards, security requirements, testing practices ### 2. Path-specific Instru
- Overview
- File Locations
- 1. Repository-wide Instructions
- 2. Path-specific Instructions
- 3. Custom Agent Profiles
- 4. agentic workflow integration
- File Format
- Basic Structure
- Complete YAML Frontmatter Schema
- Field Descriptions
- Core Fields
- Tool Configuration
- Path Targeting
- Enterprise Features
What does the custom-agents skill do?
This document describes the GitHub custom agent file format used by GitHub Copilot to provide repository-specific or task-specific instructions to AI coding agents.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill custom-agents-github-gh-aw --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.