agent-cli

A CLI tool for managing Claude Code skills - install, list, and remove skills from GitHub repositories.

Installation

Quick Start (npx - no installation needed)

npx @festeh/agent-cli <command>

Global Installation

npm install -g @festeh/agent-cli
agent-cli <command>

Development Setup

cd agent-cli
npm install
npm link  # To use globally as 'agent-cli'

Usage

All examples below use npx @festeh/agent-cli. If you installed globally, you can use agent-cli instead.

Install Skill

Install a skill from a GitHub repository to your project's .claude/skills directory:

npx @festeh/agent-cli install-skill <user/repo> <skill-name>
# or
npx @festeh/agent-cli install-skill <github-repo-url> <skill-name>

Examples:

# Shorthand format (assumes GitHub)
npx @festeh/agent-cli install-skill obra/superpowers systematic-debugging

# Full URL format
npx @festeh/agent-cli install-skill https://github.com/obra/superpowers.git systematic-debugging

# Both output: Skill installed at .claude/skills/systematic-debugging/

What it does:

1. Clones the repository to a temporary directory (/tmp)
2. Searches for the specified skill folder using ripgrep
3. Validates the skill has proper structure (SKILL.md with YAML frontmatter)
4. Copies the skill to .claude/skills/<skill-name>/
5. Cleans up temporary files
6. Always installs the latest version from the default branch

List Skills

List all installed skills in your project:

npx @festeh/agent-cli list-skills

Example output:

Installed Skills (1):

1. systematic-debugging
   Use when encountering any bug, test failure, or unexpected behavior...
   Location: .claude/skills/systematic-debugging

Remove Skill

Remove an installed skill from your project:

npx @festeh/agent-cli remove-skill <skill-name>

Example:

npx @festeh/agent-cli remove-skill systematic-debugging

# Output:
# Removing skill: systematic-debugging
# Location: /path/to/.claude/skills/systematic-debugging
# ✓ Skill "systematic-debugging" removed successfully!

CLI Tool Structure

agent-cli/
├── package.json
├── bin/
│   └── agent-cli.js             # CLI entry point
├── src/
│   └── commands/
│       ├── install-skill.js     # Install skill command
│       ├── list-skills.js       # List skills command
│       └── remove-skill.js      # Remove skill command
└── README.md

License

ISC