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.