Skip to main content

Use handbook-discover skill

handbook-discover

Discover, browse, and audit all plugins in the cc-handbook marketplace — with installation status, versions, and component breakdown.

This skill runs a Python discovery script that inventories every plugin in the marketplace and reports which are installed, disabled, or missing — along with component counts per plugin.

When to Use This Skill​

Use the handbook-discover skill when you want to:

  • See all available cc-handbook plugins at a glance
  • Check which plugins are installed and enabled
  • Find plugins by keyword or component type
  • Get a machine-readable inventory for scripting or auditing

Quick Examples​

# List all plugins with status
python ${CLAUDE_SKILL_DIR}/scripts/discover.py

# Show component names per plugin
python ${CLAUDE_SKILL_DIR}/scripts/discover.py --detailed

# Filter by keyword
python ${CLAUDE_SKILL_DIR}/scripts/discover.py --filter dotnet

# Only show uninstalled plugins
python ${CLAUDE_SKILL_DIR}/scripts/discover.py --uninstalled

# Machine-readable JSON output
python ${CLAUDE_SKILL_DIR}/scripts/discover.py --json

Status Legend​

SymbolMeaning
[+]Installed and enabled
[o]Installed but disabled
[ ]Not installed

Component counts use single-letter codes: S=skills A=agents C=commands M=mcp L=lsp H=hooks

Skill Specification​

---
name: handbook-discover
description: This skill should be used when users want to discover, browse, or audit cc-handbook marketplace plugins. Shows all available plugins with installation status, versions, and component breakdown (skills, agents, commands, MCP/LSP servers, hooks). Trigger phrases include "discover plugins", "list handbook plugins", "what plugins are available", "browse marketplace".
---

# Handbook Plugin Discovery

Run the discovery script to inventory all plugins in a Claude Code marketplace.

## Usage

```bash
python ${CLAUDE_SKILL_DIR}/scripts/discover.py # default: cc-handbook
python ${CLAUDE_SKILL_DIR}/scripts/discover.py --detailed # show component names
python ${CLAUDE_SKILL_DIR}/scripts/discover.py --json # machine-readable
python ${CLAUDE_SKILL_DIR}/scripts/discover.py --filter dotnet # filter by keyword
python ${CLAUDE_SKILL_DIR}/scripts/discover.py --uninstalled # only uninstalled
python ${CLAUDE_SKILL_DIR}/scripts/discover.py -m <marketplace> # other marketplace
python ${CLAUDE_SKILL_DIR}/scripts/discover.py -r <path> # explicit repo path
```

## Interpreting Results

- `[+]` — installed and enabled
- `[o]` — installed but disabled
- `[ ]` — not installed
- Component counts: `S`=skills `A`=agents `C`=commands `M`=mcp `L`=lsp `H`=hooks

## Follow-up Actions

For uninstalled plugins, suggest:
```bash
claude plugin install <plugin-name>@cc-handbook
```