Skip to content

cathy-kim/ccbuilder

Repository files navigation

ccbuilder

Build Claude Code extensions in seconds, not hours.

Skills, Hooks, Agents, Agent Teams, Ralph Loops, MCP, Memory — one plugin, all covered.

Version Claude Code License Docs Extensions


Why ccbuilder?

Building Claude Code extensions today means:

  • Scattered docs across 20+ pages — no single source of truth
  • Copy-pasting boilerplate and guessing at correct file structures
  • No validation until you actually try running it
  • Zero reference to what the community has already built

ccbuilder gives you one command to scaffold any Claude Code extension — backed by 28 reference docs (17 guides + 6 official + 5 ecosystem), and the entire ecosystem knowledge base from 11 curated community repos.

Quick Start

Install

claude plugin install github:cathy-kim/ccbuilder

Use

Invoke via slash command:

/ccbuilder skill my-skill              # Scaffold a new skill
/ccbuilder hook PreToolUse             # Scaffold a new hook
/ccbuilder agent my-agent              # Scaffold a new agent
/ccbuilder team my-team                # Set up an agent team
/ccbuilder ralph my-project            # Set up a Ralph Loop (autonomous dev loop)
/ccbuilder question "How do hooks work?"

Or just ask naturally — ccbuilder activates automatically when you mention skills, hooks, agents, agent teams, ralph loops, MCP, or memory system topics.

Features

One-Command Scaffolding — Generate complete, validated extension structures with a single slash command. YAML frontmatter, directory layout, reference templates — all handled.

28 Built-in Reference Docs — Every Claude Code extension type documented with examples, patterns, and best practices. No more tab-switching between docs.

7 Extension Types Supported — Skills, Hooks, Agents, Agent Teams, Ralph Loops, Memory, and Rules. All supported out of the box with type-specific scaffolding.

Ecosystem Knowledge Base — Curated analysis of 11 top community repos (339+ skills, 126+ subagents, 112 agents) with cross-referenced patterns.

Auto-Detection — Mention skills, hooks, or agents in conversation and ccbuilder activates automatically. No slash command needed.

Official Docs Built-in — Summaries of all 6 Claude Code official documentation pages, so Claude has the latest API surface without you copy-pasting docs.

Supported Extension Types

Type Purpose Location
Skill Knowledge injection + slash commands .claude/skills/
Subagent Independent agent definitions .claude/agents/
Agent Team Multi-agent team collaboration ~/.claude/teams/
Hook Workflow control (16 lifecycle events) settings.json
Memory Cross-session knowledge persistence ~/.claude/projects/*/memory/
Rules Path-scoped modular rules .claude/rules/
Ralph Loop Autonomous development loop (fresh context) TASK.md + loop.sh

Documentation

Reference Guides (17 files)
Guide Description
skills-guide.md Skills development guide
hooks-guide.md Hooks implementation guide (16 events)
subagents-guide.md Subagents + Plugin guide
agent-teams-guide.md Agent Teams collaboration guide
ralph-loop-guide.md Ralph Loop (autonomous dev loop) guide
mcp-guide.md MCP setup and usage guide
memory-rules-guide.md Memory & Rules system guide
implementation-guide.md Step-by-step implementation
review-system.md Skill review/validation system
best-practices.md Best practices collection
skill-subagent-task-guide.md Skill/Subagent/Task comparison
troubleshooting.md Troubleshooting guide
orchestrator-principles.md Orchestrator core principles
orchestrator-skill-creation-guide.md Orchestrator creation guide
external-resources.md Community resources & links
version-sync.md Version sync checklist
what-goes-where-guide.md What-goes-where decision guide
Official Documentation Summaries (6 files)

Built-in summaries of Claude Code official docs — so Claude always has the latest API surface:

Doc Description
official/skills.md Skills official docs
official/hooks.md Hooks official docs (16 events)
official/subagents.md Sub-agents official docs
official/mcp.md MCP official docs
official/memory-rules.md Memory & Rules official docs
official/tools.md Built-in Tools reference (28+ tools)
GitHub Ecosystem References (5 docs + 11 submodules)

Curated, tier-ranked analysis of the Claude Code ecosystem:

Doc Description
github/README.md Tier-based repo index
github/official-repos.md Anthropic official repos (T1)
github/ecosystem-collections.md Ecosystem collections 10k+ stars (T2)
github/specialized-tools.md Specialized tools & use cases (T3/T4)
github/patterns.md Cross-repo verified patterns

Included Submodules (11 repos)

For code-level reference, 11 community repos are bundled as git submodules:

Repo Highlights
anthropics/skills Official skill implementations (DOCX, PDF, etc.)
obra/superpowers TDD, debugging, subagent workflows
everything-claude-code 15 agents, 30+ skills, hooks
wshobson/agents 112 agents, 16 orchestrators
awesome-claude-code Ecosystem directory
awesome-subagents 126+ sub-agents
awesome-claude-skills Skills comparison & tutorials
awesome-agent-skills 339+ multi-agent compatible skills
hooks-mastery 13 hook events implementation
claude-code-showcase GitHub Actions, JIRA workflows
claude-code-system-prompts System prompts, tool specs
# Clone with submodules
git clone --recurse-submodules https://github.com/cathy-kim/ccbuilder.git

# Or add submodules to an existing clone
git submodule update --init --depth 1
Scripts
Script Description
scripts/init-skill.sh Initialize a new skill scaffold
scripts/init-agent.sh Initialize a new agent scaffold
scripts/init-hook.sh Initialize a new hook scaffold
scripts/init-ralph.sh Initialize a Ralph Loop (simple/hook/full)
scripts/test-hook.sh Test hook execution
scripts/check-updates.sh Check for Claude Code official doc updates
Evaluations

The evaluations/ directory contains a skill evaluation framework:

  • evaluation-framework.md — Evaluation methodology
  • test-cases.json — 5 test scenarios (P0/P1 prioritized)
  • run_evaluation.py — Automated evaluation runner
  • golden-outputs/ — Expected output references

Contributing

Contributions welcome! Here's how you can help:

  • Add reference guides — Found a useful Claude Code pattern? Submit a PR to skills/ccbuilder/references/
  • Improve scaffolding — Better templates, more extension types
  • Report issues — Bug reports and feature requests via GitHub Issues

Version

Current: v2.40.0 (2026-05-30) — Claude Code v2.1.63+ compatible. See CHANGELOG.md for full history.

License

MIT

About

claude-code-extension-builder

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors