Install curated AI agent skills into any repository

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for forshariq from gravatar.com forshariq

Unverified details

These details have not been verified by PyPI
Meta
Report project as malware

Project description

ag-skill

ag-skill logo

A command-line tool for installing and managing AI engineering assets in any repository: skills, templates, and agent bundles.

Python 3.11+ License: MIT

This README covers how to install and use the CLI for skills, templates, and agent bundles.

Table of Contents

What ag-skill Does

With ag-skill, you can:

  • List available skills
  • Install one or more skills into the current repository
  • Scaffold agent templates and install agent bundles (for example, core-agents)
  • Select stack-aware bundle variants (--backend, --frontend) at install time
  • 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

3. Install an agent bundle (templates + skills)

ag-skill add core-agents

Example with explicit stack selection:

ag-skill add core-agents --backend python --frontend react

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

List bundles

Show all agent template bundles (e.g. core-agents) available in the catalog.

ag-skill bundles

Help:

ag-skill bundles --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

Agent Templates

ag-skill also ships the core-agents bundle, which scaffolds a templated agent team for spec-to-ship workflows.

Install the CLI

If you do not have ag-skill yet, install it first:

uv tool install ag-skill

pipx install ag-skill

pip install ag-skill

Install the agent templates

Run these commands from the root of the repository you want to update:

ag-skill add core-agents

That uses the default stack pairing: dotnet for backend and react for frontend.

Choose a different backend stack when needed:

ag-skill add core-agents --backend python --frontend react

ag-skill add core-agents --backend java --frontend react

ag-skill add core-agents --backend go --frontend react

The bundle renders ag-architect, ag-coder, ag-ui-developer, and ag-tester templates into the target repository using the selected stack.

It also installs workflow.md into the target agent directory (for example .github/agents/workflow.md for Copilot target) so you can follow the spec-to-ship sequence in the client project.

More detail is available in docs/skills/core-agents-templates.md. For step-by-step client-project usage (agent selection, invocation order, and troubleshooting), see Core Agents Workflow Usage Guide.

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 bundles --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

List available bundles:

ag-skill bundles

Install the core-agents bundle:

ag-skill add core-agents

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 list command shows available skills; bundles shows available agent template packs.
  • The install command installs catalog skills into a repository.
  • The add command scaffolds a new custom skill or installs a bundle (e.g. ag-skill add core-agents).

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

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for forshariq from gravatar.com forshariq

Unverified details

These details have not been verified by PyPI
Meta

Release history Release notifications | RSS feed

This version

0.1.6

0.1.5

0.1.4

0.1.1

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ag_skill-0.1.6.tar.gz (123.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ag_skill-0.1.6-py3-none-any.whl (215.9 kB view details)

Uploaded Python 3

File details

Details for the file ag_skill-0.1.6.tar.gz.

File metadata

  • Download URL: ag_skill-0.1.6.tar.gz
  • Upload date:
  • Size: 123.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ag_skill-0.1.6.tar.gz
Algorithm Hash digest
SHA256 4a8ae550a851cf2f881498f7bd94f3178bf4ece4983902da871354329446bf25
MD5 a6ea0047eb36bba4ade77128af815934
BLAKE2b-256 658492adb27a6d3fd69fa44698072829ca30919fb438a9409d3885a70eb706e1

See more details on using hashes here.

File details

Details for the file ag_skill-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: ag_skill-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 215.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ag_skill-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 89c82aad526dd4959f431d4b2cbc019bf68fcbaebc448a87fb5cf258b3edf8df
MD5 58d1c746ee0ca847af2f776c94e84e88
BLAKE2b-256 476818a5c88a8eb6d2161c1877537ace609f96a96a0b9766a21d020a550783b7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page