{"id":34503826,"url":"https://github.com/terrylica/cc-skills","last_synced_at":"2026-06-27T06:02:19.289Z","repository":{"id":328209247,"uuid":"1110043437","full_name":"terrylica/cc-skills","owner":"terrylica","description":"Claude Code Skills Marketplace: plugins, skills for ADR-driven development, DevOps automation, ClickHouse management, semantic versioning, and productivity workflows","archived":false,"fork":false,"pushed_at":"2026-04-26T00:26:29.000Z","size":15236,"stargazers_count":36,"open_issues_count":49,"forks_count":6,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-26T01:23:17.858Z","etag":null,"topics":["ai-agents","ai-tools","anthropic","automation","claude","claude-code","clickhouse","coding-assistant","developer-tools","devops","llm","marketplace","mcp","open-source","plugins","productivity","prompt-engineering","semantic-release","skills","workflow"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/terrylica.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"docs/governance-maintenance-model.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-04T16:26:10.000Z","updated_at":"2026-04-26T00:26:31.000Z","dependencies_parsed_at":"2026-04-01T19:03:16.106Z","dependency_job_id":null,"html_url":"https://github.com/terrylica/cc-skills","commit_stats":null,"previous_names":["terrylica/cc-skills"],"tags_count":735,"template":false,"template_full_name":null,"purl":"pkg:github/terrylica/cc-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylica%2Fcc-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylica%2Fcc-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylica%2Fcc-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylica%2Fcc-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/terrylica","download_url":"https://codeload.github.com/terrylica/cc-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terrylica%2Fcc-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32480557,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"ssl_error","status_checked_at":"2026-04-30T13:12:06.837Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-tools","anthropic","automation","claude","claude-code","clickhouse","coding-assistant","developer-tools","devops","llm","marketplace","mcp","open-source","plugins","productivity","prompt-engineering","semantic-release","skills","workflow"],"created_at":"2025-12-24T02:39:09.388Z","updated_at":"2026-06-27T06:02:19.265Z","avatar_url":"https://github.com/terrylica.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cc-skills\n\nClaude Code Skills Marketplace: Meta-skills, foundational tools, and self-revising autonomous-loop primitives for Claude Code.\n\n[![Plugins](https://img.shields.io/badge/plugins-36-green.svg)](#plugins)\n[![Version](https://img.shields.io/github/package-json/v/terrylica/cc-skills.svg)](./CHANGELOG.md)\n[![License](https://img.shields.io/badge/license-MIT-yellow.svg)](./LICENSE)\n\n## Plugins\n\n\u003e Generated from `.claude-plugin/marketplace.json` (the SSoT). Run `bun scripts/validate-plugins.mjs` to verify the table reflects reality.\n\n| Plugin                                                  | Description                                                                                                                                                                                                                                                          | Category      |\n| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |\n| [agent-reach](./plugins/agent-reach/)                   | Give your AI agent eyes to see the entire internet. Search and read 15+ platforms with auto-update preflight: Twitter/X, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu, Douyin, Weibo, WeChat, Xiaoyuzhou Podcast, LinkedIn, V2EX, RSS, Exa web search.             | productivity  |\n| [asciinema-tools](./plugins/asciinema-tools/)           | Terminal recording automation: asciinema capture, launchd daemon for background chunking, Keychain PAT storage, Pushover notifications, cast conversion, and semantic analysis                                                                                       | utilities     |\n| [calcom-commander](./plugins/calcom-commander/)         | Cal.com + Telegram bot lifecycle - booking management, interactive commands, scheduled sync, Agent SDK routing, 1Password API key                                                                                                                                    | productivity  |\n| [claude-tts-companion](./plugins/claude-tts-companion/) | Real-time karaoke subtitles synced with TTS playback — unified macOS accessory app replacing telegram-bot + kokoro-tts-server + subtitle prototype                                                                                                                   | productivity  |\n| [cli-anything](./plugins/cli-anything/)                 | Reference guide for CLI-Anything: auto-generate production-ready agent-controllable CLI harnesses for any GUI app via 7-phase pipeline. Covers all validated commands, per-app examples (GIMP, Blender, LibreOffice, Inkscape), testing, and HARNESS.md methodology. | development   |\n| [crucible](./plugins/crucible/)                         | Self-evolving research methodology: 18 universal principles for LLM-driven investigation, distilled from a 376-turn session with 1 positive + 17 null campaigns.                                                                                                     | ai            |\n| [devops-tools](./plugins/devops-tools/)                 | DevOps automation: ClickHouse, Doppler, MLflow, Cloudflare Workers, pueue orchestration, notifications, session recovery, MiniMax consensus analysis                                                                                                                 | devops        |\n| [doc-tools](./plugins/doc-tools/)                       | Comprehensive documentation tooling: ASCII diagrams, markdown standards, LaTeX build, Pandoc PDF, glossary management, plotext financial charts                                                                                                                      | documentation |\n| [dotfiles-tools](./plugins/dotfiles-tools/)             | Chezmoi dotfile management via natural language workflows                                                                                                                                                                                                            | utilities     |\n| [floating-clock](./plugins/floating-clock/)             | macOS floating clock overlay with profile-based aesthetics, controlled via SwiftBar control center                                                                                                                                                                   | utilities     |\n| [gemini-deep-research](./plugins/gemini-deep-research/) | Run Gemini Deep Research via browser automation (claude-in-chrome MCP). Submit prompts, monitor progress, retrieve final reports.                                                                                                                                    | research      |\n| [gh-tools](./plugins/gh-tools/)                         | GitHub workflow automation with intelligent GFM link validation, fork intelligence, and issue creation tooling                                                                                                                                                       | development   |\n| [git-town-workflow](./plugins/git-town-workflow/)       | Prescriptive git-town workflow enforcement for fork-based development                                                                                                                                                                                                | devops        |\n| [gmail-commander](./plugins/gmail-commander/)           | Gmail bot + CLI lifecycle: 1Password OAuth, scheduled email triage via Agent SDK Haiku, interactive Telegram bot                                                                                                                                                     | productivity  |\n| [html-showcase](./plugins/html-showcase/)               | Canonical CSS kernel + HTML skeleton for static showcase pages (provenance reports, dashboards); single design-system SSoT via jsDelivr, per-page CSS overrides                                                                                                      | documents     |\n| [itp](./plugins/itp/)                                   | Implement-The-Plan workflow: ADR-driven 4-phase development with preflight, implementation, and release                                                                                                                                                              | productivity  |\n| [itp-hooks](./plugins/itp-hooks/)                       | ITP workflow enforcement + code correctness: PreToolUse / PostToolUse / Stop hooks for SSoT principles, file-size guard, type checks, ASCII art blocking, ty/oxlint/biome lint                                                                                       | enforcement   |\n| [kokoro-tts](./plugins/kokoro-tts/)                     | Kokoro TTS engine: install, server lifecycle, synthesis, health checks, and real-time audio architecture for macOS Apple Silicon                                                                                                                                     | productivity  |\n| [link-tools](./plugins/link-tools/)                     | Link validation: portability checks, broken link detection, path policy linting                                                                                                                                                                                      | quality       |\n| [macro-keyboard](./plugins/macro-keyboard/)             | Karabiner remap for cheap 3-key USB-C/Bluetooth macro pads + HID diagnostic + Fn-key emit utilities                                                                                                                                                                  | utilities     |\n| [media-tools](./plugins/media-tools/)                   | Download YouTube audio and push to BookPlayer for offline listening                                                                                                                                                                                                  | productivity  |\n| [minimax](./plugins/minimax/)                           | MiniMax M-series production wiring patterns — API client templates verified across multi-iteration campaigns                                                                                                                                                         | ai            |\n| [mise](./plugins/mise/)                                 | User-global mise workflow commands: env status, list-repo-tasks, run-full-release, SR\u0026ED commit                                                                                                                                                                      | productivity  |\n| [mql5](./plugins/mql5/)                                 | MQL5 development: indicator patterns, mql5.com article extraction, Python workspace, MT5 tick collection ops, FXView Parquet consumer                                                                                                                                | trading       |\n| [openwolf](./plugins/openwolf/)                         | Wraps the third-party openwolf npm middleware (token-saving project memory): installs the global binary, runs `openwolf init`, surfaces status, and adds a clean removal path                                                                                        | productivity  |\n| [plugin-dev](./plugins/plugin-dev/)                     | Plugin development: skill architecture, plugin validation, silent failure auditing, TodoWrite templates                                                                                                                                                              | development   |\n| [productivity-tools](./plugins/productivity-tools/)     | Slash command generation, Notion (SDK + CLI), iMessage queries, iTerm2 layouts, calendar event manager, Google Drive access                                                                                                                                          | productivity  |\n| [pushover-commander](./plugins/pushover-commander/)     | Pushover end-to-end: send (+image), priority-2 emergency with receipt polling, headless web-control for apps/sounds, incident-report PNGs, UUID/JSONL audit + quota                                                                                                  | devops        |\n| [quality-tools](./plugins/quality-tools/)               | Code quality and validation: clone detection, dead-code, multi-agent E2E + performance profiling, ClickHouse architect, refactoring guide                                                                                                                            | quality       |\n| [quant-research](./plugins/quant-research/)             | Quantitative research: SOTA range bar metrics, Sharpe ratios, ML prediction quality, WFO epochs                                                                                                                                                                      | trading       |\n| [rust-tools](./plugins/rust-tools/)                     | Rust dependency audit + SOTA Rust arsenal reference                                                                                                                                                                                                                  | development   |\n| [ssh-tunnel-companion](./plugins/ssh-tunnel-companion/) | macOS launchd companion for SSH tunnels (Tailscale + CF Access) — see plugin's CLAUDE.md for the SSoT on tunnel architecture                                                                                                                                         | devops        |\n| [statusline-tools](./plugins/statusline-tools/)         | Custom Claude Code status line with git status indicators + global ignore patterns + session-info reporter                                                                                                                                                           | utilities     |\n| [tlg](./plugins/tlg/)                                   | Telegram operations toolkit: messages, channels, dialogs, members, media, search, dump, drafting, cleanup                                                                                                                                                            | productivity  |\n| [tts-tg-sync](./plugins/tts-tg-sync/)                   | TTS + Telegram sync stack: bot process control, voice quality audition, settings tuning, full-stack bootstrap, diagnostic resolver                                                                                                                                   | productivity  |\n\n## Installation\n\n### Prerequisites\n\n| Requirement | Check              | Install                                                                                 |\n| ----------- | ------------------ | --------------------------------------------------------------------------------------- |\n| Claude Code | `claude --version` | [Getting Started Guide](https://docs.anthropic.com/en/docs/claude-code/getting-started) |\n\n### Quick Start (Recommended)\n\nRun these commands in your **terminal** (not inside Claude Code):\n\n```bash\n# 1. Add the cc-skills marketplace\nclaude plugin marketplace add terrylica/cc-skills\n\n# 2. Install all 37 plugins (one-liner, alphabetically ordered to match marketplace.json)\nfor p in agent-reach asciinema-tools calcom-commander 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\n  claude plugin install \"$p@cc-skills\"\ndone\n\n# 3. Sync hooks to settings.json (requires cloning the repo)\ngit clone https://github.com/terrylica/cc-skills.git /tmp/cc-skills\n/tmp/cc-skills/scripts/sync-hooks-to-settings.sh\n\n# 4. Restart Claude Code to activate hooks\nclaude\n```\n\n### Step-by-Step Installation\n\n#### Step 1: Add the Marketplace\n\n```bash\nclaude plugin marketplace add terrylica/cc-skills\n```\n\nThis clones the marketplace to `~/.claude/plugins/marketplaces/cc-skills/`.\n\n**Verify installation:**\n\n```bash\nclaude plugin marketplace list\n# Should show: cc-skills - Source: GitHub (terrylica/cc-skills)\n```\n\n#### Step 2: Install Individual Plugins\n\nUse the install one-liner above, or pick the plugins you need from the [Plugins table](#plugins). Examples:\n\n```bash\n# Workflow + dev essentials\nclaude plugin install itp@cc-skills\nclaude plugin install itp-hooks@cc-skills\nclaude plugin install plugin-dev@cc-skills\nclaude plugin install gh-tools@cc-skills\nclaude plugin install link-tools@cc-skills\n\n# DevOps + quality\nclaude plugin install devops-tools@cc-skills\nclaude plugin install quality-tools@cc-skills\nclaude plugin install doc-tools@cc-skills\n\n# Media / productivity (optional, install on demand)\nclaude plugin install asciinema-tools@cc-skills\nclaude plugin install productivity-tools@cc-skills\nclaude plugin install statusline-tools@cc-skills\n```\n\nThe full alphabetical list is in `.claude-plugin/marketplace.json` — `jq -r '.plugins[].name' .claude-plugin/marketplace.json` enumerates all 36.\n\n#### Step 3: Sync Hooks\n\nHooks provide pre/post tool use enforcement and session events. They must be explicitly synced to `~/.claude/settings.json`:\n\n```bash\n# Clone the repository (if not already cloned)\ngit clone https://github.com/terrylica/cc-skills.git ~/cc-skills-temp\n\n# Run the hook sync script\n~/cc-skills-temp/scripts/sync-hooks-to-settings.sh\n# Output: ✓ Hooks synced: PreToolUse=7, PostToolUse=3, Stop=5\n```\n\n#### Step 4: Restart Claude Code\n\n**Hooks require a restart** to take effect:\n\n```bash\n# Exit any running Claude Code sessions, then:\nclaude\n```\n\n### Verify Installation\n\n```bash\n# Check marketplace is registered\nclaude plugin marketplace list\n\n# Inside Claude Code, verify commands are available\n# Type \"/\" and look for itp:go, plugin-dev:create, etc.\n```\n\n## Updating the Marketplace\n\nWhen new versions are released:\n\n```bash\n# Update the marketplace repository\ncd ~/.claude/plugins/marketplaces/cc-skills\ngit pull\n\n# Reinstall updated plugins (or specific ones)\nclaude plugin install itp@cc-skills\n\n# Re-sync hooks\n./scripts/sync-hooks-to-settings.sh  # From the repo directory\n```\n\n## Troubleshooting\n\n### \"Source path does not exist\" Error\n\n**Cause**: Marketplace repository is out of sync or has stale data.\n\n**Fix**:\n\n```bash\n# Update the marketplace\ncd ~/.claude/plugins/marketplaces/cc-skills\ngit pull\n\n# Retry installation\nclaude plugin install plugin-name@cc-skills\n```\n\n### Slash Commands Not Appearing\n\n**Cause**: Plugins installed but commands not discovered.\n\n**Fix**:\n\n1. Verify plugin is installed:\n\n   ```bash\n   # Check installed_plugins.json\n   cat ~/.claude/plugins/installed_plugins.json | grep \"cc-skills\"\n   ```\n\n2. Restart Claude Code (fresh session required)\n\n3. If still not working, clear cache and reinstall:\n\n   ```bash\n   rm -rf ~/.claude/plugins/cache/cc-skills\n   claude plugin install plugin-name@cc-skills\n   ```\n\n### Hooks Not Working\n\n**Cause**: Hooks not synced to settings.json.\n\n**Fix**:\n\n```bash\n# Sync hooks\ncd /path/to/cc-skills\n./scripts/sync-hooks-to-settings.sh\n\n# Restart Claude Code\n```\n\n**Verify hooks are registered:**\n\n```bash\ncat ~/.claude/settings.json | jq '.hooks | keys'\n# Should show: [\"PreToolUse\", \"PostToolUse\", \"Stop\"]\n```\n\n### \"Plugin not found\" After Adding Marketplace\n\n**Cause**: Known Claude Code issue with SSH clone failures.\n\n**Fix**:\n\n```bash\n# Remove and re-add with explicit clone\nclaude plugin marketplace remove cc-skills\nrm -rf ~/.claude/plugins/marketplaces/cc-skills\n\n# Clone manually via HTTPS\ngit clone https://github.com/terrylica/cc-skills.git ~/.claude/plugins/marketplaces/cc-skills\n\n# Re-add to known_marketplaces.json\n# Add this entry to ~/.claude/plugins/known_marketplaces.json:\n# \"cc-skills\": {\n#   \"source\": {\"source\": \"github\", \"repo\": \"terrylica/cc-skills\"},\n#   \"installLocation\": \"$HOME/.claude/plugins/marketplaces/cc-skills\",\n#   \"lastUpdated\": \"2026-01-13T00:00:00.000Z\"\n# }\n```\n\n### Version Mismatch\n\n**Cause**: Cache has old plugin version.\n\n**Fix**:\n\n```bash\n# Check current cached version\nls ~/.claude/plugins/cache/cc-skills/itp/\n\n# Clear specific plugin cache\nrm -rf ~/.claude/plugins/cache/cc-skills/itp\n\n# Reinstall\nclaude plugin install itp@cc-skills\n```\n\n## Architecture\n\n### Directory Structure\n\n```\n~/.claude/plugins/\n├── known_marketplaces.json      # Registered marketplaces\n├── installed_plugins.json       # Installed plugins with versions\n├── marketplaces/\n│   └── cc-skills/               # Cloned marketplace repository\n│       ├── .claude-plugin/\n│       │   └── marketplace.json # Plugin registry (SSoT)\n│       └── plugins/\n│           ├── itp/\n│           ├── plugin-dev/\n│           └── ...\n└── cache/\n    └── cc-skills/               # Cached plugin copies\n        ├── itp/\n        │   └── \u003cversion\u003e/       # Version-specific cache\n        └── ...\n```\n\n### Key Files\n\n| File                                        | Purpose                                                |\n| ------------------------------------------- | ------------------------------------------------------ |\n| `~/.claude/plugins/known_marketplaces.json` | Marketplace registry with source and install locations |\n| `~/.claude/plugins/installed_plugins.json`  | Installed plugins with versions and paths              |\n| `~/.claude/settings.json`                   | User settings including hooks configuration            |\n| `.claude-plugin/marketplace.json`           | Plugin registry for this marketplace (SSoT)            |\n\n### Marketplace Configuration\n\nThe `known_marketplaces.json` entry for cc-skills:\n\n```json\n{\n  \"cc-skills\": {\n    \"source\": {\n      \"source\": \"github\",\n      \"repo\": \"terrylica/cc-skills\"\n    },\n    \"installLocation\": \"$HOME/.claude/plugins/marketplaces/cc-skills\",\n    \"lastUpdated\": \"\u003ctimestamp\u003e\"\n  }\n}\n```\n\n## For Plugin Developers\n\n### Critical Schema Requirements\n\nBased on compatibility with Claude Code's plugin loader:\n\n#### 1. Source Paths (marketplace.json)\n\n**DO NOT** use trailing slashes in `source` paths:\n\n```json\n// CORRECT\n\"source\": \"./plugins/itp\"\n\n// WRONG - causes \"Source path does not exist\" error\n\"source\": \"./plugins/itp/\"\n```\n\n#### 2. Author Field (plugin.json)\n\nThe `author` field **must** be an object, not a string:\n\n```json\n// CORRECT\n\"author\": {\n  \"name\": \"Your Name\",\n  \"url\": \"https://github.com/username\"\n}\n\n// WRONG - causes validation error\n\"author\": \"Your Name\"\n```\n\n#### 3. No Custom Fields (plugin.json)\n\nOnly standard fields are allowed. These cause validation errors:\n\n```json\n// WRONG - unrecognized keys\n\"commands_dir\": \"commands\",\n\"references_dir\": \"references\",\n\"scripts_dir\": \"scripts\"\n```\n\n### Valid plugin.json Example\n\n```json\n{\n  \"name\": \"my-plugin\",\n  \"version\": \"\u003cversion\u003e\",\n  \"description\": \"Plugin description (min 10 chars)\",\n  \"keywords\": [\"keyword1\", \"keyword2\"],\n  \"author\": {\n    \"name\": \"Your Name\",\n    \"url\": \"https://github.com/username\"\n  }\n}\n```\n\n### Valid marketplace.json Entry\n\n```json\n{\n  \"name\": \"my-plugin\",\n  \"description\": \"Plugin description\",\n  \"version\": \"\u003cversion\u003e\",\n  \"source\": \"./plugins/my-plugin\",\n  \"category\": \"development\",\n  \"author\": {\n    \"name\": \"Your Name\",\n    \"url\": \"https://github.com/username\"\n  },\n  \"keywords\": [\"keyword1\", \"keyword2\"],\n  \"strict\": false\n}\n```\n\n### Testing Your Plugin\n\n```bash\n# Validate marketplace structure\nbun scripts/validate-plugins.mjs\n\n# Check for schema errors\nbun scripts/validate-plugins.mjs --fix\n```\n\n## Terminology\n\nUnderstanding the architectural hierarchy:\n\n| Term          | Definition                                                                                    | Location             | Example                      |\n| ------------- | --------------------------------------------------------------------------------------------- | -------------------- | ---------------------------- |\n| **Plugin**    | Marketplace-installable container with metadata, commands, and optional bundled skills        | `~/.claude/plugins/` | `itp`, `gh-tools`            |\n| **Skill**     | Executable agent with SKILL.md frontmatter; can be standalone or bundled within a plugin      | `~/.claude/skills/`  | `graph-easy`, `pypi-doppler` |\n| **Command**   | Slash command (`/plugin:command`) defined in `.md` file within plugin's `commands/` directory | Plugin's `commands/` | `/itp:setup`                 |\n| **Reference** | Supporting documentation in `references/` directory; not directly executable                  | `references/`        | `error-handling.md`          |\n\n**Hierarchy**:\n\n```\nPlugin (Container)\n├── commands/           → Slash commands (/plugin:command)\n├── skills/             → Bundled skills (copied to ~/.claude/skills/ on install)\n│   └── skill-name/\n│       ├── SKILL.md    → Skill definition (frontmatter + instructions)\n│       ├── scripts/    → Executable helpers\n│       └── references/ → Supporting docs\n├── hooks/              → Hook definitions (hooks.json)\n├── scripts/            → Plugin-level utilities\n└── references/         → Plugin-level documentation\n```\n\n**Key distinctions**:\n\n- **install** → Acquire packages/tools via package manager (`brew install`, `npm install`)\n- **setup** → Verify environment post-installation (`/itp:setup` checks dependencies)\n- **init** → Create initial directory structure (one-time scaffolding)\n- **configure** → Adjust settings in config files (iterative customization)\n\n## Plugin Dependencies\n\nSome plugins use skills from other plugins. Install dependencies first for full functionality.\n\n| Plugin       | Depends On  | Skills Used                                   |\n| ------------ | ----------- | --------------------------------------------- |\n| `plugin-dev` | `itp`       | implement-plan-preflight, code-hardcode-audit |\n| `doc-tools`  | `itp`       | graph-easy, adr-graph-easy-architect          |\n| `itp`        | `doc-tools` | ascii-diagram-validator                       |\n\n**Note:** `doc-tools` and `itp` have a circular dependency (both provide diagram tools). Install both for full functionality.\n\nRun `bun scripts/validate-plugins.mjs --deps` to see the full dependency graph.\n\n## Slash Command Naming Convention\n\nMarketplace plugin commands display with the `plugin:command` format:\n\n| Display Format | Meaning                       |\n| -------------- | ----------------------------- |\n| `/itp:go`      | Plugin `itp`, command `go`    |\n| `/itp:setup`   | Plugin `itp`, command `setup` |\n\n**Why the colon format?**\n\n- **Display**: Claude Code always shows the full `plugin:command` namespace in autocomplete and command lists\n- **Invocation**: You may type `/go`, `/setup`, or `/hooks` directly if no naming conflicts exist with other installed plugins\n- **Clarity**: The namespace identifies which plugin provides each command\n\n**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.\n\n## Repository Structure\n\n```text\ncc-skills/\n├── .claude-plugin/\n│   └── marketplace.json          # Plugin registry (36 plugins) — SSoT\n├── plugins/                      # 36 marketplace plugins (each with its own CLAUDE.md)\n│   ├── itp/                      # ADR-driven 4-phase development workflow\n│   ├── itp-hooks/                # Workflow enforcement + code-correctness hooks\n│   ├── plugin-dev/               # Plugin / skill architecture meta-tools\n│   ├── gh-tools/                 # GitHub workflow + GFM link validation\n│   ├── doc-tools/                # ASCII diagrams, markdown standards, LaTeX, Pandoc\n│   ├── quality-tools/            # Clone detection, E2E validation, profiling, refactor guide\n│   ├── devops-tools/             # ClickHouse, Doppler, MLflow, pueue, session recovery\n│   ├── claude-tts-companion/     # Swift macOS karaoke-subtitles companion\n│   ├── kokoro-tts/               # Kokoro TTS engine (install / server / synthesis)\n│   ├── tts-tg-sync/              # TTS + Telegram sync stack\n│   ├── tlg/                      # Telegram operations toolkit\n│   ├── ssh-tunnel-companion/     # macOS launchd companion for SSH tunnels\n│   ├── floating-clock/           # macOS floating clock overlay\n│   ├── macro-keyboard/           # Karabiner remap for 3-key macro pads\n│   ├── …                         # 20 more — see Plugins table for the full set\n├── scripts/\n│   ├── sync-hooks-to-settings.sh    # Hook synchronization (called by release:sync)\n│   ├── sync-commands-to-settings.sh # Command synchronization\n│   ├── validate-plugins.mjs         # Plugin validation\n│   └── marketplace.schema.json      # JSON Schema for marketplace.json\n├── .mise/tasks/release/             # Release automation (6 phases — see below)\n├── docs/                            # ADRs, design docs, lessons-learned, troubleshooting\n├── package.json                     # semantic-release\n└── README.md\n```\n\n## Release Workflow (for maintainers)\n\nThis marketplace uses semantic-release with mise task automation:\n\n```bash\n# Check release status\nmise run release:status\n\n# Full release workflow (preflight → version → sync → verify)\nmise run release:full\n\n# Dry run (no changes)\nmise run release:dry\n\n# Manual hook sync only\nmise run release:hooks\n\n# Sync marketplace to ~/.claude after release\nmise run release:sync\n```\n\n### Release Phases\n\n`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.\n\n| Phase | Task                 | Description                                                                                      |\n| ----- | -------------------- | ------------------------------------------------------------------------------------------------ |\n| 1     | `release:preflight`  | Validate clean working dir, GH_TOKEN presence, plugin manifests, releasable conventional commits |\n| 1.5   | `release:presync`    | Mirror current main HEAD to ~/.claude marketplace clone so the live env reflects pending changes |\n| 2     | `release:version`    | Run semantic-release (version bump + CHANGELOG + git tag + GitHub release)                       |\n| 3     | `release:sync`       | Update marketplace repo, sync hooks/commands to settings.json, populate plugin cache             |\n| 4     | `release:verify`     | Verify git tag, GitHub release, marketplace, hooks files, runtime artifact consistency           |\n| 5     | `release:postflight` | Reset lockfile drift, confirm clean working dir, confirm all commits pushed                      |\n\nRun `mise tasks ls | grep -i release` for the complete list (also includes `release:status`, `release:dry`, `release:hooks`, `release:clean`).\n\n## Available Plugins\n\n### itp\n\n**Implement-The-Plan workflow: ADR-driven 4-phase development.**\n\nExecute approved plans from Claude Code's Plan Mode through a structured workflow:\n\n- **Preflight**: ADR + Design Spec creation with graph-easy diagrams\n- **Phase 1**: Implementation with engineering standards\n- **Phase 2**: Format \u0026 Push to GitHub\n- **Phase 3**: Release via the repo's mise release pipeline, optionally Publish (PyPI)\n\n**Commands**: `/itp:go`, `/itp:setup`, `/itp:tether` (release runs via `/mise:run-full-release`)\n\n\u003e `tether` (was `hooks`) renamed to avoid clashing with Claude Code's built-in `/hooks`. Old TRIGGERS keyword retained.\n\n**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\n\n### plugin-dev\n\n**Plugin and skill development: structure validation, silent failure auditing, skill architecture meta-skill.**\n\n- **skill-architecture** - Meta-skill for creating skills (YAML frontmatter, TodoWrite templates)\n- **plugin-validator** - Validate plugin structure, manifests, and detect silent script failures\n\n**Commands**: `/plugin-dev:create`\n\n### gh-tools\n\n**GitHub workflow automation with intelligent GFM link validation.**\n\n- Detects broken repository-relative links\n- Auto-fixes common link patterns\n- Integrates with `gh` CLI workflows\n\n### link-tools\n\n**Link validation: portability checks, broken link detection, path policy linting.**\n\n- **link-validator** - Validates relative path usage for cross-installation compatibility\n- **link-validation** - Broken link detection with path policy linting (on-demand)\n\n### devops-tools\n\n**Doppler credentials, Firecrawl self-hosted, ML pipelines, MLflow queries, notifications, and session recovery.**\n\n17 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\n\n### doc-tools\n\n**Comprehensive documentation: ASCII diagrams, markdown standards, LaTeX build, Pandoc PDF generation.**\n\nNine bundled skills: ascii-diagram-validator, documentation-standards, glossary-management, latex-build, latex-setup, latex-tables, pandoc-pdf-generation, plotext-financial-chart, terminal-print\n\n### quality-tools\n\n**Code quality and validation tools: clone detection, E2E validation, profiling, schema testing.**\n\nSix bundled skills: clickhouse-architect, code-clone-assistant, multi-agent-e2e-validation, multi-agent-performance-profiling, schema-e2e-validation, symmetric-dogfooding\n\n### itp-hooks\n\n**ITP workflow enforcement via PreToolUse and PostToolUse hooks.**\n\n- Hard block on manual ASCII art\n- Ruff Python linting reminders\n- Graph-easy skill reminders\n- ADR/Design Spec sync reminders\n\n### statusline-tools\n\n**Custom Claude Code status line with git status indicators.**\n\n- Git status indicators (modified, deleted, staged, untracked)\n- Remote tracking (ahead/behind commits)\n\n**Commands**: `/statusline-tools:setup`\n\n### Other Plugins\n\nFor everything not detailed above, see the [Plugins table](#plugins) and the per-plugin `CLAUDE.md` (the SSoT for purpose, stack, and conventions). The full list is enumerable via:\n\n```bash\njq -r '.plugins[] | \"\\(.name) — \\(.description)\"' .claude-plugin/marketplace.json\n```\n\n## Known Issues\n\n### Claude Code Plugin Ecosystem Issues\n\n| Issue                                                            | Description                                                     | Workaround                          |\n| ---------------------------------------------------------------- | --------------------------------------------------------------- | ----------------------------------- |\n| [#14929](https://github.com/anthropics/claude-code/issues/14929) | Commands from directory-based local marketplaces not discovered | Use GitHub-based marketplace source |\n| SSH clone failures                                               | Silent failure when adding marketplace via SSH                  | Use HTTPS clone manually            |\n\n### This Marketplace\n\n| Issue                                | Status | Notes                               |\n| ------------------------------------ | ------ | ----------------------------------- |\n| Circular dependency: doc-tools ↔ itp | Known  | Install both for full functionality |\n\n## Contributing\n\n1. Fork the repository\n2. Create a plugin in `plugins/your-plugin/`\n3. Add entry to `.claude-plugin/marketplace.json`\n4. Ensure `plugin.json` follows the schema (see [For Plugin Developers](#for-plugin-developers))\n5. Run `bun scripts/validate-plugins.mjs`\n6. Submit a pull request\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterrylica%2Fcc-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fterrylica%2Fcc-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterrylica%2Fcc-skills/lists"}