Install curated AI agent skills into any repository
Project description
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
uvinstalled- A local repository you want to work in
Install
Install ag-skill directly from the GitHub repository using uv:
uv tool install ag-skill --from git+https://github.com/snk-learn/ag-skill.git@v0.1.0
Verify installation
ag-skill --help
If the command is not recognized after installation, restart the terminal and try again.
Upgrading ag-skill
To upgrade to a newer release tag, reinstall with the new tag and --force:
uv tool install ag-skill --from git+https://github.com/snk-learn/ag-skill.git@<new-tag> --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:
copilotclaudecursorall- 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 --helpor<command> --helpto see the latest supported options. - The
installcommand installs catalog skills into a repository. - The
addcommand scaffolds a new custom skill.
Docs
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ag_skill-0.1.1.tar.gz.
File metadata
- Download URL: ag_skill-0.1.1.tar.gz
- Upload date:
- Size: 23.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0c4392eb71cc4f3b67f596eb0eeb6ee4a1bebd4801c7dd31710e190aeffc0a36
|
|
| MD5 |
930856512d0a8fde8002379b8fcf59f1
|
|
| BLAKE2b-256 |
749c4c4c97294b02698e229abf543d8eae2e40c3ba69806295a7ee22652d986d
|
File details
Details for the file ag_skill-0.1.1-py3-none-any.whl.
File metadata
- Download URL: ag_skill-0.1.1-py3-none-any.whl
- Upload date:
- Size: 43.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fe45c95bd1d6f21f1aed75fa673b83a453222e4d9585db9e43b87816da2e6d81
|
|
| MD5 |
f8e8711b0d0b8196865e2344c54e7c68
|
|
| BLAKE2b-256 |
f27a421290f56ef666b9a1a66a0d357174e4707bc8b7a55d9a22f8de38d5ccac
|
