custom-agents

Configure custom Copilot agents with YAML frontmatter under .github/agents.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/kaushal-waygood/agentic-self-healing-ci --skill custom-agents-kaushal-waygood
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: custom-agents
Source: https://github.com/kaushal-waygood/agentic-self-healing-ci/tree/main/skills/custom-agents
Command: npx skills add https://github.com/kaushal-waygood/agentic-self-healing-ci --skill custom-agents-kaushal-waygood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams need repository-tailored AI agent profiles to guide Copilot behavior, enabling consistent automation across workflows.

Core Features & Use Cases

  • YAML-frontmatter based agent metadata to configure agent behavior
  • Organization of agents under .github/agents with workflow imports
  • Supports repository-wide, path-specific, and profile-based guidance for automation tasks

Quick Start

Import a custom agent file from .github/agents and reference it in a workflow to customize Copilot behavior.

Frequently Asked Questions about custom-agents

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

FAQPage Schema
How do I create custom Copilot agents for my GitHub repository?▼

To create custom Copilot agents, define agent metadata in YAML frontmatter and organize the agent files under the .github/agents directory in your repository. This enables repository-specific automation guidance for workflows.

Can I apply path-specific Copilot agent configurations in GitHub workflows?▼

Yes, you can apply path-specific Copilot agent configurations. Custom agent files support repository-wide, path-specific, and agent profile scopes to provide tailored automation guidance for different project areas.

How do GitHub workflow imports work with custom Copilot agent profiles?▼

GitHub workflow imports integrate custom Copilot agents by referencing agent files stored under .github/agents. You import an agent file into your workflow to apply tailored guidance for code reviews or documentation tasks.

What is YAML frontmatter used for when defining Copilot agents?▼

YAML frontmatter is used to declare agent metadata that configures Copilot behavior. By placing this metadata at the top of your agent files, you establish consistent, repository-tailored automation profiles across your workflows.

Does this approach support repository-wide automation guidance for Copilot?▼

Yes, this approach supports repository-wide automation guidance. You can configure custom agent profiles to provide consistent Copilot behavior across the entire repository or restrict guidance to specific paths.