agent-skills

A CLI to create and manage agent skills for AI coding assistants (Claude and Cursor). Define reusable skills once, then sync them across .claude/skills and .cursor/skills so your AI IDE can discover and use them.

NB: As of now only Claude & Cursor. Support for others coming soon.

Features

• Create skills with an interactive prompt (description, target agents)
• List all skills for Claude and Cursor from the current directory
• Edit a skill in your editor and apply changes to all agent copies
• Delete a skill from all supported agents
• Supports Claude (.claude) and Cursor (.cursor) config directories
• Optional custom base path for skill creation

Requirements

• Python 3.8+
• Click (installed automatically)

Installation

From the project root:

pip install -e .

Or install dependencies only:

pip install -r requirements.txt

Then run via python cli.py (see Usage).

Usage

Entry point (after pip install -e .):

agent-skills <command> [options]

Or without installing:

python cli.py <command> [options]

Commands

Command	Description
create <skill-name>	Create a new skill (interactive: description, target agents)
list	List all skills for Claude and Cursor
edit <skill-name>	Edit a skill in your $EDITOR; changes apply to all agents
delete <skill-name>	Delete a skill from all supported agents

Create a skill

Use lowercase names with hyphens (e.g. my-skill-name).

agent-skills create my-skill-name
# or with a custom base path (default is current directory)
agent-skills create my-skill-name --path /path/to/project

You’ll be prompted for:

1. A short description of the skill
2. Which agents to add it to (comma-separated: claude, cursor; default: all detected)

The CLI creates:

• .claude/skills/<skill-name>/SKILL.md
• .cursor/skills/<skill-name>/SKILL.md

(in the base path you chose).

Skill file format

Each skill is a single SKILL.md with optional front matter:

---
name: my-skill-name
description: Describe what this skill does and when to use it.
---
# My Skill Name
## Instructions
Add your skill instructions here.

This is based on this Specification

Project structure

agent-skills/
├── cli.py              # Click CLI entry (create, list, edit, delete)
├── pyproject.toml      # Package config and agent-skills entry point
├── requirements.txt
├── README.md
├── CONTRIBUTING.md     # Contributor guide
└── src/
    ├── commands.py     # create, edit, delete, list implementations
    ├── constants.py   # SUPPORTED_AGENTS, config dirs
    ├── middleware.py  # validation, skill existence checks
    └── utils.py       # template builder, agent detection, find_skill, logger

Contributing

Contributions are welcome. Please read CONTRIBUTING.md for:

• Development setup and running the CLI
• Project layout and where to change code
• How to submit changes (PRs, style, scope)

License

See LICENSE.

Links

• Repository