ai-builder

ai-builder

Composable building blocks for Claude Code

CLI for installing skills, agents, and commands from the aibuilder.sh registry

Overview

ai-builder is a package manager for Claude Code artifacts. Install community-built skills, agents, and commands directly into your .claude/ directory with a single command.

Features

• Install artifacts - Add skills, agents, and commands from the registry
• Search the registry - Find artifacts by name, description, or task category
• Manage installed artifacts - List and remove artifacts from your project
• Self-update - Keep the CLI up to date with a single command
• Shell completions - Tab completion for bash and zsh

Installation

npm install -g ai-builder

Or use directly with npx:

npx ai-builder add agent git-town/code_reviewer

QuickStart

# Install an agent
npx ai-builder add agent git-town/code_reviewer

# Install a command
npx ai-builder add command truffle-ai/quality-checks

# Install a skill
npx ai-builder add skill anthropic/pdf

# Search for artifacts
npx ai-builder search "test"

# List installed artifacts
npx ai-builder list

Usage

Add

Install an artifact from the registry:

npx ai-builder add <type> <author/slug>

Types: skill, agent, command

Examples:

# Install an agent
npx ai-builder add agent git-town/code_reviewer

# Install a command
npx ai-builder add command truffle-ai/quality-checks

# Install a skill
npx ai-builder add skill anthropic/mcp-builder

# Force reinstall (overwrite existing)
npx ai-builder add agent git-town/code_reviewer --force

Remove

Remove an installed artifact:

npx ai-builder remove <type> <author/slug>
npx ai-builder rm <type> <author/slug>  # alias

Examples:

# Remove an agent
npx ai-builder remove agent git-town/code_reviewer

# Skip confirmation
npx ai-builder rm agent git-town/code_reviewer --yes

List

List all installed artifacts:

npx ai-builder list
npx ai-builder ls  # alias

Options:

# Filter by type
npx ai-builder list --type agent
npx ai-builder list --type skill
npx ai-builder list --type command

Search

Search the registry for artifacts:

npx ai-builder search <query>

Options:

# Filter by type
npx ai-builder search "review" --type agent

# Filter by task category
npx ai-builder search "nextjs" --task frontend

# Limit results
npx ai-builder search "database" --limit 5

Status

Show CLI status and installed artifacts:

npx ai-builder status

Output includes:

• CLI version
• Claude directory detection
• Installed artifact counts by type
• Registry connectivity check

Update

Update the CLI to the latest version:

npx ai-builder update

Options:

# Check for updates without installing
npx ai-builder update --check

Completion

Generate shell completions for bash or zsh:

# Output completion script
npx ai-builder completion bash
npx ai-builder completion zsh

# Auto-install for current shell
npx ai-builder completion --setup

Manual installation:

# Bash
ai-builder completion bash >> ~/.bashrc

# Zsh
ai-builder completion zsh >> ~/.zshrc

Artifact Types

Type	Description	Install Location
skill	Background capabilities that enhance Claude's abilities	.claude/skills/{name}/
agent	Specialized agents invoked with @agent-name	.claude/agents/{name}.md
command	Slash commands invoked with /command-name	.claude/commands/{name}.md

Using Installed Artifacts

Agents

Invoke agents by mentioning them with @:

@reviewer review my latest changes

Commands

Run commands with /:

/deps

Skills

Skills are automatically available to Claude Code - no invocation needed.

Browse

Find artifacts at aibuilder.sh

• Browse by task category (testing, code review, documentation, etc.)
• View artifact details and source code
• See install counts and community activity

Links

• Registry
• npm package
• GitHub

License

MIT