Skip to main content

Custom Skills

You can scaffold your own skill into any repository using the add command.

Scaffold a custom skill​

ag-skill add <skill-name>

# Example
ag-skill add my-custom-skill

# Specify a target
ag-skill add my-custom-skill --target copilot

This creates a skill folder in the appropriate location (e.g. .github/skills/my-custom-skill/) with a starter SKILL.md file.

Authoring the skill​

Edit the generated SKILL.md to define:

  • name — a short, unique identifier
  • description — when the skill should be invoked
  • content — the domain knowledge, instructions, or resources for the agent

Notes​

  • Custom skills live in your repository alongside catalog-installed skills.
  • They are not published to the ag-skill catalog.
  • Use ag-skill doctor to validate your custom skill structure.