Files
claude-howto/INDEX.md
T
Luong NGUYEN 1e16914a8d docs: sync to Claude Code v2.1.257 (#180)
* docs: sync to Claude Code v2.1.257

Audit against Claude Code v2.1.257 (repo baseline was v2.1.245, 12 releases
behind). Facts verified against the official docs and cross-checked against
the locally installed 2.1.257 binary.

Critical (P0):
- lesson-quiz L06 Q9 asked how many hook events exist, offering 16/25/31/40.
  With the real answer now 33, no option was correct. Option C 31 -> 33;
  answer letter unchanged.
- 03-skills taught SKILL.md `name`/`description` as required. Official docs
  now state all frontmatter fields are optional and `name` defaults to the
  directory name. Corrected in all five languages.

Hook events 31 -> 33 (PreModelSwitch/PostModelSwitch, v2.1.251) across 30
occurrences in 22 files, including three that read 25. Delta proved by
set-diff against the official event table: no phantom events. Both events
added to the 06-hooks tables with matcher, blocking behavior and 30s timeout,
plus detailed per-event sections.

CLI corrections verified against the binary:
- `claude plugin tag` takes a path, not a version
- `claude plugin init` / `validate` require their arguments
- `plugin init` scaffolds at ~/.claude/skills/<name>/, not project-local
- `--channels` entries must be tagged plugin:<name>@<marketplace>
- `--remote` is a deprecated alias for `--cloud`
- no `claude remote-control` subcommand exists, only the --remote-control flag

Also: CATALOG summary-table totals recomputed in all five languages (column 4
is a derived total, so the count change invalidated it); stale Opus 4.6/4.7
rosters aligned to canonical; self-assessment Advanced Features rescored 0-3
to stop a real gap being graded as mastery; 9 dangling quiz Review pointers
repaired; new features documented (--restricted, Fable 5.1,
experimental.cacheTtl, CLAUDE_CODE_SUBAGENT_MODEL_FORCE).

Deliberately out of scope: pre-existing translation staleness whose fix is
translation authorship rather than correction (ja/uk April-2026 root-doc
bodies, zh stubs, vi/README stub, translated CATALOG "New Features").

Claude-Session: https://claude.ai/code/session_01128xfEd8W7c2cMRw6N7uiF

* fix(hooks): complete the 31 → 33 hook-event propagation across all languages

The v2.1.257 sync bumped the hook-event count in the lesson and catalog
summaries but left 14 files still asserting 31, four of which the same
commit restamped 2.1.257. It also bumped the prose count in
claude_concepts_guide.md without adding the two rows, making that file
contradict itself where it had been internally consistent before.

Adds PreModelSwitch and PostModelSwitch (v2.1.251) everywhere an
exhaustive enumeration exists, and corrects the count wherever a list is
deliberately partial:

- README.md / INDEX.md in en, ja, zh, uk and vi/INDEX.md — count 31 → 33
  and both events added to the lifecycle group
- resources.md in all five languages — count only; these lists end in
  "and more" and are partial by design
- claude_concepts_guide.md — the two missing table rows

Also brings every hook-event table up to the 33 its own summary row
claims. The English CATALOG.md listed 29; the translated catalogs listed
25 and the ja/uk concept guides 27 and 28. Completing them required
translating six events that had never reached the mirrors: Setup,
UserPromptExpansion, PermissionDenied, PostToolBatch, MessageDisplay and
DirectoryAdded.

Summary-table arithmetic is untouched — those columns count example
scripts, not events.

Verified: no stale count survives outside CHANGELOG history, every
exhaustive enumeration lists exactly 33, and pre-commit passes 23/23.

Claude-Session: https://claude.ai/code/session_01UXmqJZNk1BR4uerJA85NiW
2026-09-02 10:35:08 +02:00

915 lines
31 KiB
Markdown

<picture>
<source media="(prefers-color-scheme: dark)" srcset="resources/logos/claude-howto-logo-dark.svg">
<img alt="Claude How To" src="resources/logos/claude-howto-logo.svg">
</picture>
# Claude Code Examples - Complete Index
This document provides a complete index of all example files organized by feature type.
## Summary Statistics
- **Total Files**: 100+ files
- **Categories**: 10 feature categories
- **Plugins**: 3 complete plugins
- **Skills**: 6 complete skills
- **Hooks**: 11 example hooks
- **Ready to Use**: All examples
---
## 01. Slash Commands (10 files)
User-invoked shortcuts for common workflows.
| File | Description | Use Case |
|------|-------------|----------|
| `optimize.md` | Code optimization analyzer | Find performance issues |
| `pr.md` | Pull request preparation | PR workflow automation |
| `generate-api-docs.md` | API documentation generator | Generate API docs |
| `commit.md` | Commit message helper | Standardized commits |
| `setup-ci-cd.md` | CI/CD pipeline setup | DevOps automation |
| `push-all.md` | Push all changes | Quick push workflow |
| `unit-test-expand.md` | Expand unit test coverage | Test automation |
| `doc-refactor.md` | Documentation refactoring | Doc improvements |
| `pr-slash-command.png` | Screenshot example | Visual reference |
| `README.md` | Documentation | Setup and usage guide |
**Installation Path**: `.claude/commands/`
**Usage**: `/optimize`, `/pr`, `/generate-api-docs`, `/commit`, `/setup-ci-cd`, `/push-all`, `/unit-test-expand`, `/doc-refactor`
---
## 02. Memory (6 files)
Persistent context and project standards.
| File | Description | Scope | Location |
|------|-------------|-------|----------|
| `project-CLAUDE.md` | Team project standards | Project-wide | `./CLAUDE.md` |
| `directory-api-CLAUDE.md` | API-specific rules | Directory | `./src/api/CLAUDE.md` |
| `personal-CLAUDE.md` | Personal preferences | User | `~/.claude/CLAUDE.md` |
| `memory-saved.png` | Screenshot: memory saved | - | Visual reference |
| `memory-ask-claude.png` | Screenshot: ask Claude | - | Visual reference |
| `README.md` | Documentation | - | Reference |
**Installation**: Copy to appropriate location
**Usage**: Automatically loaded by Claude
---
## 03. Skills (23 files)
Auto-invoked capabilities with scripts and templates.
### Code Review Skill (5 files)
```
code-review-specialist/
├── SKILL.md # Skill definition
├── scripts/
│ ├── analyze-metrics.py # Code metrics analyzer
│ └── compare-complexity.py # Complexity comparison
└── templates/
├── review-checklist.md # Review checklist
└── finding-template.md # Finding documentation
```
**Purpose**: Comprehensive code review with security, performance, and quality analysis
**Auto-invoked**: When reviewing code
---
### Brand Voice Skill (4 files)
```
brand-voice/
├── SKILL.md # Skill definition
├── templates/
│ ├── email-template.txt # Email format
│ └── social-post-template.txt # Social media format
└── tone-examples.md # Example messages
```
**Purpose**: Ensure consistent brand voice in communications
**Auto-invoked**: When creating marketing copy
---
### Documentation Generator Skill (2 files)
```
doc-generator/
├── SKILL.md # Skill definition
└── generate-docs.py # Python doc extractor
```
**Purpose**: Generate comprehensive API documentation from source code
**Auto-invoked**: When creating/updating API documentation
---
### Refactor Skill (5 files)
```
refactor/
├── SKILL.md # Skill definition
├── scripts/
│ ├── analyze-complexity.py # Complexity analyzer
│ └── detect-smells.py # Code smell detector
├── references/
│ ├── code-smells.md # Code smells catalog
│ └── refactoring-catalog.md # Refactoring patterns
└── templates/
└── refactoring-plan.md # Refactoring plan template
```
**Purpose**: Systematic code refactoring with complexity analysis
**Auto-invoked**: When refactoring code
---
### Claude MD Skill (1 file)
```
claude-md/
└── SKILL.md # Skill definition
```
**Purpose**: Manage and optimize CLAUDE.md files
---
### Blog Draft Skill (3 files)
```
blog-draft/
├── SKILL.md # Skill definition
└── templates/
├── draft-template.md # Blog draft template
└── outline-template.md # Blog outline template
```
**Purpose**: Draft blog posts with consistent structure
**Plus**: `README.md` - Skills overview and usage guide
**Installation Path**: `~/.claude/skills/` or `.claude/skills/`
---
## 04. Subagents (10 files)
Specialized AI assistants with custom capabilities.
| File | Description | Tools | Use Case |
|------|-------------|-------|----------|
| `code-reviewer.md` | Code quality analysis | Read, Grep, Glob, Bash | Comprehensive reviews |
| `test-engineer.md` | Test coverage analysis | Read, Write, Bash, Grep | Test automation |
| `documentation-writer.md` | Documentation creation | Read, Write, Grep | Doc generation |
| `secure-reviewer.md` | Security review (read-only) | Read, Grep | Security audits |
| `implementation-agent.md` | Full implementation | Read, Write, Edit, Bash, Grep, Glob | Feature development |
| `debugger.md` | Debugging specialist | Read, Edit, Bash, Grep, Glob | Bug investigation |
| `data-scientist.md` | Data analysis specialist | Bash, Read, Write | Data workflows |
| `clean-code-reviewer.md` | Clean code standards | Read, Grep, Glob, Bash | Code quality |
| `performance-optimizer.md` | Performance bottleneck analysis | Read, Edit, Bash, Grep, Glob | Optimization work |
| `README.md` | Documentation | - | Setup and usage guide |
**Installation Path**: `.claude/agents/`
**Usage**: Automatically delegated by main agent
---
## 05. MCP Protocol (5 files)
External tool and API integrations.
| File | Description | Integrates With | Use Case |
|------|-------------|-----------------|----------|
| `github-mcp.json` | GitHub integration | GitHub API | PR/issue management |
| `database-mcp.json` | Database queries | PostgreSQL/MySQL | Live data queries |
| `filesystem-mcp.json` | File operations | Local filesystem | File management |
| `multi-mcp.json` | Multiple servers | GitHub + DB + Slack | Complete integration |
| `README.md` | Documentation | - | Setup and usage guide |
**Installation Path**: `.mcp.json` (project scope) or `~/.claude.json` (user scope)
**Usage**: `/mcp__github__list_prs`, etc.
---
## 06. Hooks (12 files)
Event-driven automation scripts that execute automatically.
| File | Description | Event | Use Case |
|------|-------------|-------|----------|
| `format-code.sh` | Auto-format code | PostToolUse (matcher: Write) | Code formatting |
| `pre-commit.sh` | Run tests before commit | PreToolUse (matcher: Bash) | Test automation |
| `pre-tool-check.sh` | Validate and audit commands before they run | PreToolUse (matcher: Bash) | Guardrails, audit log |
| `security-scan.sh` | Security scanning | PostToolUse (matcher: Write) | Security checks |
| `dependency-check.sh` | Scan dependency manifests for vulnerabilities | PostToolUse (matcher: Write) | Supply-chain checks |
| `log-bash.sh` | Log bash commands | PostToolUse (matcher: Bash) | Command logging |
| `notify-team.sh` | Send notifications | PostToolUse (matcher: Bash) | Team notifications |
| `validate-prompt.sh` | Validate prompts | UserPromptSubmit | Input validation |
| `session-end.sh` | Capture progress when a session ends | SessionEnd | Progress tracking |
| `context-tracker.py` | Track context window usage | UserPromptSubmit, Stop | Context monitoring |
| `context-tracker-tiktoken.py` | Token-based context tracking | UserPromptSubmit, Stop | Precise token counting |
| `README.md` | Documentation | - | Setup and usage guide |
**Installation Path**: Configure in `~/.claude/settings.json`
**Usage**: Configured in settings, executed automatically
**Hook Types** (5): `command`, `http`, `prompt`, `mcp_tool`, `agent` — how a hook runs.
**Hook Events** (33, in 4 categories) — when it runs:
- Tool Hooks: PreToolUse, PostToolUse, PostToolUseFailure, PostToolBatch, PermissionRequest, PermissionDenied
- Session Hooks: SessionStart, Setup, SessionEnd, Stop, StopFailure, SubagentStart, SubagentStop
- Task Hooks: UserPromptSubmit, UserPromptExpansion, MessageDisplay, TaskCompleted, TaskCreated, TeammateIdle (TaskCompleted/TaskCreated only fire when the todo tools are enabled — off by default on Opus 4.8, Sonnet 5, Fable 5, Mythos 5 and newer)
- Lifecycle Hooks: ConfigChange, CwdChanged, DirectoryAdded, FileChanged, PreCompact, PostCompact, PreModelSwitch, PostModelSwitch, WorktreeCreate, WorktreeRemove, Notification, InstructionsLoaded, Elicitation, ElicitationResult
---
## 07. Plugins (3 complete plugins, 39 files)
Bundled collections of features.
### PR Review Plugin (10 files)
```
pr-review/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── commands/
│ ├── review-pr.md # Comprehensive review
│ ├── check-security.md # Security check
│ └── check-tests.md # Test coverage check
├── agents/
│ ├── security-reviewer.md # Security specialist
│ ├── test-checker.md # Test specialist
│ └── performance-analyzer.md # Performance specialist
├── mcp/
│ └── github-config.json # GitHub integration
├── hooks/
│ └── pre-review.js # Pre-review validation
└── README.md # Plugin documentation
```
**Features**: Security analysis, test coverage, performance impact
**Commands**: `/review-pr`, `/check-security`, `/check-tests`
**Installation**: `/plugin install pr-review`
---
### DevOps Automation Plugin (15 files)
```
devops-automation/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── commands/
│ ├── deploy.md # Deployment
│ ├── rollback.md # Rollback
│ ├── status.md # System status
│ └── incident.md # Incident response
├── agents/
│ ├── deployment-specialist.md # Deployment expert
│ ├── incident-commander.md # Incident coordinator
│ └── alert-analyzer.md # Alert analyzer
├── mcp/
│ └── kubernetes-config.json # Kubernetes integration
├── hooks/
│ ├── pre-deploy.js # Pre-deployment checks
│ └── post-deploy.js # Post-deployment tasks
├── scripts/
│ ├── deploy.sh # Deployment automation
│ ├── rollback.sh # Rollback automation
│ └── health-check.sh # Health checks
└── README.md # Plugin documentation
```
**Features**: Kubernetes deployment, rollback, monitoring, incident response
**Commands**: `/deploy`, `/rollback`, `/status`, `/incident`
**Installation**: `/plugin install devops-automation`
---
### Documentation Plugin (14 files)
```
documentation/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── commands/
│ ├── generate-api-docs.md # API docs generation
│ ├── generate-readme.md # README creation
│ ├── sync-docs.md # Doc synchronization
│ └── validate-docs.md # Doc validation
├── agents/
│ ├── api-documenter.md # API doc specialist
│ ├── code-commentator.md # Code comment specialist
│ └── example-generator.md # Example creator
├── mcp/
│ └── github-docs-config.json # GitHub integration
├── templates/
│ ├── api-endpoint.md # API endpoint template
│ ├── function-docs.md # Function doc template
│ └── adr-template.md # ADR template
└── README.md # Plugin documentation
```
**Features**: API docs, README generation, doc sync, validation
**Commands**: `/generate-api-docs`, `/generate-readme`, `/sync-docs`, `/validate-docs`
**Installation**: `/plugin install documentation`
**Plus**: `README.md` - Plugins overview and usage guide
---
## 08. Checkpoints and Rewind (2 files)
Save conversation state and explore alternative approaches.
| File | Description | Content |
|------|-------------|---------|
| `README.md` | Documentation | Comprehensive checkpoint guide |
| `checkpoint-examples.md` | Real-world examples | Database migration, performance optimization, UI iteration, debugging |
| | | |
**Key Concepts**:
- **Checkpoint**: Snapshot of conversation state
- **Rewind**: Return to previous checkpoint
- **Branch Point**: Explore multiple approaches
**Usage**:
```
# Checkpoints are created automatically with every user prompt
# To rewind, press Esc twice or use:
/rewind
# Then choose: Restore code and conversation, Restore conversation,
# Restore code, Summarize from here, or Never mind
```
**Use Cases**:
- Try different implementations
- Recover from mistakes
- Safe experimentation
- Compare solutions
- A/B testing
---
## 09. Advanced Features (4 files)
Advanced capabilities for complex workflows.
| File | Description | Features |
|------|-------------|----------|
| `README.md` | Complete guide | All advanced features documentation |
| `config-examples.json` | Configuration examples | 10+ use-case-specific configurations |
| `planning-mode-examples.md` | Planning examples | REST API, database migration, refactoring |
| `setup-auto-mode-permissions.py` | Seed `permissions.allow` for auto mode | Idempotent, `--dry-run` and opt-in flags |
| Dynamic Workflows | Deterministic multi-agent orchestration via `/workflows` (v2.1.154) | Comprehensive audits, migrations, scale-out |
| Scheduled Tasks | Recurring tasks with `/loop` and cron tools | Automated recurring workflows |
| Chrome Integration | Browser automation via headless Chromium | Web testing and scraping |
| Remote Control (expanded) | Connection methods, security, comparison table, device cards | Remote session management (no longer a research preview) |
| Cross-Session Messaging | `SendMessage` / `ListAgents`, including `notify_when_idle` (v2.1.236) | Coordinating sessions on the same machine |
| Keyboard Customization | Custom keybindings, chord support, contexts | Personalized shortcuts |
| Desktop App (expanded) | Connectors, launch.json, enterprise features | Desktop integration |
| | | |
**Advanced Features Covered**:
### Planning Mode
- Create detailed implementation plans
- Time estimates and risk assessment
- Systematic task breakdown
### Extended Thinking
- Deep reasoning for complex problems
- Architectural decision analysis
- Trade-off evaluation
### Background Tasks
- Long-running operations without blocking
- Parallel development workflows
- Task management and monitoring
### Dynamic Workflows (v2.1.154)
- Deterministic orchestration of tens-to-hundreds of background subagents
- Fan-out / pipeline / parallel stages for comprehensive coverage
- View runs with `/workflows`; `ultracode` `/effort` turns it on for a session
- Default size guideline is medium (aim for fewer than 15 agents) as of v2.1.219 — change it with **Dynamic workflow size** in `/config`
### Permission Modes
- **manual**: Ask for approval on risky actions (renamed from `default` in v2.1.200; `default` still accepted)
- **acceptEdits**: Auto-accept file edits, ask for others
- **plan**: Read-only analysis, no modifications
- **auto**: Everything, with background safety checks — a classifier reviews commands and protected-directory writes (configured via the `autoMode` settings object)
- **dontAsk**: Only pre-approved tools — auto-denies every call that would otherwise prompt. Claude runs only `permissions.allow` matches, read-only Bash commands, and calls approved by a `PreToolUse` hook
- **bypassPermissions**: Accept all (requires `--dangerously-skip-permissions`)
### Headless Mode (`claude -p`)
- CI/CD integration
- Automated task execution
- Batch processing
### Session Management
- Multiple work sessions
- Session switching and saving
- Session persistence
### Interactive Features
- Keyboard shortcuts
- Command history
- Tab completion
- Multi-line input
### Configuration
- Comprehensive settings management
- Environment-specific configs
- Per-project customization
### Scheduled Tasks
- Recurring tasks with `/loop` command
- Cron tools: CronCreate, CronList, CronDelete
- Automated recurring workflows
### Chrome Integration
- Browser automation via headless Chromium
- Web testing and scraping capabilities
- Page interaction and data extraction
### Remote Control (expanded)
- Connection methods and protocols
- Security considerations and best practices
- Comparison table of remote access options
- Out of research preview — a machine running `claude remote-control` appears as a device card in the Claude app's Code tab
### Cross-Session Messaging
- `SendMessage` between sessions on the same machine
- `notify_when_idle` — one opt-in notice when the other session next goes idle (v2.1.236)
- `ListAgents` reports the session's own name and lists live teammates (v2.1.239)
### Keyboard Customization
- Custom keybindings configuration
- Chord support for multi-key shortcuts
- Context-aware keybinding activation
### Desktop App (expanded)
- Connectors for IDE integration
- launch.json configuration
- Enterprise features and deployment
---
## 10. CLI Usage (1 file)
Command-line interface usage patterns and reference.
| File | Description | Content |
|------|-------------|---------|
| `README.md` | CLI documentation | Flags, options, and usage patterns |
**Key CLI Features**:
- `claude` - Start interactive session
- `claude -p "prompt"` - Headless/non-interactive mode
- `claude web` - Launch web session
- `claude --model` - Select model (Opus 5, Sonnet 5, Sonnet 4.6, Opus 4.8, Haiku 4.5)
- `claude --permission-mode` - Set permission mode
- `claude --remote` - Enable remote control via WebSocket
---
## Documentation Files (13 files)
| File | Location | Description |
|------|----------|-------------|
| `README.md` | `/` | Main examples overview |
| `INDEX.md` | `/` | This complete index |
| `QUICK_REFERENCE.md` | `/` | Quick reference card |
| `README.md` | `/01-slash-commands/` | Slash commands guide |
| `README.md` | `/02-memory/` | Memory guide |
| `README.md` | `/03-skills/` | Skills guide |
| `README.md` | `/04-subagents/` | Subagents guide |
| `README.md` | `/05-mcp/` | MCP guide |
| `README.md` | `/06-hooks/` | Hooks guide |
| `README.md` | `/07-plugins/` | Plugins guide |
| `README.md` | `/08-checkpoints/` | Checkpoints guide |
| `README.md` | `/09-advanced-features/` | Advanced features guide |
| `README.md` | `/10-cli/` | CLI guide |
---
## Complete File Tree
```
claude-howto/
├── README.md # Main overview
├── INDEX.md # This file
├── QUICK_REFERENCE.md # Quick reference card
├── claude_concepts_guide.md # Original guide
├── 01-slash-commands/ # Slash Commands
│ ├── optimize.md
│ ├── pr.md
│ ├── generate-api-docs.md
│ ├── commit.md
│ ├── setup-ci-cd.md
│ ├── push-all.md
│ ├── unit-test-expand.md
│ ├── doc-refactor.md
│ ├── pr-slash-command.png
│ └── README.md
├── 02-memory/ # Memory
│ ├── project-CLAUDE.md
│ ├── directory-api-CLAUDE.md
│ ├── personal-CLAUDE.md
│ ├── memory-saved.png
│ ├── memory-ask-claude.png
│ └── README.md
├── 03-skills/ # Skills
│ ├── code-review-specialist/
│ │ ├── SKILL.md
│ │ ├── scripts/
│ │ │ ├── analyze-metrics.py
│ │ │ └── compare-complexity.py
│ │ └── templates/
│ │ ├── review-checklist.md
│ │ └── finding-template.md
│ ├── brand-voice/
│ │ ├── SKILL.md
│ │ ├── templates/
│ │ │ ├── email-template.txt
│ │ │ └── social-post-template.txt
│ │ └── tone-examples.md
│ ├── doc-generator/
│ │ ├── SKILL.md
│ │ └── generate-docs.py
│ ├── refactor/
│ │ ├── SKILL.md
│ │ ├── scripts/
│ │ │ ├── analyze-complexity.py
│ │ │ └── detect-smells.py
│ │ ├── references/
│ │ │ ├── code-smells.md
│ │ │ └── refactoring-catalog.md
│ │ └── templates/
│ │ └── refactoring-plan.md
│ ├── claude-md/
│ │ └── SKILL.md
│ ├── blog-draft/
│ │ ├── SKILL.md
│ │ └── templates/
│ │ ├── draft-template.md
│ │ └── outline-template.md
│ └── README.md
├── 04-subagents/ # Subagents
│ ├── code-reviewer.md
│ ├── test-engineer.md
│ ├── documentation-writer.md
│ ├── secure-reviewer.md
│ ├── implementation-agent.md
│ ├── debugger.md
│ ├── data-scientist.md
│ ├── clean-code-reviewer.md
│ └── README.md
├── 05-mcp/ # MCP Protocol
│ ├── github-mcp.json
│ ├── database-mcp.json
│ ├── filesystem-mcp.json
│ ├── multi-mcp.json
│ └── README.md
├── 06-hooks/ # Hooks
│ ├── format-code.sh
│ ├── pre-commit.sh
│ ├── security-scan.sh
│ ├── log-bash.sh
│ ├── validate-prompt.sh
│ ├── notify-team.sh
│ ├── context-tracker.py
│ ├── context-tracker-tiktoken.py
│ └── README.md
├── 07-plugins/ # Plugins
│ ├── pr-review/
│ │ ├── .claude-plugin/
│ │ │ └── plugin.json
│ │ ├── commands/
│ │ │ ├── review-pr.md
│ │ │ ├── check-security.md
│ │ │ └── check-tests.md
│ │ ├── agents/
│ │ │ ├── security-reviewer.md
│ │ │ ├── test-checker.md
│ │ │ └── performance-analyzer.md
│ │ ├── mcp/
│ │ │ └── github-config.json
│ │ ├── hooks/
│ │ │ └── pre-review.js
│ │ └── README.md
│ ├── devops-automation/
│ │ ├── .claude-plugin/
│ │ │ └── plugin.json
│ │ ├── commands/
│ │ │ ├── deploy.md
│ │ │ ├── rollback.md
│ │ │ ├── status.md
│ │ │ └── incident.md
│ │ ├── agents/
│ │ │ ├── deployment-specialist.md
│ │ │ ├── incident-commander.md
│ │ │ └── alert-analyzer.md
│ │ ├── mcp/
│ │ │ └── kubernetes-config.json
│ │ ├── hooks/
│ │ │ ├── pre-deploy.js
│ │ │ └── post-deploy.js
│ │ ├── scripts/
│ │ │ ├── deploy.sh
│ │ │ ├── rollback.sh
│ │ │ └── health-check.sh
│ │ └── README.md
│ ├── documentation/
│ │ ├── .claude-plugin/
│ │ │ └── plugin.json
│ │ ├── commands/
│ │ │ ├── generate-api-docs.md
│ │ │ ├── generate-readme.md
│ │ │ ├── sync-docs.md
│ │ │ └── validate-docs.md
│ │ ├── agents/
│ │ │ ├── api-documenter.md
│ │ │ ├── code-commentator.md
│ │ │ └── example-generator.md
│ │ ├── mcp/
│ │ │ └── github-docs-config.json
│ │ ├── templates/
│ │ │ ├── api-endpoint.md
│ │ │ ├── function-docs.md
│ │ │ └── adr-template.md
│ │ └── README.md
│ └── README.md
├── 08-checkpoints/ # Checkpoints
│ ├── checkpoint-examples.md
│ └── README.md
├── 09-advanced-features/ # Advanced Features
│ ├── config-examples.json
│ ├── planning-mode-examples.md
│ └── README.md
└── 10-cli/ # CLI Usage
└── README.md
```
---
## Quick Start by Use Case
### Code Quality & Reviews
```bash
# Install slash command
cp 01-slash-commands/optimize.md .claude/commands/
# Install subagent
cp 04-subagents/code-reviewer.md .claude/agents/
# Install skill
cp -r 03-skills/code-review-specialist ~/.claude/skills/
# Or install complete plugin
/plugin install pr-review
```
### DevOps & Deployment
```bash
# Install plugin (includes everything)
/plugin install devops-automation
```
### Documentation
```bash
# Install slash command
cp 01-slash-commands/generate-api-docs.md .claude/commands/
# Install subagent
cp 04-subagents/documentation-writer.md .claude/agents/
# Install skill
cp -r 03-skills/doc-generator ~/.claude/skills/
# Or install complete plugin
/plugin install documentation
```
### Team Standards
```bash
# Set up project memory
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
# Edit to match your team's standards
```
### External Integrations
```bash
# Set environment variables
export GITHUB_TOKEN="your_token"
export DATABASE_URL="postgresql://..."
# Install MCP config (project scope)
cp 05-mcp/multi-mcp.json .mcp.json
```
### Automation & Validation
```bash
# Install hooks
mkdir -p ~/.claude/hooks
cp 06-hooks/*.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh
# Configure hooks in settings (~/.claude/settings.json)
# See 06-hooks/README.md
```
### Safe Experimentation
```bash
# Checkpoints are created automatically with every user prompt
# To rewind: press Esc+Esc or use /rewind
# Then choose what to restore from the rewind menu
# See 08-checkpoints/README.md for examples
```
### Advanced Workflows
```bash
# Configure advanced features
# See 09-advanced-features/config-examples.json
# Use planning mode
/plan Implement feature X
# Use permission modes
claude --permission-mode plan # For code review (read-only)
claude --permission-mode acceptEdits # Auto-accept edits
claude --permission-mode auto # Auto-approve safe actions
# Run in headless mode for CI/CD
claude -p "Run tests and report results"
# Run background tasks
Run tests in background
# See 09-advanced-features/README.md for complete guide
```
---
## Feature Coverage Matrix
| Category | Commands | Agents | MCP | Hooks | Scripts | Templates | Docs | Images | Total |
|----------|----------|--------|-----|-------|---------|-----------|------|--------|-------|
| **01 Slash Commands** | 8 | - | - | - | - | - | 1 | 1 | **10** |
| **02 Memory** | - | - | - | - | - | 3 | 1 | 2 | **6** |
| **03 Skills** | - | - | - | - | 5 | 7 | 11 | - | **23** |
| **04 Subagents** | - | 9 | - | - | - | - | 1 | - | **10** |
| **05 MCP** | - | - | 4 | - | - | - | 1 | - | **5** |
| **06 Hooks** | - | - | - | 11 | - | - | 1 | - | **12** |
| **07 Plugins** | 11 | 9 | 3 | 3 | 3 | 3 | 7 | - | **39** |
| **08 Checkpoints** | - | - | - | - | - | - | 1 | 1 | **2** |
| **09 Advanced** | - | - | - | - | 1 | 1 | 2 | - | **4** |
| **10 CLI** | - | - | - | - | - | - | 1 | - | **1** |
---
## Learning Path
### Beginner (Week 1)
1. ✅ Read `README.md`
2. ✅ Install 1-2 slash commands
3. ✅ Create project memory file
4. ✅ Try basic commands
### Intermediate (Week 2-3)
1. ✅ Set up GitHub MCP
2. ✅ Install a subagent
3. ✅ Try delegating tasks
4. ✅ Install a skill
### Advanced (Week 4+)
1. ✅ Install complete plugin
2. ✅ Create custom slash commands
3. ✅ Create custom subagent
4. ✅ Create custom skill
5. ✅ Build your own plugin
### Expert (Week 5+)
1. ✅ Set up hooks for automation
2. ✅ Use checkpoints for experimentation
3. ✅ Configure planning mode
4. ✅ Use permission modes effectively
5. ✅ Set up headless mode for CI/CD
6. ✅ Master session management
---
## Search by Keyword
### Performance
- `01-slash-commands/optimize.md` - Performance analysis
- `04-subagents/code-reviewer.md` - Performance review
- `03-skills/code-review-specialist/` - Performance metrics
- `07-plugins/pr-review/agents/performance-analyzer.md` - Performance specialist
### Security
- `04-subagents/secure-reviewer.md` - Security review
- `03-skills/code-review-specialist/` - Security analysis
- `07-plugins/pr-review/` - Security checks
### Testing
- `04-subagents/test-engineer.md` - Test engineer
- `07-plugins/pr-review/commands/check-tests.md` - Test coverage
### Documentation
- `01-slash-commands/generate-api-docs.md` - API docs command
- `04-subagents/documentation-writer.md` - Doc writer agent
- `03-skills/doc-generator/` - Doc generator skill
- `07-plugins/documentation/` - Complete doc plugin
### Deployment
- `07-plugins/devops-automation/` - Complete DevOps solution
### Automation
- `06-hooks/` - Event-driven automation
- `06-hooks/pre-commit.sh` - Pre-commit automation
- `06-hooks/format-code.sh` - Auto-formatting
- `09-advanced-features/` - Headless mode for CI/CD
### Validation
- `06-hooks/security-scan.sh` - Security validation
- `06-hooks/validate-prompt.sh` - Prompt validation
### Experimentation
- `08-checkpoints/` - Safe experimentation with rewind
- `08-checkpoints/checkpoint-examples.md` - Real-world examples
### Planning
- `09-advanced-features/planning-mode-examples.md` - Planning mode examples
- `09-advanced-features/README.md` - Extended thinking
### Configuration
- `09-advanced-features/config-examples.json` - Configuration examples
---
## Notes
- All examples are ready to use
- Modify to fit your specific needs
- Examples follow Claude Code best practices
- Each category has its own README with detailed instructions
- Scripts include proper error handling
- Templates are customizable
---
## Contributing
Want to add more examples? Follow the structure:
1. Create appropriate subdirectory
2. Include README.md with usage
3. Follow naming conventions
4. Test thoroughly
5. Update this index
---
**Last Updated**: August 25, 2026
**Claude Code Version**: 2.1.245
**Sources**:
- https://code.claude.com/docs/en/overview
- https://code.claude.com/docs/en/hooks
- https://code.claude.com/docs/en/commands
- https://code.claude.com/docs/en/permission-modes
- https://github.com/anthropics/claude-code/releases/tag/v2.1.153
- https://github.com/anthropics/claude-code/releases/tag/v2.1.154
- https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
- https://code.claude.com/docs/en/model-config
**Compatible Models**: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5
**Total Examples**: 100+ files
**Categories**: 10 features
**Hooks**: 11 automation scripts
**Configuration Examples**: 10+ scenarios
**Ready to Use**: All examples