🧠 AgentSkills

A CLI for browsing, searching, and installing skills from anthropics/skills.

Skills are folders of instructions and resources that teach Claude how to complete specific tasks. This CLI makes it easy to discover and use them.

Installation

pip install agentskills

Or install from source:

git clone https://github.com/akshayaggarwal99/agentskills.git
cd agentskills
pip install -e .

Quick Start

# Browse all available skills
skill browse

# Search for specific skills
skill search mcp
skill search "frontend design"

# View skill details
skill get mcp-builder

# Install a skill to your project
skill use mcp-builder

# Create ZIP for Claude.ai upload
skill zip mcp-builder

# Remove an installed skill
skill remove mcp-builder

Commands

Usage with Claude

Claude Code

Skills installed to .skills/ are automatically available. Just mention the skill:

"Use the mcp-builder skill to create a GitHub API server"

Claude.ai

1. Install and zip the skill:

   skill use frontend-design
   skill zip frontend-design
   

2. Go to claude.ai/settings/capabilities
3. Upload the ZIP file

Claude API

Reference the SKILL.md file directly in your prompts or use the Skills API.

How It Works

This CLI fetches skills from the official anthropics/skills repository and caches them locally at ~/.agentskills/cache/.

Skills follow the Agent Skills Spec:

• Each skill is a folder with a SKILL.md file
• YAML frontmatter defines name and description
• Markdown body contains instructions for Claude

Available Skills

Architecture

agentskills/
├── models.py      # Skill dataclass
├── providers.py   # SkillProvider abstraction (Anthropic, Local)
├── registry.py    # Multi-provider registry with search/pagination
└── cli.py         # Typer CLI commands

Extensible design: Add new skill sources by implementing SkillProvider:

from agentskills.providers import SkillProvider, LocalSkillProvider
from agentskills.registry import SkillRegistry

registry = SkillRegistry()
registry.add_provider(AnthropicSkillProvider())
registry.add_provider(LocalSkillProvider(Path("./my-skills")))

License

MIT License - see LICENSE for details.

Credits

• Skills sourced from anthropics/skills (Apache 2.0)
• Built with Typer and Rich

Contributing

Contributions welcome! Please open an issue or PR.