Metadata-Version: 2.4
Name: add-skills
Version: 0.2.0
Summary: A tool for managing Claude Code skills
Author-email: Ludo Technologies LLC <contact@ludo-tech.org>
Maintainer-email: Ludo Technologies LLC <contact@ludo-tech.org>
License-Expression: MIT
Project-URL: Homepage, https://github.com/ludo-technologies/add-skills
Project-URL: Repository, https://github.com/ludo-technologies/add-skills
Project-URL: Issues, https://github.com/ludo-technologies/add-skills/issues
Keywords: claude,claude-code,skills,cli,automation
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=10.0.0
Requires-Dist: python-frontmatter>=1.0.0
Requires-Dist: GitPython>=3.1.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: build>=0.7.0; extra == "dev"
Requires-Dist: twine>=3.0.0; extra == "dev"
Requires-Dist: ruff>=0.8.0; extra == "dev"
Requires-Dist: pyright>=1.1.0; extra == "dev"
Dynamic: license-file

# add-skills

A Python-based CLI for managing AI agent Skills. Install Skills from local paths or GitHub/GitLab repositories.

## Installation

No installation required (recommended)
```bash
uvx add-skills ludo-technologies/python-best-practices
```

Or install globally
```bash
uv tool install add-skills
pipx install add-skills
```

## Usage

```bash
# Add Skills from GitHub (short form)
uvx add-skills ludo-technologies/python-best-practices

# Add Skills from a local directory
uvx add-skills ./my-skills

# Add Skills from full GitHub URL
uvx add-skills https://github.com/owner/repo

# List available Skills without installing
uvx add-skills ludo-technologies/python-best-practices --list

# Install globally (default: local to project)
uvx add-skills ludo-technologies/python-best-practices --global

# Install for a specific agent
uvx add-skills ludo-technologies/python-best-practices --global --agent cursor

# Skip confirmation prompt
uvx add-skills ludo-technologies/python-best-practices --yes

# Install a specific Skill by name
uvx add-skills ludo-technologies/python-best-practices --skill coding-standards
```

## Options

| Option | Short | Description |
|--------|-------|-------------|
| `--global` | `-g` | Install globally instead of locally to project |
| `--agent` | `-a` | Target agent (default: `claude-code`) |
| `--skill` | `-s` | Install specific Skill by name |
| `--list` | `-l` | List available Skills without installing |
| `--yes` | `-y` | Skip confirmation prompt |

## Supported Agents

amp, antigravity, claude-code, clawdbot, cline, codebuddy, codex, command-code, continue, crush, cursor, droid, gemini-cli, github-copilot, goose, kilo, kiro-cli, mcpjam, mux, neovate, opencode, openhands, pi, qoder, qwen-code, roo, trae, windsurf, zencoder

## Creating Skills

Create a `SKILL.md` file in your Skill directory:

```markdown
---
name: my-skill
description: A brief description of what this skill does
---

# My Skill

Instructions for the AI agent...
```

## How It Works

1. Parses the source (local path, `owner/repo`, or full URL)
2. For remote sources, performs a shallow clone
3. Discovers all `SKILL.md` files in the source
4. Copies Skill files to the target agent's Skills directory

**Installation paths (example for claude-code):**
- Local: `.claude/skills/<skill-name>`
- Global: `~/.claude/skills/<skill-name>`

## License

MIT
