custom-agents

Configure GitHub Copilot custom agents with Markdown frontmatter files.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/az9713/gh-aw --skill custom-agents-az9713
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: custom-agents
Source: https://github.com/az9713/gh-aw/tree/main/skills/custom-agents
Command: npx skills add https://github.com/az9713/gh-aw --skill custom-agents-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub Custom Agent File Format enables teams to define repository-scoped AI agents using Markdown frontmatter, ensuring consistent behavior across workflows and agents.

Core Features & Use Cases

  • Pattern-based agent configuration via Markdown frontmatter
  • Supports repository-wide, path-specific, and agent-profile instructions
  • Integrates with gh-aw workflow imports under .github/agents

Quick Start

Place a properly formatted SKILL.md with a name and description in the skill's root and import it into a workflow as needed.

Frequently Asked Questions about custom-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define custom AI agents for GitHub Copilot workflows?

Custom AI agents for GitHub Copilot are defined by creating Markdown files with frontmatter in the .github/agents directory, using properties like name, description, and applyTo to guide code generation behavior.

What is Markdown frontmatter for repository-specific AI agents?

Markdown frontmatter for repository-specific AI agents is a configuration format that enables teams to define consistent agent behavior, supporting repository-wide and path-specific instructions to guide code generation workflows.

Can I configure path-specific instructions for GitHub Copilot custom agents?

Yes, you can configure path-specific instructions for GitHub Copilot custom agents using the applyTo property in the Markdown frontmatter, allowing targeted code generation guidance across different project directories.

How do I integrate MCP servers with custom agents in Markdown?

You integrate MCP servers with custom agents by adding the mcp-server property in the Markdown frontmatter, allowing your repository-specific agents to connect with external tools and services during code generation workflows.

Do I need specific dependencies to use Markdown frontmatter for custom agents?

No specific dependencies are required to use Markdown frontmatter for custom agents. You simply place a properly formatted file in the .github/agents directory and import it into your workflow as needed.