Skip to main content

Skills Overview

A skill is a self-contained folder containing instructions and resources that teach an AI agent how to handle a specific domain — architecture decisions, testing patterns, API standards, and more.

How the catalog works​

The ag-skill catalog is a curated collection of skills maintained in the ag-skill repository. When you run ag-skill list, the CLI fetches the latest catalog and displays all available skills.

Installing a skill​

# Install a single skill
ag-skill install <skill-name>

# Install multiple skills
ag-skill install <skill-one> <skill-two>

# Install all available skills
ag-skill install --all

# Install for a specific target
ag-skill install <skill-name> --target copilot

Supported install targets​

TargetDescription
copilotGitHub Copilot (default)
claudeClaude
cursorCursor
allAll targets at once

You can also pass comma-separated values: --target copilot,claude.

Where skills are installed​

Skills are written into the appropriate agent directory in your repository (e.g., .github/skills/ for Copilot), so they are automatically available to your AI agent in context.

Upgrading skills​

ag-skill upgrade

Removing skills​

ag-skill remove <skill-name>

Recent catalog updates (v1.1.0)​

Recent package updates expanded both coverage and quality of bundled skills:

  • Added new DDD core-agent skills: ddd-application-services, ddd-cqrs, ddd-domain-services, ddd-repositories, and ddd-sagas.
  • Expanded aggregate-design references for Go, Java, and Python with deeper implementation patterns and invariants.
  • Enhanced standards skills with richer assets.
  • csharp-dotnet-standards: added .editorconfig, Directory.Build.props, and template apply script.
  • python-coding-standards: added async patterns, PEP 8 cheatsheet, and baseline ruff.toml.
  • react-frontend: added component template plus accessibility and RSC-vs-client references.

To pull these updates into an existing repository:

ag-skill upgrade