ag-skill 0.1.4

Install curated AI agent skills into any repository

ag-skill

A command-line tool for installing and managing curated AI agent skills in any repository.

---

This README covers only how to install and use the CLI.

Table of Contents

• What ag-skill Does
• Requirements
• Install
• Quick Start
• Usage
• CLI Help
• Common Examples
• Notes
• Docs
• License

What ag-skill Does

With ag-skill, you can:

• List available skills
• Install one or more skills into the current repository
• Remove installed skills
• Upgrade installed skills
• Scaffold a custom skill
• Validate installed skills

Requirements

• Python 3.11 or later
• One of uv, pipx, or pip
• A local repository you want to work in

Install

ag-skill is published on PyPI. Install it with uv (recommended), pipx, or pip:

uv tool install ag-skill

pipx install ag-skill

pip install ag-skill

Install from source (latest unreleased changes)

To install directly from the GitHub repository instead of PyPI:

uv tool install ag-skill --from git+https://github.com/snk-learn/ag-skill.git@main

Verify installation

ag-skill --help

If the command is not recognized after installation, restart the terminal and try again.

Upgrading ag-skill

If installed from PyPI:

uv tool upgrade ag-skill

pip install --upgrade ag-skill

If installed from the GitHub repository, reinstall with --force:

uv tool install ag-skill --from git+https://github.com/snk-learn/ag-skill.git@main --force

Quick Start

Open a terminal in the repository where you want to use ag-skill.

1. List available skills

ag-skill list

2. Install a skill into the current repository

ag-skill install <skill-name>

Example:

ag-skill install testing

---

Usage

Run all commands from the root of the repository you want to update.

List skills

Show all skills available in the catalog.

ag-skill list

Help:

ag-skill list --help

Install skills

Install one or more catalog skills into the current repository.

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

Force overwrite existing installed skills:

ag-skill install <skill-name> --force

Install everything at once (all skills, all targets, overwriting existing ones):

ag-skill install --all --target all --force

Help:

ag-skill install --help

Supported install targets:

• copilot
• claude
• cursor
• all
• comma-separated target values

Remove skills

Remove one or more installed skills.

ag-skill remove <skill-name>

Remove multiple skills:

ag-skill remove <skill-one> <skill-two>

Remove from a specific target:

ag-skill remove <skill-name> --target all

Help:

ag-skill remove --help

Upgrade installed skills

Upgrade installed skills to the latest catalog version.

ag-skill upgrade

Upgrade a specific target:

ag-skill upgrade --target all

Help:

ag-skill upgrade --help

Add a custom skill

Scaffold a new custom skill in the repository.

ag-skill add <skill-name>

Example:

ag-skill add my-custom-skill

Specify a target:

ag-skill add my-custom-skill --target copilot

Help:

ag-skill add --help

Validate installed skills

Validate installed skills against the supported spec.

ag-skill doctor

Help:

ag-skill doctor --help

Show version

ag-skill version

Help:

ag-skill version --help

---

CLI Help

Top-level help

ag-skill --help

Command help

ag-skill list --help
ag-skill install --help
ag-skill remove --help
ag-skill upgrade --help
ag-skill add --help
ag-skill doctor --help
ag-skill version --help

---

Common Examples

List skills:

ag-skill list

Install a skill:

ag-skill install testing

Install multiple skills:

ag-skill install testing docs ci

Install all skills:

ag-skill install --all

Install all skills for all targets, overwriting existing ones:

ag-skill install --all --target all --force

Remove a skill:

ag-skill remove testing

Upgrade installed skills:

ag-skill upgrade

Validate installed skills:

ag-skill doctor

---

Notes

• Run ag-skill inside the repository you want to update.
• Use ag-skill --help or <command> --help to see the latest supported options.
• The install command installs catalog skills into a repository.
• The add command scaffolds a new custom skill.

---

Docs

• Token Observability Skill Guide

---

License

ag-skill is open source, released under the MIT License. Any use, distribution, or derivative work must credit ag-skill and reference its repository URL: https://github.com/snk-learn/ag-skill