https://github.com/wasabeef/claude-code-cookbook
A collection of settings to make Claude Code more useful.
https://github.com/wasabeef/claude-code-cookbook
claude-code
Last synced: 2 months ago
JSON representation
A collection of settings to make Claude Code more useful.
- Host: GitHub
- URL: https://github.com/wasabeef/claude-code-cookbook
- Owner: wasabeef
- Created: 2025-07-17T16:04:29.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-04-14T10:57:50.000Z (2 months ago)
- Last Synced: 2026-04-14T12:26:14.771Z (2 months ago)
- Topics: claude-code
- Language: Shell
- Homepage:
- Size: 3.53 MB
- Stars: 1,060
- Watchers: 9
- Forks: 111
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
- awesome-claude-code - claude-code-cookbook - code-cookbook) | 使 Claude Code 更便捷的配置集合 | 配置食谱| (指南与文档)
README
# Claude Code Cookbook
A collection of commands, roles, and automation scripts for [Claude Code](https://docs.claude.com/).
**Automate your workflow without unnecessary confirmations**, allowing you to focus on what matters. Claude Code judges and executes common tasks like code fixes, test runs, and documentation updates.
**Read in your language**: [🇯🇵 日本語](plugins/ja/README.md) · [🇺🇸 English](plugins/en/README.md) · [🇰🇷 한국어](plugins/ko/README.md) · [🇨🇳 简体中文](plugins/zh-cn/README.md) · [🇹🇼 繁體中文](plugins/zh-tw/README.md) · [🇪🇸 Español](plugins/es/README.md) · [🇫🇷 Français](plugins/fr/README.md) · [🇧🇷 Português](plugins/pt/README.md)
## What is Claude Code Cookbook?
Claude Code Cookbook provides a plugin system that extends Claude Code with:
- **Commands**: Custom slash commands for common development tasks
- **Roles**: Expert role presets for specialized assistance
- **Hooks**: Automated scripts that trigger at specific events
## Key Features
### Commands
39 slash commands organized by category. Execute by typing `/` followed by the command name.
#### Pull Request Management
| Command | Description |
| :---------------- | :----------------------------------------------------------------------------------- |
| `/pr-list` | Display prioritized list of open PRs in current repository |
| `/pr-issue` | Display prioritized list of open Issues in current repository |
| `/pr-create` | Auto-generate PR from Git changes with detailed description and optimal branch setup |
| `/pr-review` | Systematic code quality and architecture review for Pull Requests |
| `/pr-fix` | Efficiently respond to PR review comments with 3-stage error analysis |
| `/pr-auto-update` | Automatically update PR description and labels based on changes |
#### Code Quality & Refactoring
| Command | Description |
| :---------------------- | :------------------------------------------------------------------- |
| `/refactor` | Safe, step-by-step code refactoring with SOLID principles evaluation |
| `/smart-review` | Advanced code review to improve quality |
| `/tech-debt` | Analyze technical debt and create prioritized improvement plans |
| `/analyze-dependencies` | Analyze project dependencies and visualize circular dependencies |
| `/analyze-performance` | Analyze application performance issues and propose improvements |
| `/design-patterns` | Propose and review implementations based on design patterns |
#### Development Tools
| Command | Description |
| :----------------- | :---------------------------------------------------------------------- |
| `/fix-error` | Suggest code fixes based on error messages |
| `/explain-code` | Clearly explain functionality and logic of selected code |
| `/commit-message` | Generate commit messages based on changes |
| `/semantic-commit` | Split large changes into meaningful units with semantic commit messages |
| `/pr-checks` | Monitor GitHub Actions CI status and track until completion |
| `/screenshot` | Capture and analyze screen screenshots |
#### Planning & Analysis
| Command | Description |
| :--------------------- | :---------------------------------------------------------------------------- |
| `/plan` | Activate planning mode and formulate detailed implementation strategies |
| `/spec` | Create detailed specifications from requirements (spec-driven development) |
| `/ultrathink` | Execute structured thinking process for complex issues |
| `/check-fact` | Verify information accuracy by referencing codebase and documentation |
| `/sequential-thinking` | Think through complex problems step-by-step using Sequential Thinking MCP |
| `/task` | Launch specialized agents for autonomous search, research, and analysis tasks |
#### Dependency Management
| Command | Description |
| :--------------------- | :--------------------------------------------- |
| `/update-node-deps` | Safely update dependencies in Node.js projects |
| `/update-flutter-deps` | Safely update dependencies in Flutter projects |
| `/update-rust-deps` | Safely update dependencies in Rust projects |
**See your language plugin for the complete list of 39 commands with detailed documentation.**
### Roles
Switch Claude to expert roles for specialized assistance. Each role can run **independently as a sub-agent** using the `--agent` option for parallel execution without interfering with main context.
| Role | Description |
| :------------ | :------------------------------------------------------- |
| `security` | Security vulnerability analysis and threat detection |
| `architect` | Software architecture design and system design patterns |
| `frontend` | UI/UX optimization and frontend best practices |
| `backend` | API design, microservices, and cloud-native architecture |
| `performance` | Performance optimization for speed and memory |
| `qa` | Test planning and quality assurance strategies |
| `mobile` | iOS/Android development and mobile-first design |
| `reviewer` | Code review focusing on readability and maintainability |
| `analyzer` | System analysis and root cause analysis |
#### Usage Examples
```bash
# Normal mode (execute in main context)
/cook:role security
"Review this authentication system for vulnerabilities"
# Sub-agent mode (execute in independent context)
/cook:role security --agent
"Perform comprehensive security audit of entire project"
# Multiple roles in parallel
/cook:multi-role security,performance --agent
"Analyze system's security and performance comprehensively"
```
### Hooks
Automate development workflow with event-triggered scripts configured in `settings.json`:
| Hook Script | Event | Description |
| :----------------------------- | :--------------------------- | :---------------------------------------------------------- |
| `preserve-file-permissions.sh` | `PreToolUse` / `PostToolUse` | Save and restore file permissions to prevent unintended changes |
## Development Workflow
Typical development flow using Claude Code Cookbook commands:
```mermaid
flowchart TB
Start([Task Confirmation]) --> PRList["/cook:pr-list
Open PR List"]
Start --> PRIssue["/cook:pr-issue
Open Issue List"]
PRList --> TaskType{Type?}
PRIssue --> TaskType
TaskType -->|New Feature| Plan["/cook:spec
Requirements & Design"]
TaskType -->|Bug Fix| Fix["/cook:fix-error
Error Analysis"]
TaskType -->|Refactoring| Refactor["/cook:refactor
Improvement"]
TaskType -->|Review| Review["/cook:pr-review
Review"]
Plan --> Design["/cook:role architect
/cook:role-debate
Design Consultation"]
Design --> Implementation[Implementation & Testing]
Fix --> Implementation
Refactor --> Implementation
Review --> Implementation
Implementation --> Check["/cook:smart-review
Quality Check"]
Check --> Commit["/cook:semantic-commit
Commit by Purpose"]
Commit --> PR["/cook:pr-create
Auto PR Creation"]
PR --> CI["/cook:pr-checks
CI Status Check"]
CI --> Status{Issues?}
Status -->|Yes| Feedback["Fix Response
/cook:pr-fix
/cook:fix-error"]
Status -->|No| End([Complete])
Feedback --> Implementation
classDef commandBox fill:#e0f2fe,stroke:#0369a1,stroke-width:2px,rx:5,ry:5,color:#0c4a6e
classDef processBox fill:#f0f9ff,stroke:#0ea5e9,stroke-width:1px,rx:5,ry:5,color:#075985
classDef decisionBox fill:#fef3c7,stroke:#f59e0b,stroke-width:2px,rx:5,ry:5,color:#78350f
classDef startEnd fill:#86efac,stroke:#22c55e,stroke-width:2px,rx:20,ry:20,color:#14532d
class PRList,PRIssue,Plan,Fix,Refactor,Review,Design,Check,CI,Commit,PR,Feedback commandBox
class Implementation processBox
class TaskType,Status decisionBox
class Start,End startEnd
```
## Installation
### Step 1: Add the Marketplace
First, add this repository as a plugin marketplace in Claude Code:
```bash
/plugin marketplace add wasabeef/claude-code-cookbook
```
### Step 2: Install Your Language Plugin
Choose and install your preferred language plugin:
| Language | Plugin Name | Install Command |
| :--------------- | :----------------------------- | :------------------------------------------------ |
| 🇯🇵 **日本語** | [plugins/ja](plugins/ja) | `/plugin install cook@claude-code-cookbook` |
| 🇺🇸 **English** | [plugins/en](plugins/en) | `/plugin install cook-en@claude-code-cookbook` |
| 🇰🇷 **한국어** | [plugins/ko](plugins/ko) | `/plugin install cook-ko@claude-code-cookbook` |
| 🇨🇳 **简体中文** | [plugins/zh-cn](plugins/zh-cn) | `/plugin install cook-zh-cn@claude-code-cookbook` |
| 🇹🇼 **繁體中文** | [plugins/zh-tw](plugins/zh-tw) | `/plugin install cook-zh-tw@claude-code-cookbook` |
| 🇪🇸 **Español** | [plugins/es](plugins/es) | `/plugin install cook-es@claude-code-cookbook` |
| 🇫🇷 **Français** | [plugins/fr](plugins/fr) | `/plugin install cook-fr@claude-code-cookbook` |
| 🇧🇷 **Português** | [plugins/pt](plugins/pt) | `/plugin install cook-pt@claude-code-cookbook` |
Each plugin includes:
- Full command documentation in the native language
- Role definitions optimized for that language
- Language-specific customization examples
### Quick Start
After installation, commands and agents are invoked with a plugin-specific prefix:
```bash
# Commands (example with Japanese plugin)
/cook:pr-create
/cook:semantic-commit
/cook:check-fact
# Agents
@agent-cook:frontend
/cook:role security
# Explore available commands
/cook:
```
**Note**: The plugin name is automatically added as a prefix to prevent namespace conflicts when multiple language plugins are installed.
## Why Claude Code Cookbook?
- **Multilingual**: 8 language plugins with native translations
- **Production-ready**: Battle-tested commands and roles
- **Comprehensive**: 39 commands covering entire development workflow
- **Extensible**: Easy to add your own commands and roles
- **Safe**: Built-in safety hooks prevent dangerous operations
- **Efficient**: Reduce repetitive tasks and context switching
- **Open Source**: Apache 2.0 licensed
## Example Workflow
```bash
# 1. Check current tasks
/cook:pr-list
# 2. Plan new feature
/cook:spec
/cook:role architect
# 3. Implement with quality checks
# ... write code ...
/cook:smart-review
# 4. Commit changes logically
/cook:semantic-commit
# 5. Create PR automatically
/cook:pr-create
# 6. Monitor CI and respond to feedback
/cook:pr-checks
/cook:pr-fix
```