firefrost-gaming/claude-code-skills-reference

Files

daymade c1cfacaf76 feat(skills-search): rewrite SKILL.md as Agent behavioral directives

- Transform from passive user documentation to active Agent instructions
- Add allowed-tools: Bash, Read for direct command execution
- Add intent mapping table: user intent → ccpm command
- Add execution rules: Claude runs commands directly, no copy-paste
- Add MCP server cross-reference for Claude Desktop users

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-23 16:16:02 +08:00

3.8 KiB

Raw Blame History

name, description, allowed-tools

name	description	allowed-tools
skills-search	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.	Bash, Read

Skills Search — Agent Behavioral Directives

Core Behavior

When this skill is activated, you MUST directly execute the appropriate ccpm command using the Bash tool. Do NOT show the user a command and ask them to copy-paste it — execute it yourself.

If ccpm is not installed, use npx @daymade/ccpm as a drop-in replacement for all commands below.

Intent Mapping

Match the user's intent to the correct action:

User Intent	Action
"find skills for X" / "search X skills"	`ccpm search <query>`
"what skills are popular" / "top skills"	`ccpm popular`
"what's new" / "latest skills"	`ccpm recent`
"install X" / "add X skill"	`ccpm install <skill-name>`
"what does X do" / "tell me about X"	`ccpm info <skill-name>`
"what skills do I have" / "list skills"	`ccpm list`
"remove X" / "uninstall X"	`ccpm uninstall <skill-name>`
"update X" / "update all skills"	`ccpm update [name] [--all]`
"I need help with PDF/Excel/..."	`ccpm search <topic>`, then offer to install the best match

Execution Rules

Always execute directly — run ccpm commands via the Bash tool, never ask the user to run them manually.
Summarize results — after executing, present the output in a clear, readable format.
Suggest next steps — after search results, offer to install. After install, remind the user to restart Claude Code.
Handle errors gracefully — if ccpm is not found, fall back to npx @daymade/ccpm. If the registry is unreachable, say so clearly.
Namespaced skills — support @org/skill-name format (e.g., ccpm install @daymade/skill-creator).

Command Reference

Search

ccpm search <query> [--limit <n>] [--tags <t1,t2>] [--author <name>] [--smart]

Discovery

ccpm popular [--limit <n>]       # Most downloaded
ccpm recent [--limit <n>]        # Recently published/updated

Install & Manage

ccpm install <skill-name>        # Install (user-level, default)
ccpm install <name> --project    # Install to current project only
ccpm install <name> --force      # Force reinstall
ccpm list                        # List installed skills
ccpm info <skill-name>           # Detailed skill information
ccpm update [name]               # Update a skill
ccpm update --all                # Update all skills
ccpm uninstall <skill-name>      # Remove a skill

Post-Install Reminder

After any successful install, always tell the user:

Skill installed successfully. Please restart Claude Code (or start a new conversation) for the skill to become available.

MCP Server Alternative

For Claude Desktop users who want native tool integration (no Bash needed), the same functionality is available as an MCP server:

{
  "mcpServers": {
    "skill-search": {
      "command": "npx",
      "args": ["-y", "skills-search-mcp"]
    }
  }
}

Both this skill and the MCP server wrap the same ccpm CLI — they are complementary, not conflicting.

Troubleshooting

"ccpm: command not found"

Use npx @daymade/ccpm instead, or install globally: npm install -g @daymade/ccpm.

Skill not available after install

Restart Claude Code — skills are loaded at startup.

Permission errors

Check write permissions to ~/.claude/skills/. Try installing with --project for project-level scope.

3.8 KiB Raw Blame History