Claude Tools

A repository for managing and distributing Claude Code extensions: skills, agents, and commands.

Installing Claude Code

Install Claude Code using the native installer (no Node.js required):

macOS / Linux:

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell):

irm https://claude.ai/install.ps1 | iex

Then authenticate by running:

claude

For more details, see the official setup guide.

Prerequisites

For the best experience, install the recommended Claude Code plugins. See PLUGIN_SETUP.md for setup instructions.

Installation

Use the built-in /install and /uninstall commands to manage tools from this repository:

/install        # Interactive installation wizard
/install list   # Show available tools

/uninstall      # Interactive uninstall wizard
/uninstall list # Show installed tools

The wizard will prompt you to choose:

• Target: Global (~/.claude/) or project (.claude/)
• Mode: Copy files or create symlinks
• Tools: Which tools to install

Creating Tools

Each tool is a top-level directory containing one or more component types:

my_tool/
├── skills/                 # Skill definitions
│   ├── SKILL.md           # Required - defines the skill
│   ├── scripts/           # Optional - executable code
│   ├── references/        # Optional - documentation
│   └── assets/            # Optional - templates, images
├── agents/                # Optional - agent definitions
│   └── my-agent.md
└── commands/              # Optional - legacy commands
    └── my-command.md

Skills

Skills are the primary extension mechanism. A skill requires skills/SKILL.md with YAML frontmatter:

---
name: my-skill
description: What this skill does
allowed-tools: Read, Bash(python {SKILL_DIR}/scripts/*.py)
---

# My Skill

Instructions for Claude when using this skill...

Agents

Agents are markdown files defining specialized personas for the Task tool. Place them in agents/ as individual .md files.

Commands (Legacy)

Commands are simple markdown files without frontmatter. Skills are recommended for new development.

Path Placeholders

Use these placeholders in SKILL.md for portable paths:

Placeholder	Resolves To
{SKILL_DIR}	Directory containing SKILL.md
{AGENTS_DIR}	The agents directory

Installation Modes

Mode	Pros	Cons
Copy	Portable, independent	Won't auto-update
Symlink	Auto-updates with repo	Requires repo access

Contributing

1. Create a new top-level directory for your tool
2. Add components following the structure above
3. Run /install list to verify discovery
4. Test installation with both copy and symlink modes