cc-skills

Claude Code Skills Marketplace: Meta-skills, foundational tools, and self-revising autonomous-loop primitives for Claude Code.

Plugins

Generated from .claude-plugin/marketplace.json (the SSoT). Run bun scripts/validate-plugins.mjs to verify the table reflects reality.

Installation

Prerequisites

Quick Start (Recommended)

Run these commands in your terminal (not inside Claude Code):

# 1. Add the cc-skills marketplace
claude plugin marketplace add terrylica/cc-skills

# 2. Install all 37 plugins (one-liner, alphabetically ordered to match marketplace.json)
for p in agent-reach asciinema-tools autoloop calcom-commander chronicle-share claude-tts-companion cli-anything crucible devops-tools doc-tools dotfiles-tools floating-clock gemini-deep-research gh-tools git-town-workflow gmail-commander html-showcase itp itp-hooks kokoro-tts link-tools macro-keyboard media-tools minimax mise mql5 openwolf plugin-dev productivity-tools pushover-commander quality-tools quant-research rust-tools ssh-tunnel-companion statusline-tools tlg tts-tg-sync; do
  claude plugin install "$p@cc-skills"
done

# 3. Sync hooks to settings.json (requires cloning the repo)
git clone https://github.com/terrylica/cc-skills.git /tmp/cc-skills
/tmp/cc-skills/scripts/sync-hooks-to-settings.sh

# 4. Restart Claude Code to activate hooks
claude

Step-by-Step Installation

Step 1: Add the Marketplace

claude plugin marketplace add terrylica/cc-skills

This clones the marketplace to ~/.claude/plugins/marketplaces/cc-skills/.

Verify installation:

claude plugin marketplace list
# Should show: cc-skills - Source: GitHub (terrylica/cc-skills)

Step 2: Install Individual Plugins

Use the install one-liner above, or pick the plugins you need from the Plugins table. Examples:

# Workflow + dev essentials
claude plugin install itp@cc-skills
claude plugin install itp-hooks@cc-skills
claude plugin install plugin-dev@cc-skills
claude plugin install gh-tools@cc-skills
claude plugin install link-tools@cc-skills

# Autonomous loop primitives
claude plugin install autoloop@cc-skills

# DevOps + quality
claude plugin install devops-tools@cc-skills
claude plugin install quality-tools@cc-skills
claude plugin install doc-tools@cc-skills

# Media / productivity (optional, install on demand)
claude plugin install asciinema-tools@cc-skills
claude plugin install productivity-tools@cc-skills
claude plugin install statusline-tools@cc-skills

The full alphabetical list is in .claude-plugin/marketplace.json — jq -r '.plugins[].name' .claude-plugin/marketplace.json enumerates all 36.

Step 3: Sync Hooks

Hooks provide pre/post tool use enforcement and session events. They must be explicitly synced to ~/.claude/settings.json:

# Clone the repository (if not already cloned)
git clone https://github.com/terrylica/cc-skills.git ~/cc-skills-temp

# Run the hook sync script
~/cc-skills-temp/scripts/sync-hooks-to-settings.sh
# Output: ✓ Hooks synced: PreToolUse=7, PostToolUse=3, Stop=5

Step 4: Restart Claude Code

Hooks require a restart to take effect:

# Exit any running Claude Code sessions, then:
claude

Verify Installation

# Check marketplace is registered
claude plugin marketplace list

# Inside Claude Code, verify commands are available
# Type "/" and look for itp:go, plugin-dev:create, etc.

Updating the Marketplace

When new versions are released:

# Update the marketplace repository
cd ~/.claude/plugins/marketplaces/cc-skills
git pull

# Reinstall updated plugins (or specific ones)
claude plugin install itp@cc-skills

# Re-sync hooks
./scripts/sync-hooks-to-settings.sh  # From the repo directory

Troubleshooting

"Source path does not exist" Error

Cause: Marketplace repository is out of sync or has stale data.

Fix:

# Update the marketplace
cd ~/.claude/plugins/marketplaces/cc-skills
git pull

# Retry installation
claude plugin install plugin-name@cc-skills

Slash Commands Not Appearing

Cause: Plugins installed but commands not discovered.

Fix:

1. Verify plugin is installed:

   # Check installed_plugins.json
   cat ~/.claude/plugins/installed_plugins.json | grep "cc-skills"
   

2. Restart Claude Code (fresh session required)

3. If still not working, clear cache and reinstall:

   rm -rf ~/.claude/plugins/cache/cc-skills
   claude plugin install plugin-name@cc-skills
   

Hooks Not Working

Cause: Hooks not synced to settings.json.

Fix:

# Sync hooks
cd /path/to/cc-skills
./scripts/sync-hooks-to-settings.sh

# Restart Claude Code

Verify hooks are registered:

cat ~/.claude/settings.json | jq '.hooks | keys'
# Should show: ["PreToolUse", "PostToolUse", "Stop"]

"Plugin not found" After Adding Marketplace

Cause: Known Claude Code issue with SSH clone failures.

Fix:

# Remove and re-add with explicit clone
claude plugin marketplace remove cc-skills
rm -rf ~/.claude/plugins/marketplaces/cc-skills

# Clone manually via HTTPS
git clone https://github.com/terrylica/cc-skills.git ~/.claude/plugins/marketplaces/cc-skills

# Re-add to known_marketplaces.json
# Add this entry to ~/.claude/plugins/known_marketplaces.json:
# "cc-skills": {
#   "source": {"source": "github", "repo": "terrylica/cc-skills"},
#   "installLocation": "$HOME/.claude/plugins/marketplaces/cc-skills",
#   "lastUpdated": "2026-01-13T00:00:00.000Z"
# }

Version Mismatch

Cause: Cache has old plugin version.

Fix:

# Check current cached version
ls ~/.claude/plugins/cache/cc-skills/itp/

# Clear specific plugin cache
rm -rf ~/.claude/plugins/cache/cc-skills/itp

# Reinstall
claude plugin install itp@cc-skills

Architecture

Directory Structure

~/.claude/plugins/
├── known_marketplaces.json      # Registered marketplaces
├── installed_plugins.json       # Installed plugins with versions
├── marketplaces/
│   └── cc-skills/               # Cloned marketplace repository
│       ├── .claude-plugin/
│       │   └── marketplace.json # Plugin registry (SSoT)
│       └── plugins/
│           ├── itp/
│           ├── plugin-dev/
│           └── ...
└── cache/
    └── cc-skills/               # Cached plugin copies
        ├── itp/
        │   └── <version>/       # Version-specific cache
        └── ...

Key Files

Marketplace Configuration

The known_marketplaces.json entry for cc-skills:

{
  "cc-skills": {
    "source": {
      "source": "github",
      "repo": "terrylica/cc-skills"
    },
    "installLocation": "$HOME/.claude/plugins/marketplaces/cc-skills",
    "lastUpdated": "<timestamp>"
  }
}

For Plugin Developers

Critical Schema Requirements

Based on compatibility with Claude Code's plugin loader:

1. Source Paths (marketplace.json)

DO NOT use trailing slashes in source paths:

// CORRECT
"source": "./plugins/itp"

// WRONG - causes "Source path does not exist" error
"source": "./plugins/itp/"

2. Author Field (plugin.json)

The author field must be an object, not a string:

// CORRECT
"author": {
  "name": "Your Name",
  "url": "https://github.com/username"
}

// WRONG - causes validation error
"author": "Your Name"

3. No Custom Fields (plugin.json)

Only standard fields are allowed. These cause validation errors:

// WRONG - unrecognized keys
"commands_dir": "commands",
"references_dir": "references",
"scripts_dir": "scripts"

Valid plugin.json Example

{
  "name": "my-plugin",
  "version": "<version>",
  "description": "Plugin description (min 10 chars)",
  "keywords": ["keyword1", "keyword2"],
  "author": {
    "name": "Your Name",
    "url": "https://github.com/username"
  }
}

Valid marketplace.json Entry

{
  "name": "my-plugin",
  "description": "Plugin description",
  "version": "<version>",
  "source": "./plugins/my-plugin",
  "category": "development",
  "author": {
    "name": "Your Name",
    "url": "https://github.com/username"
  },
  "keywords": ["keyword1", "keyword2"],
  "strict": false
}

Testing Your Plugin

# Validate marketplace structure
bun scripts/validate-plugins.mjs

# Check for schema errors
bun scripts/validate-plugins.mjs --fix

Terminology

Understanding the architectural hierarchy:

Hierarchy:

Plugin (Container)
├── commands/           → Slash commands (/plugin:command)
├── skills/             → Bundled skills (copied to ~/.claude/skills/ on install)
│   └── skill-name/
│       ├── SKILL.md    → Skill definition (frontmatter + instructions)
│       ├── scripts/    → Executable helpers
│       └── references/ → Supporting docs
├── hooks/              → Hook definitions (hooks.json)
├── scripts/            → Plugin-level utilities
└── references/         → Plugin-level documentation

Key distinctions:

• install → Acquire packages/tools via package manager (brew install, npm install)
• setup → Verify environment post-installation (/itp:setup checks dependencies)
• init → Create initial directory structure (one-time scaffolding)
• configure → Adjust settings in config files (iterative customization)

Plugin Dependencies

Some plugins use skills from other plugins. Install dependencies first for full functionality.

Note: doc-tools and itp have a circular dependency (both provide diagram tools). Install both for full functionality.

Run bun scripts/validate-plugins.mjs --deps to see the full dependency graph.

Slash Command Naming Convention

Marketplace plugin commands display with the plugin:command format:

Why the colon format?

• Display: Claude Code always shows the full plugin:command namespace in autocomplete and command lists
• Invocation: You may type /go, /setup, or /hooks directly if no naming conflicts exist with other installed plugins
• Clarity: The namespace identifies which plugin provides each command

Important edge case: When the command name equals the plugin name (e.g., /foo:foo), you must use the full format. Typing /foo alone is interpreted as the plugin prefix, not the command.

Repository Structure

cc-skills/
├── .claude-plugin/
│   └── marketplace.json          # Plugin registry (36 plugins) — SSoT
├── plugins/                      # 36 marketplace plugins (each with its own CLAUDE.md)
│   ├── autoloop/                 # Self-revising LOOP_CONTRACT pattern (.autoloop/<slug>--<hash>/ layout)
│   ├── itp/                      # ADR-driven 4-phase development workflow
│   ├── itp-hooks/                # Workflow enforcement + code-correctness hooks
│   ├── plugin-dev/               # Plugin / skill architecture meta-tools
│   ├── gh-tools/                 # GitHub workflow + GFM link validation
│   ├── doc-tools/                # ASCII diagrams, markdown standards, LaTeX, Pandoc
│   ├── quality-tools/            # Clone detection, E2E validation, profiling, refactor guide
│   ├── devops-tools/             # ClickHouse, Doppler, MLflow, pueue, session recovery
│   ├── claude-tts-companion/     # Swift macOS karaoke-subtitles companion
│   ├── kokoro-tts/               # Kokoro TTS engine (install / server / synthesis)
│   ├── tts-tg-sync/              # TTS + Telegram sync stack
│   ├── tlg/                      # Telegram operations toolkit
│   ├── ssh-tunnel-companion/     # macOS launchd companion for SSH tunnels
│   ├── floating-clock/           # macOS floating clock overlay
│   ├── macro-keyboard/           # Karabiner remap for 3-key macro pads
│   ├── …                         # 20 more — see Plugins table for the full set
├── scripts/
│   ├── sync-hooks-to-settings.sh    # Hook synchronization (called by release:sync)
│   ├── sync-commands-to-settings.sh # Command synchronization
│   ├── validate-plugins.mjs         # Plugin validation
│   └── marketplace.schema.json      # JSON Schema for marketplace.json
├── .mise/tasks/release/             # Release automation (6 phases — see below)
├── docs/                            # ADRs, design docs, lessons-learned, troubleshooting
├── .autoloop/                       # autoloop campaign storage (gitignored)
│   └── <campaign-slug>--<short-hash>/
│       ├── CONTRACT.md              # Live LOOP_CONTRACT
│       ├── PROVENANCE.md            # Owner+history index
│       └── state/                   # heartbeat.json + revision-log
├── package.json                     # semantic-release
└── README.md

Release Workflow (for maintainers)

This marketplace uses semantic-release with mise task automation:

# Check release status
mise run release:status

# Full release workflow (preflight → version → sync → verify)
mise run release:full

# Dry run (no changes)
mise run release:dry

# Manual hook sync only
mise run release:hooks

# Sync marketplace to ~/.claude after release
mise run release:sync

Release Phases

mise run release:full runs all six phases in sequence — matches the canonical task description in .mise/tasks/release/full. Each phase is independently invokable.

Run mise tasks ls | grep -i release for the complete list (also includes release:status, release:dry, release:hooks, release:clean).

Available Plugins

itp

Implement-The-Plan workflow: ADR-driven 4-phase development.

Execute approved plans from Claude Code's Plan Mode through a structured workflow:

• Preflight: ADR + Design Spec creation with graph-easy diagrams
• Phase 1: Implementation with engineering standards
• Phase 2: Format & Push to GitHub
• Phase 3: Release via the repo's mise release pipeline, optionally Publish (PyPI)

Commands: /itp:go, /itp:setup, /itp:tether (release runs via /mise:run-full-release)

tether (was hooks) renamed to avoid clashing with Claude Code's built-in /hooks. Old TRIGGERS keyword retained.

Bundled Skills: adr-code-traceability, adr-graph-easy-architect, bootstrap-monorepo, code-hardcode-audit, graph-easy, impl-standards, implement-plan-preflight, mise-configuration, mise-tasks, pypi-doppler

plugin-dev

Plugin and skill development: structure validation, silent failure auditing, skill architecture meta-skill.

• skill-architecture - Meta-skill for creating skills (YAML frontmatter, TodoWrite templates)
• plugin-validator - Validate plugin structure, manifests, and detect silent script failures

Commands: /plugin-dev:create

autoloop

Self-revising LOOP_CONTRACT.md pattern for long-horizon autonomous work. Replaces the previously-shipped ru plugin (removed 2026-04 per ADR) and renames the post-Ralph "autonomous-loop" plugin to a shorter slug.

Features:

• Per-campaign storage layout: contracts live at <cwd>/.autoloop/<slug>--<short-hash>/CONTRACT.md with sibling state/ dir and PROVENANCE.md ledger
• Multi-campaign coexistence in one cwd via slug+hash directory naming (no collisions when multiple Claude sessions run in the same branch+folder)
• Auto-migration on first /autoloop:start for any directory containing a legacy LOOP_CONTRACT.md
• schema_version 2 frontmatter with self-describing provenance: loop_id, campaign_slug, created_in_session, created_at_cwd, created_at_git_branch, created_at_git_commit, mirrored owner state, expected-cadence hint
• 5-step identification decision tree in every contract so any AI agent (offline or live) can answer "is this mine, reclaimable, or hands-off?" without consulting the registry
• Atomic ownership: registry at ~/.claude/loops/registry.json is the SSoT; flock-serialized writes; PID-reuse defense via owner_start_time_us; generation counter for TOCTOU defense
• Stall-guard hook in itp-hooks (stop-loop-stall-guard.ts) detects firings that ended without a valid waker and forces a rewake

Commands: /autoloop:start, /autoloop:muster, /autoloop:stop, /autoloop:setup, /autoloop:reclaim, /autoloop:triage

muster (was status) and triage (was doctor) renamed in v18/v19 to avoid clashing with Claude Code's built-in /status and /doctor. Old TRIGGER keywords kept in skill descriptions for soft backward-compat.

Plugin doc: plugins/autoloop/CLAUDE.md — architecture, 6 catastrophic pitfalls, troubleshooting playbook.

gh-tools

GitHub workflow automation with intelligent GFM link validation.

• Detects broken repository-relative links
• Auto-fixes common link patterns
• Integrates with gh CLI workflows

link-tools

Link validation: portability checks, broken link detection, path policy linting.

• link-validator - Validates relative path usage for cross-installation compatibility
• link-validation - Broken link detection with path policy linting (on-demand)

devops-tools

Doppler credentials, Firecrawl self-hosted, ML pipelines, MLflow queries, notifications, and session recovery.

17 bundled skills: clickhouse-cloud-management, clickhouse-pydantic-config, claude-code-proxy-patterns, disk-hygiene, distributed-job-safety, doppler-workflows, doppler-secret-validation, dual-channel-watchexec, firecrawl-research-patterns, ml-data-pipeline-architecture, ml-failfast-validation, mlflow-python, project-directory-migration, pueue-job-orchestration, python-logging-best-practices, session-chronicle, session-recovery

doc-tools

Comprehensive documentation: ASCII diagrams, markdown standards, LaTeX build, Pandoc PDF generation.

Nine bundled skills: ascii-diagram-validator, documentation-standards, glossary-management, latex-build, latex-setup, latex-tables, pandoc-pdf-generation, plotext-financial-chart, terminal-print

quality-tools

Code quality and validation tools: clone detection, E2E validation, profiling, schema testing.

Six bundled skills: clickhouse-architect, code-clone-assistant, multi-agent-e2e-validation, multi-agent-performance-profiling, schema-e2e-validation, symmetric-dogfooding

itp-hooks

ITP workflow enforcement via PreToolUse and PostToolUse hooks.

• Hard block on manual ASCII art
• Ruff Python linting reminders
• Graph-easy skill reminders
• ADR/Design Spec sync reminders

statusline-tools

Custom Claude Code status line with git status indicators.

• Git status indicators (modified, deleted, staged, untracked)
• Remote tracking (ahead/behind commits)

Commands: /statusline-tools:setup

Other Plugins

For everything not detailed above, see the Plugins table and the per-plugin CLAUDE.md (the SSoT for purpose, stack, and conventions). The full list is enumerable via:

jq -r '.plugins[] | "\(.name) — \(.description)"' .claude-plugin/marketplace.json

Known Issues

Claude Code Plugin Ecosystem Issues

This Marketplace

Contributing

1. Fork the repository
2. Create a plugin in plugins/your-plugin/
3. Add entry to .claude-plugin/marketplace.json
4. Ensure plugin.json follows the schema (see For Plugin Developers)
5. Run bun scripts/validate-plugins.mjs
6. Submit a pull request

License

MIT