Metadata-Version: 2.4
Name: agent-skills-installer
Version: 0.2.1
Summary: Copy agent skills from git repos into local directories for coding agents
Project-URL: Homepage, https://github.com/pearmaster/agent-skills-installer
Project-URL: Repository, https://github.com/pearmaster/agent-skills-installer
Project-URL: Issues, https://github.com/pearmaster/agent-skills-installer/issues
Author-email: Jacob Brunson <github@jacobbrunson.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agent-skills,agents,ai,cli,coding-agents
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: python-frontmatter>=1.1
Requires-Dist: questionary>=2.0
Requires-Dist: tomli-w>=1.0
Requires-Dist: typer>=0.9
Description-Content-Type: text/markdown

# agent-skills-installer

A CLI tool to copy [Agent Skills](https://agentskills.io/) from git repos into local directories for coding agents.

## Install

```bash
uv tool install agent-skills-installer
```

Or run directly without installing:

```bash
uvx agent-skills-installer
```

> **Note:** `uv` must be installed. See https://docs.astral.sh/uv/getting-started/installation/ for installation instructions.

## Usage

### Install skills (default command)

```bash
# Interactive — prompts for destination, repo, and skill selection
agent-skills-installer

# Fully non-interactive
agent-skills-installer install \
  --destination ~/.claude/skills/ \
  --source https://github.com/anthropics/skills \
  --skill skill-creator
```

**Options:**

| Flag | Short | Description |
|------|-------|-------------|
| `--destination` | `-d` | Destination directory (skip prompt) |
| `--source` | `-s` | Source git repo URL (skip prompt) |
| `--skill` | `-k` | Skill name to install (skip selection & confirmation) |

### Update skills

```bash
# Interactive — prompts for destination, confirms before updating
agent-skills-installer update

# Non-interactive
agent-skills-installer update -d ~/.claude/skills/ -k skill-creator
```

**Options:**

| Flag | Short | Description |
|------|-------|-------------|
| `--destination` | `-d` | Directory to scan for installed skills (skip prompt) |
| `--skill` | `-k` | Skill name to update (skip confirmation) |

## How it works

1. Skills are discovered in the `skills/` subdirectory of the source repo
2. Each skill directory (containing a `SKILL.md`) is copied to the destination
3. A `metadata.git-repo` entry is added to the SKILL.md frontmatter to track the source repo
4. The `update` command uses that metadata to refresh skills from their original repos

Configuration (last destination, recent repos) is saved to `~/.agent-skills-installer/config.toml`.

## License

MIT
