ccmds - Documentation Search
Use this skill when user asks about documentation. More efficient than reading files directly.
When to Activate
- "What do the docs say about..."
- "Check the documentation" / "check the docs"
- "How do I..." (setup/config questions)
- "Find in documentation" / "search docs"
- Questions about setup, configuration, installation, API
First: Check Configuration
ccmds config # View current config
ccmds init # Create .ccmdsrc if missing
With a .ccmdsrc config file, commands use project defaults automatically.
Command Decision Guide
| User Intent | Command | Why |
|---|---|---|
| Conceptual question, don't know exact terms | ccmds find "query" |
Fuzzy search |
| Exact term, error code, pattern | ccmds grep "pattern" |
Regex match |
| Understand doc structure | ccmds outline |
Headings only, minimal context |
| Need specific section | ccmds section file.md "Heading" |
Targeted extraction |
| See what docs exist | ccmds list |
File listing |
| Read full file (after finding it) | ccmds show file.md |
Full content |
Basic Syntax
ccmds find "authentication" # Fuzzy search
ccmds grep "ERROR_[0-9]+" # Regex search
ccmds outline # Show structure
ccmds section ./docs/setup.md "Install" # Extract section
ccmds list # List files
ccmds show ./docs/api.md # Show file
Output Modes
| Mode | Use | Context |
|---|---|---|
json |
AI-optimized (default) | Compact |
files |
Just need paths | Minimal |
compact |
Human-readable snippets | Small |
detailed |
Full context | Medium |
Default: json. Use -o compact for human-readable output.
Common Overrides
ccmds find "query" -l 5 # Limit results
ccmds find "query" ./other/docs # Different directory
ccmds find "query" --doc api # Search only "api" docs
ccmds grep "pattern" -o files # Files only output
ccmds list -e "**/archive/**" # Exclude pattern
Recommended Workflow
ccmds outline -d 2- Understand structure (minimal context)ccmds find "topic"- Find relevant docsccmds section file.md "Section"- Extract what you need
For detailed documentation:
- Command Reference - Full options for all commands
- Examples & Workflows - Common patterns and use cases
- Configuration - Config file schema and patterns