From b1a21dc05baa7feeafc981e39d4292e23418bd74 Mon Sep 17 00:00:00 2001 From: daymade Date: Thu, 11 Dec 2025 20:53:31 +0800 Subject: [PATCH] feat: Add skills-search skill for CCPM registry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add skills-search v1.0.0: Search, discover, install, and manage Claude Code skills from CCPM registry - Track docs-cleaner skill that was already in marketplace.json - Update marketplace version from 1.15.0 to 1.16.0 - Update skill count from 22 to 23 across all documentation - Add skills-search section to README.md and README.zh-CN.md - Add CCPM CLI to requirements section - Add use case section for skill discovery & management 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- .claude-plugin/marketplace.json | 14 +- CHANGELOG.md | 26 +++ CLAUDE.md | 9 +- README.md | 63 ++++++- README.zh-CN.md | 63 ++++++- docs-cleaner/.security-scan-passed | 4 + docs-cleaner/SKILL.md | 84 +++++++++ .../references/value_analysis_template.md | 50 +++++ skills-search/.security-scan-passed | 4 + skills-search/SKILL.md | 176 ++++++++++++++++++ 10 files changed, 482 insertions(+), 11 deletions(-) create mode 100644 docs-cleaner/.security-scan-passed create mode 100644 docs-cleaner/SKILL.md create mode 100644 docs-cleaner/references/value_analysis_template.md create mode 100644 skills-search/.security-scan-passed create mode 100644 skills-search/SKILL.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 0fd7afa..65a94f1 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -5,8 +5,8 @@ "email": "daymadev89@gmail.com" }, "metadata": { - "description": "Professional Claude Code skills for GitHub operations, document conversion, diagram generation, statusline customization, Teams communication, repomix utilities, skill creation, CLI demo generation, LLM icon access, Cloudflare troubleshooting, UI design system extraction, professional presentation creation, YouTube video downloading, secure repomix packaging, ASR transcription correction, video comparison quality analysis, comprehensive QA testing infrastructure, prompt optimization with EARS methodology, session history recovery, documentation cleanup, PDF generation with Chinese font support, and CLAUDE.md progressive disclosure optimization", - "version": "1.15.0", + "description": "Professional Claude Code skills for GitHub operations, document conversion, diagram generation, statusline customization, Teams communication, repomix utilities, skill creation, CLI demo generation, LLM icon access, Cloudflare troubleshooting, UI design system extraction, professional presentation creation, YouTube video downloading, secure repomix packaging, ASR transcription correction, video comparison quality analysis, comprehensive QA testing infrastructure, prompt optimization with EARS methodology, session history recovery, documentation cleanup, PDF generation with Chinese font support, CLAUDE.md progressive disclosure optimization, and CCPM skill registry search and management", + "version": "1.16.0", "homepage": "https://github.com/daymade/claude-code-skills" }, "plugins": [ @@ -229,6 +229,16 @@ "category": "productivity", "keywords": ["claude-md", "progressive-disclosure", "optimization", "context-efficiency", "configuration", "token-savings"], "skills": ["./claude-md-progressive-disclosurer"] + }, + { + "name": "skills-search", + "description": "Search, discover, install, and manage Claude Code skills from the CCPM registry. Use when users want to find skills for specific tasks, install skills by name, list installed skills, get skill details, or manage their Claude Code skill collection. Triggers include find skills, search for plugins, install skill, list installed skills, or any CCPM registry operations", + "source": "./", + "strict": false, + "version": "1.0.0", + "category": "developer-tools", + "keywords": ["ccpm", "skills", "search", "install", "registry", "plugin", "marketplace", "discovery", "skill-management"], + "skills": ["./skills-search"] } ] } diff --git a/CHANGELOG.md b/CHANGELOG.md index aea0706..337b0aa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -25,6 +25,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Security - None +## [1.16.0] - 2025-12-11 + +### Added +- **New Skill**: skills-search - CCPM registry search and management + - Search for Claude Code skills in the CCPM registry + - Install skills by name with `ccpm install ` + - List installed skills with `ccpm list` + - Get detailed skill information with `ccpm info ` + - Uninstall skills with `ccpm uninstall ` + - Install skill bundles (web-dev, content-creation, developer-tools) + - Supports multiple installation formats (registry, GitHub owner/repo, full URLs) + - Troubleshooting guidance for common issues + +### Changed +- Updated marketplace skills count from 22 to 23 +- Updated marketplace version from 1.15.0 to 1.16.0 +- Updated README.md badges (skills count: 23, version: 1.16.0) +- Updated README.md to include skills-search in skills listing (skill #20) +- Updated README.zh-CN.md badges (skills count: 23, version: 1.16.0) +- Updated README.zh-CN.md to include skills-search with Chinese translation +- Updated CLAUDE.md skills count from 22 to 23 +- Added skills-search use case section to README.md +- Added skills-search use case section to README.zh-CN.md +- Added installation command for skills-search +- Enhanced marketplace metadata description to include CCPM skill management + ## [1.13.0] - 2025-12-09 ### Added diff --git a/CLAUDE.md b/CLAUDE.md index c51276e..71f9273 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## Repository Overview -This is a Claude Code skills marketplace containing 20 production-ready skills organized in a plugin marketplace structure. Each skill is a self-contained package that extends Claude's capabilities with specialized knowledge, workflows, and bundled resources. +This is a Claude Code skills marketplace containing 23 production-ready skills organized in a plugin marketplace structure. Each skill is a self-contained package that extends Claude's capabilities with specialized knowledge, workflows, and bundled resources. **Essential Skill**: `skill-creator` is the most important skill in this marketplace - it's a meta-skill that enables users to create their own skills. Always recommend it first for users interested in extending Claude Code. @@ -118,7 +118,7 @@ Skills for public distribution must NOT contain: ## Marketplace Configuration The marketplace is configured in `.claude-plugin/marketplace.json`: -- Contains 20 plugins, each mapping to one skill +- Contains 23 plugins, each mapping to one skill - Each plugin has: name, description, version, category, keywords, skills array - Marketplace metadata: name, owner, version, homepage @@ -128,7 +128,7 @@ The marketplace is configured in `.claude-plugin/marketplace.json`: 1. **Marketplace Version** (`.claude-plugin/marketplace.json` → `metadata.version`) - Tracks the marketplace catalog as a whole - - Current: v1.13.0 + - Current: v1.16.0 - Bump when: Adding/removing skills, major marketplace restructuring - Semantic versioning: MAJOR.MINOR.PATCH @@ -164,6 +164,9 @@ The marketplace is configured in `.claude-plugin/marketplace.json`: 18. **prompt-optimizer** - Transform vague prompts into precise EARS specifications with domain theory grounding 19. **claude-code-history-files-finder** - Find and recover content from Claude Code session history files 20. **docs-cleaner** - Consolidate redundant documentation while preserving valuable content +21. **pdf-creator** - Create PDF documents from markdown with Chinese font support using weasyprint +22. **claude-md-progressive-disclosurer** - Optimize CLAUDE.md files using progressive disclosure principles +23. **skills-search** - Search, discover, install, and manage Claude Code skills from the CCPM registry **Recommendation**: Always suggest `skill-creator` first for users interested in creating skills or extending Claude Code. diff --git a/README.md b/README.md index 8d115b3..f643a28 100644 --- a/README.md +++ b/README.md @@ -6,15 +6,15 @@ [![简体中文](https://img.shields.io/badge/语言-简体中文-red)](./README.zh-CN.md) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) -[![Skills](https://img.shields.io/badge/skills-20-blue.svg)](https://github.com/daymade/claude-code-skills) -[![Version](https://img.shields.io/badge/version-1.13.0-green.svg)](https://github.com/daymade/claude-code-skills) +[![Skills](https://img.shields.io/badge/skills-23-blue.svg)](https://github.com/daymade/claude-code-skills) +[![Version](https://img.shields.io/badge/version-1.16.0-green.svg)](https://github.com/daymade/claude-code-skills) [![Claude Code](https://img.shields.io/badge/Claude%20Code-2.0.13+-purple.svg)](https://claude.com/code) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md) [![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/daymade/claude-code-skills/graphs/commit-activity) -Professional Claude Code skills marketplace featuring 20 production-ready skills for enhanced development workflows. +Professional Claude Code skills marketplace featuring 23 production-ready skills for enhanced development workflows. ## 📑 Table of Contents @@ -154,6 +154,9 @@ claude plugin install claude-code-history-files-finder@daymade/claude-code-skill # Documentation consolidation claude plugin install docs-cleaner@daymade/claude-code-skills + +# CCPM skill registry search and management +claude plugin install skills-search@daymade/claude-code-skills ``` Each skill can be installed independently - choose only what you need! @@ -765,6 +768,55 @@ Consolidate redundant documentation while preserving all valuable content. --- +### 20. **skills-search** - CCPM Skill Registry Search + +Search, discover, install, and manage Claude Code skills from the CCPM (Claude Code Plugin Manager) registry. + +**When to use:** +- Finding skills for specific tasks (e.g., "find PDF skills") +- Installing skills by name +- Listing currently installed skills +- Getting detailed information about a skill +- Managing your Claude Code skill collection + +**Key features:** +- **Registry search**: Search CCPM registry with `ccpm search ` +- **Skill installation**: Install skills with `ccpm install ` +- **Version support**: Install specific versions with `@version` syntax +- **Bundle installation**: Install pre-configured skill bundles (web-dev, content-creation, developer-tools) +- **Multiple formats**: Supports registry names, GitHub owner/repo, and full URLs +- **Skill info**: Get detailed skill information with `ccpm info ` + +**Example usage:** +```bash +# Search for skills +ccpm search pdf # Find PDF-related skills +ccpm search "code review" # Find code review skills + +# Install skills +ccpm install skill-creator # From registry +ccpm install daymade/skill-creator # From GitHub +ccpm install skill-creator@1.0.0 # Specific version + +# List and manage +ccpm list # List installed skills +ccpm info skill-creator # Get skill details +ccpm uninstall pdf-processor # Remove a skill + +# Install bundles +ccpm install-bundle web-dev # Install web development skills bundle +``` + +**🎬 Live Demo** + +*Coming soon* + +📚 **Documentation**: See [skills-search/SKILL.md](./skills-search/SKILL.md) for complete command reference + +**Requirements**: CCPM CLI (`npm install -g @daymade/ccpm`) + +--- + ## 🎬 Interactive Demo Gallery Want to see all demos in one place with click-to-enlarge functionality? Check out our [interactive demo gallery](./demos/index.html) or browse the [demos directory](./demos/). @@ -810,6 +862,9 @@ Use **claude-code-history-files-finder** to recover deleted files from previous ### For Documentation Maintenance Use **docs-cleaner** to consolidate redundant documentation while preserving valuable content. Perfect for cleaning up documentation sprawl after rapid development phases or merging overlapping docs into authoritative sources. +### For Skill Discovery & Management +Use **skills-search** to find, install, and manage Claude Code skills from the CCPM registry. Perfect for discovering new skills for specific tasks, installing skill bundles for common workflows, and keeping your skill collection organized. + ## 📚 Documentation Each skill includes: @@ -838,6 +893,7 @@ Each skill includes: - **prompt-optimizer**: See `prompt-optimizer/references/ears_syntax.md` for EARS transformation patterns, `prompt-optimizer/references/domain_theories.md` for theory catalog, and `prompt-optimizer/references/examples.md` for complete transformations - **claude-code-history-files-finder**: See `claude-code-history-files-finder/references/session_file_format.md` for JSONL structure and `claude-code-history-files-finder/references/workflow_examples.md` for recovery workflows - **docs-cleaner**: See `docs-cleaner/SKILL.md` for consolidation workflows +- **skills-search**: See `skills-search/SKILL.md` for CCPM CLI commands and registry operations ## 🛠️ Requirements @@ -854,6 +910,7 @@ Each skill includes: - **pandas & matplotlib** (optional, for ppt-creator chart generation) - **Marp CLI** (optional, for ppt-creator Marp PPTX export): `npm install -g @marp-team/marp-cli` - **repomix** (for repomix-safe-mixer): `npm install -g repomix` +- **CCPM CLI** (for skills-search): `npm install -g @daymade/ccpm` ## ❓ FAQ diff --git a/README.zh-CN.md b/README.zh-CN.md index e03d987..fffd4b3 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -6,15 +6,15 @@ [![简体中文](https://img.shields.io/badge/语言-简体中文-red)](./README.zh-CN.md) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) -[![Skills](https://img.shields.io/badge/skills-20-blue.svg)](https://github.com/daymade/claude-code-skills) -[![Version](https://img.shields.io/badge/version-1.13.0-green.svg)](https://github.com/daymade/claude-code-skills) +[![Skills](https://img.shields.io/badge/skills-23-blue.svg)](https://github.com/daymade/claude-code-skills) +[![Version](https://img.shields.io/badge/version-1.16.0-green.svg)](https://github.com/daymade/claude-code-skills) [![Claude Code](https://img.shields.io/badge/Claude%20Code-2.0.13+-purple.svg)](https://claude.com/code) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md) [![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/daymade/claude-code-skills/graphs/commit-activity) -专业的 Claude Code 技能市场，提供 20 个生产就绪的技能，用于增强开发工作流。 +专业的 Claude Code 技能市场，提供 23 个生产就绪的技能，用于增强开发工作流。 ## 📑 目录 @@ -154,6 +154,9 @@ claude plugin install claude-code-history-files-finder@daymade/claude-code-skill # 文档整合 claude plugin install docs-cleaner@daymade/claude-code-skills + +# CCPM 技能注册表搜索和管理 +claude plugin install skills-search@daymade/claude-code-skills ``` 每个技能都可以独立安装 - 只选择你需要的！ @@ -805,6 +808,55 @@ python3 scripts/analyze_sessions.py stats /path/to/session.jsonl --show-files --- +### 20. **skills-search** - CCPM 技能注册表搜索 + +从 CCPM（Claude Code 插件管理器）注册表中搜索、发现、安装和管理 Claude Code 技能。 + +**使用场景：** +- 为特定任务查找技能（例如"查找 PDF 技能"） +- 按名称安装技能 +- 列出当前已安装的技能 +- 获取技能的详细信息 +- 管理你的 Claude Code 技能集合 + +**主要功能：** +- **注册表搜索**：使用 `ccpm search ` 搜索 CCPM 注册表 +- **技能安装**：使用 `ccpm install ` 安装技能 +- **版本支持**：使用 `@version` 语法安装特定版本 +- **批量安装**：安装预配置的技能包（web-dev、content-creation、developer-tools） +- **多种格式**：支持注册表名称、GitHub owner/repo 和完整 URL +- **技能信息**：使用 `ccpm info ` 获取详细的技能信息 + +**示例用法：** +```bash +# 搜索技能 +ccpm search pdf # 查找 PDF 相关技能 +ccpm search "code review" # 查找代码审查技能 + +# 安装技能 +ccpm install skill-creator # 从注册表安装 +ccpm install daymade/skill-creator # 从 GitHub 安装 +ccpm install skill-creator@1.0.0 # 安装特定版本 + +# 列出和管理 +ccpm list # 列出已安装的技能 +ccpm info skill-creator # 获取技能详情 +ccpm uninstall pdf-processor # 删除技能 + +# 安装技能包 +ccpm install-bundle web-dev # 安装 Web 开发技能包 +``` + +**🎬 实时演示** + +*即将推出* + +📚 **文档**：参见 [skills-search/SKILL.md](./skills-search/SKILL.md) 了解完整的命令参考 + +**要求**：CCPM CLI（`npm install -g @daymade/ccpm`） + +--- + ## 🎬 交互式演示画廊 想要在一个地方查看所有演示并具有点击放大功能？访问我们的[交互式演示画廊](./demos/index.html)或浏览[演示目录](./demos/)。 @@ -850,6 +902,9 @@ python3 scripts/analyze_sessions.py stats /path/to/session.jsonl --show-files ### 文档维护 使用 **docs-cleaner** 在保留有价值内容的同时整合冗余文档。非常适合在快速开发阶段后清理文档扩散或将重叠的文档合并为权威来源。 +### 技能发现与管理 +使用 **skills-search** 从 CCPM 注册表中查找、安装和管理 Claude Code 技能。非常适合为特定任务发现新技能、为常见工作流安装技能包，以及保持技能集合的有序管理。 + ## 📚 文档 每个技能包括： @@ -880,6 +935,7 @@ python3 scripts/analyze_sessions.py stats /path/to/session.jsonl --show-files - **prompt-optimizer**：参见 `prompt-optimizer/references/ears_syntax.md` 了解 EARS 转换模式、`prompt-optimizer/references/domain_theories.md` 了解理论目录和 `prompt-optimizer/references/examples.md` 了解完整转换示例 - **claude-code-history-files-finder**：参见 `claude-code-history-files-finder/references/session_file_format.md` 了解 JSONL 结构和 `claude-code-history-files-finder/references/workflow_examples.md` 了解恢复工作流 - **docs-cleaner**：参见 `docs-cleaner/SKILL.md` 了解整合工作流 +- **skills-search**：参见 `skills-search/SKILL.md` 了解 CCPM CLI 命令和注册表操作 ## 🛠️ 系统要求 @@ -893,6 +949,7 @@ python3 scripts/analyze_sessions.py stats /path/to/session.jsonl --show-files - **ccusage**（可选，用于状态栏成本跟踪） - **yt-dlp**（用于 youtube-downloader）：`brew install yt-dlp` 或 `pip install yt-dlp` - **FFmpeg/FFprobe**（用于 video-comparer）：`brew install ffmpeg`、`apt install ffmpeg` 或 `winget install ffmpeg` +- **CCPM CLI**（用于 skills-search）：`npm install -g @daymade/ccpm` ## ❓ 常见问题 diff --git a/docs-cleaner/.security-scan-passed b/docs-cleaner/.security-scan-passed new file mode 100644 index 0000000..6a31a28 --- /dev/null +++ b/docs-cleaner/.security-scan-passed @@ -0,0 +1,4 @@ +Security scan passed +Scanned at: 2025-12-01T19:34:07.888071 +Tool: gitleaks + pattern-based validation +Content hash: 05162f259948be068f6d59cf0c66cf9971eb7b2fce92c8485b8332c80e440b49 diff --git a/docs-cleaner/SKILL.md b/docs-cleaner/SKILL.md new file mode 100644 index 0000000..c6e6bea --- /dev/null +++ b/docs-cleaner/SKILL.md @@ -0,0 +1,84 @@ +--- +name: docs-cleaner +description: Consolidates redundant documentation while preserving all valuable content. This skill should be used when users want to clean up documentation bloat, merge redundant docs, reduce documentation sprawl, or consolidate multiple files covering the same topic. Triggers include "clean up docs", "consolidate documentation", "too many doc files", "merge these docs", or when documentation exceeds 500 lines across multiple files covering similar topics. +--- + +# Documentation Cleaner + +Consolidate redundant documentation while preserving 100% of valuable content. + +## Core Principle + +**Critical evaluation before deletion.** Never blindly delete. Analyze each section's unique value before proposing removal. The goal is reduction without information loss. + +## Workflow + +### Phase 1: Discovery + +1. Identify all documentation files covering the topic +2. Count total lines across files +3. Map content overlap between documents + +### Phase 2: Value Analysis + +For each document, create a section-by-section analysis table: + +| Section | Lines | Value | Reason | +|---------|-------|-------|--------| +| API Reference | 25 | Keep | Unique endpoint documentation | +| Setup Steps | 40 | Condense | Verbose but essential | +| Test Results | 30 | Delete | One-time record, not reference | + +Value categories: +- **Keep**: Unique, essential, frequently referenced +- **Condense**: Valuable but verbose +- **Delete**: Duplicate, one-time, self-evident, outdated + +See `references/value_analysis_template.md` for detailed criteria. + +### Phase 3: Consolidation Plan + +Propose target structure: + +``` +Before: 726 lines (3 files, high redundancy) +After: ~100 lines (1 file + reference in CLAUDE.md) +Reduction: 86% +Value preserved: 100% +``` + +### Phase 4: Execution + +1. Create consolidated document with all valuable content +2. Delete redundant source files +3. Update references (CLAUDE.md, README, imports) +4. Verify no broken links + +## Value Preservation Checklist + +Before finalizing, confirm preservation of: + +- [ ] Essential procedures (setup, configuration) +- [ ] Key constraints and gotchas +- [ ] Troubleshooting guides +- [ ] Technical debt / roadmap items +- [ ] External links and references +- [ ] Debug tips and code snippets + +## Anti-Patterns + +| Pattern | Problem | Solution | +|---------|---------|----------| +| Blind deletion | Loses valuable information | Section-by-section analysis first | +| Keeping everything | No reduction achieved | Apply value criteria strictly | +| Multiple sources of truth | Future divergence | Single authoritative location | +| Orphaned references | Broken links | Update all references after consolidation | + +## Output Artifacts + +A successful cleanup produces: + +1. **Consolidated document** - Single source of truth +2. **Value analysis** - Section-by-section justification +3. **Before/after metrics** - Lines reduced, value preserved +4. **Updated references** - CLAUDE.md or README with pointer to new location diff --git a/docs-cleaner/references/value_analysis_template.md b/docs-cleaner/references/value_analysis_template.md new file mode 100644 index 0000000..17627ac --- /dev/null +++ b/docs-cleaner/references/value_analysis_template.md @@ -0,0 +1,50 @@ +# Value Analysis Template + +Use this template for section-by-section documentation analysis. + +## Document Analysis Table + +| Section | Lines | Value | Reason | +|---------|-------|-------|--------| +| Example Section | 25 | Keep | Contains unique troubleshooting steps not documented elsewhere | +| Another Section | 40 | Delete | Duplicates content in CLAUDE.md | +| Technical Details | 60 | Condense | Valuable but verbose; can be reduced to 15 lines | +| Setup Instructions | 30 | Keep | Essential for onboarding | + +## Value Categories + +### Keep (Green) +- Unique information not found elsewhere +- Essential procedures (setup, troubleshooting, constraints) +- Frequently referenced content +- Technical debt / roadmap items + +### Condense (Yellow) +- Valuable but overly verbose +- Contains redundant examples +- Can be expressed more concisely + +### Delete (Red) +- Duplicates existing documentation +- One-time records (test results, meeting notes) +- Self-evident information (code already documents this) +- Outdated or superseded content + +## Consolidation Checklist + +Before proposing deletions: + +- [ ] Identified ALL files containing related content +- [ ] Mapped overlap between documents +- [ ] Listed unique value in each document +- [ ] Proposed single source of truth location +- [ ] Planned reference updates (CLAUDE.md, README, etc.) + +## Output Format + +After analysis, produce: + +1. **Value Analysis Table** - Per-section breakdown with keep/condense/delete +2. **Consolidation Plan** - Target structure with line count estimates +3. **Before/After Comparison** - Total lines and percentage reduction +4. **Preserved Value Checklist** - Confirm all valuable content retained diff --git a/skills-search/.security-scan-passed b/skills-search/.security-scan-passed new file mode 100644 index 0000000..1c4148c --- /dev/null +++ b/skills-search/.security-scan-passed @@ -0,0 +1,4 @@ +Security scan passed +Scanned at: 2025-11-30T03:26:12.206682 +Tool: gitleaks + pattern-based validation +Content hash: 493826cb21eefb61a82bf0a81dbccec44888e7b68b21bfdd02a2dd301805a695 diff --git a/skills-search/SKILL.md b/skills-search/SKILL.md new file mode 100644 index 0000000..3130665 --- /dev/null +++ b/skills-search/SKILL.md @@ -0,0 +1,176 @@ +--- +name: skills-search +description: This skill should be used when users want to search, discover, install, or manage Claude Code skills from the CCPM registry. Triggers include requests like "find skills for PDF", "search for code review skills", "install cloudflare-troubleshooting", "list my installed skills", "what does skill-creator do", or any mention of finding/installing/managing Claude Code skills or plugins. +--- + +# Skills Search + +## Overview + +Search, discover, and manage Claude Code skills from the CCPM (Claude Code Plugin Manager) registry. This skill wraps the `ccpm` CLI to provide seamless skill discovery and installation. + +## Quick Start + +```bash +# Search for skills +ccpm search + +# Install a skill +ccpm install + +# List installed skills +ccpm list + +# Get skill details +ccpm info +``` + +## Commands Reference + +### Search Skills + +Search the CCPM registry for skills matching a query. + +```bash +ccpm search [options] + +Options: + --limit Maximum results (default: 10) + --json Output as JSON +``` + +**Examples:** +```bash +ccpm search pdf # Find PDF-related skills +ccpm search "code review" # Find code review skills +ccpm search cloudflare # Find Cloudflare tools +ccpm search --limit 20 react # Find React skills, show 20 results +``` + +### Install Skills + +Install a skill to make it available in Claude Code. + +```bash +ccpm install [options] + +Options: + --project Install to current project only (default: user-level) + --force Force reinstall even if already installed +``` + +**Examples:** +```bash +ccpm install pdf-processor # Install pdf-processor skill +ccpm install @daymade/skill-creator # Install namespaced skill +ccpm install cloudflare-troubleshooting # Install troubleshooting skill +ccpm install react-component-builder --project # Install for current project only +``` + +**Important:** After installing a skill, Claude Code must be restarted for the skill to become available. + +### List Installed Skills + +Show all currently installed skills. + +```bash +ccpm list [options] + +Options: + --json Output as JSON +``` + +**Output includes:** +- Skill name and version +- Installation scope (user/project) +- Installation path + +### Get Skill Information + +Show detailed information about a skill from the registry. + +```bash +ccpm info +``` + +**Output includes:** +- Name, description, version +- Author and repository +- Download count and tags +- Dependencies (if any) + +**Example:** +```bash +ccpm info skill-creator +``` + +### Uninstall Skills + +Remove an installed skill. + +```bash +ccpm uninstall [options] + +Options: + --global Uninstall from user-level installation + --project Uninstall from project-level installation +``` + +**Example:** +```bash +ccpm uninstall pdf-processor +``` + +## Workflow: Finding and Installing Skills + +When a user needs functionality that might be available as a skill: + +1. **Search** for relevant skills: + ```bash + ccpm search + ``` + +2. **Review** the search results - check download counts and descriptions + +3. **Get details** on promising skills: + ```bash + ccpm info + ``` + +4. **Install** the chosen skill: + ```bash + ccpm install + ``` + +5. **Inform user** to restart Claude Code to use the new skill + +## Popular Skills + +Common skills users may want: + +| Skill | Purpose | +|-------|---------| +| `skill-creator` | Create new Claude Code skills | +| `pdf-processor` | PDF manipulation and analysis | +| `docx` | Word document processing | +| `xlsx` | Excel spreadsheet operations | +| `pptx` | PowerPoint presentation creation | +| `cloudflare-troubleshooting` | Debug Cloudflare issues | +| `prompt-optimizer` | Improve prompt quality | + +## Troubleshooting + +### "ccpm: command not found" + +Install CCPM globally: +```bash +npm install -g @anthropic/ccpm +``` + +### Skill not available after install + +Restart Claude Code - skills are loaded at startup. + +### Permission errors + +Try installing with user scope (default) or check write permissions to `~/.claude/skills/`.