@yeongjaeyou/claude-code-config

Claude Code Config

A collection of custom slash commands, agents, and skills for Claude Code CLI.

Structure

.claude/
├── commands/                    # Slash commands
│   ├── ask-codex.md             # Request code review via Codex MCP
│   ├── ask-deepwiki.md          # Deep query GitHub repos via DeepWiki
│   ├── ask-gemini.md            # Request code review via Gemini CLI
│   ├── code-review.md           # Process external code reviews (CodeRabbit, etc.)
│   ├── commit-and-push.md       # Automate Git commit and push
│   ├── council.md               # Consult multiple AI models (LLM Council)
│   ├── edit-notebook.md         # Safely edit Jupyter Notebooks
│   ├── generate-llmstxt.md      # Generate llms.txt from URL or directory
│   ├── gh/
│   │   ├── create-issue-label.md  # Create GitHub issue labels
│   │   ├── decompose-issue.md     # Decompose large work into issues
│   │   ├── init-project.md        # Initialize GitHub Project board
│   │   ├── post-merge.md          # Post-merge cleanup
│   │   └── resolve-issue.md       # GitHub issue resolution workflow
│   └── tm/
│       ├── convert-prd.md         # Convert PRD draft to TaskMaster format
│       ├── post-merge.md          # TaskMaster-integrated post-merge cleanup
│       ├── resolve-issue.md       # TaskMaster-based issue resolution
│       └── sync-to-github.md      # Sync TaskMaster -> GitHub
├── guidelines/                  # Shared guidelines
│   ├── work-guidelines.md       # Common work guidelines
│   ├── id-reference.md          # GitHub/TaskMaster ID reference
│   ├── cv-guidelines.md         # Computer vision guidelines
│   └── prd-guide.md             # PRD template for TaskMaster
├── agents/                      # Custom agents
│   ├── web-researcher.md        # Multi-platform web research
│   └── python-pro.md            # Python expert
└── skills/                      # Skills (reusable tool collections)
    ├── code-explorer/           # GitHub/HuggingFace code exploration
    │   ├── SKILL.md
    │   ├── scripts/
    │   └── references/
    ├── feature-implementer/     # TDD-based feature planning
    │   ├── SKILL.md
    │   └── plan-template.md
    ├── notion-md-uploader/      # Upload Markdown to Notion
    │   ├── SKILL.md
    │   ├── scripts/
    │   └── references/
    └── skill-creator/           # Guide for creating skills
        ├── SKILL.md
        └── scripts/

Slash Commands

General Commands

Command	Description
/commit-and-push	Analyze changes and commit with Conventional Commits format
/code-review	Process external code review results and apply auto-fixes
/edit-notebook	Safely edit Jupyter Notebook files with NotebookEdit tool
/generate-llmstxt	Generate llms.txt from URL or local directory
/ask-deepwiki	Deep query GitHub repositories via DeepWiki MCP
/ask-codex	Request code review via Codex MCP (with Claude cross-check)
/ask-gemini	Request code review via Gemini CLI (with Claude cross-check)
/council	Consult multiple AI models with multi-round deliberation

GitHub Workflow Commands (/gh/)

Command	Description
/gh/create-issue-label	Analyze project and create appropriate GitHub issue labels
/gh/decompose-issue	Decompose large work into manageable independent issues
/gh/init-project	Initialize and configure GitHub Project board
/gh/post-merge	Clean up branch and update config files (CLAUDE.md, AGENTS.md, GEMINI.md) after PR merge
/gh/resolve-issue	Systematically analyze and resolve GitHub issues

TaskMaster Integration Commands (/tm/)

Command	Description
/tm/convert-prd	Convert PRD draft to TaskMaster PRD format
/tm/sync-to-github	Sync TaskMaster tasks.json to GitHub Issues/Milestones
/tm/resolve-issue	Resolve GitHub Issues by TaskMaster subtask units
/tm/post-merge	TaskMaster status update, config file updates, and branch cleanup after PR merge

Agents

Agent	Description
web-researcher	Multi-platform tech research with opus model (Reddit, GitHub, HF, arXiv, etc.)
python-pro	Python expert with opus model (decorators, generators, async/await, optimization)

Skills

code-explorer

Search and analyze code/models/datasets on GitHub and Hugging Face.

# Search GitHub repositories
python scripts/search_github.py "object detection" --limit 10

# Search Hugging Face models/datasets/Spaces
python scripts/search_huggingface.py "qwen vl" --type models

feature-implementer

TDD-based feature planning with quality gates.

• Phase-based plans with 1-4 hour increments
• Test-First Development (Red-Green-Refactor)
• Quality gates before each phase transition
• Risk assessment and rollback strategies

notion-md-uploader

Upload Markdown files to Notion pages with full formatting support.

• Headings, lists, code blocks, images, tables, callouts, todos
• Automatic image uploads
• Preserved formatting

skill-creator

Guide for creating effective Claude Code skills.

• Skill structure templates
• Best practices
• Validation scripts

Installation

Install with npx (Recommended)

# Install to current project
npx @yeongjaeyou/claude-code-config

# Global install (available in all projects)
npx @yeongjaeyou/claude-code-config --global

Manual Installation

# Method 1: Direct copy
git clone https://github.com/YoungjaeDev/claude-code-config.git
cp -r claude-code-config/.claude /path/to/your/project/

# Method 2: Symbolic link
ln -s /path/to/claude-code-config/.claude /path/to/your/project/.claude

CLI Options

npx @yeongjaeyou/claude-code-config [options]

Options:
  -g, --global   Global install (~/.claude/)
  -h, --help     Show help
  -v, --version  Show version

Installation Modes

When existing folders are detected, you'll be prompted to choose:

Mode	Behavior
update (default)	Overwrite existing files, add new files, keep custom files
merge	Add new files only, skip existing files

• update: Recommended when upgrading to a new version
• merge: Safe when you have heavily customized files you don't want changed

MCP Server Configuration

The package includes .mcp.json that can be copied to your project root.

Prerequisites

• Node.js: For npx command
• Python uv: Install uv

  # macOS/Linux
  curl -LsSf https://astral.sh/uv/install.sh | sh
  
  # Windows
  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  

Included MCP Servers

Server	Description	API Key
mcpdocs	Claude Code, Cursor docs search (mcp-cache wrapper)	Not required
deepwiki	GitHub repository documentation query	Not required
serena	LSP-based code analysis tool	Not required

Usage

# Copy .mcp.json
cp node_modules/@yeongjaeyou/claude-code-config/.mcp.json .

# Or merge contents if you have existing .mcp.json

Note: If you have your own .mcp.json, manually merge the mcpServers object.

Usage Examples

# Generate llms.txt from website
/generate-llmstxt https://docs.example.com

# Commit and push
/commit-and-push src/auth.ts src/utils.ts

# Resolve GitHub issue
/gh/resolve-issue 42

# Consult AI council
/council "Should we use REST or GraphQL for this API?"

Key Features

/generate-llmstxt - LLM Documentation

• Generate llms.txt from URL or local directory
• Use Firecrawl MCP for web scraping
• Organize content into logical sections

/commit-and-push - Git Automation

• Follow Conventional Commits format (feat, fix, refactor, docs, etc.)
• Analyze changes and generate appropriate commit message
• Selectively commit specified files only

/edit-notebook - Jupyter Notebook Editing

• Use only NotebookEdit tool (protect JSON structure)
• Track cell_id for correct insertion order
• Include source format issue resolution guide

/council - LLM Council

• Query multiple AI models (Opus, Sonnet, Codex, Gemini) in parallel
• Multi-round deliberation with gap analysis and conflict resolution
• Anonymize responses for unbiased evaluation
• Convergence-based termination (confidence > 0.9, consensus reached)
• Use --quick flag for faster single-round responses

web-researcher Agent

• Multi-platform search: GitHub (gh CLI), Hugging Face, Reddit, SO, arXiv
• Official documentation via Context7/DeepWiki
• Auto-generate research reports

feature-implementer Skill

• TDD-based feature planning with quality gates
• Phase-based delivery (1-4 hours per phase)
• Risk assessment and rollback strategies

code-explorer Skill

• GitHub repository/code search via gh CLI
• Hugging Face model/dataset/Spaces search via huggingface_hub API
• Download and analyze source code in temp directory (/tmp/)

Notification Hooks

Desktop notifications for Claude Code events using OSC escape sequences.

Quick Setup

# 1. Install Terminal Notification extension in VSCode
# 2. Global install includes notify_osc.sh and auto-registers hooks
npx @yeongjaeyou/claude-code-config --global

Supported Events

Event	Description
Stop	Task completion
Notification	Permission requests, idle prompts

See docs/notification-setup.md for detailed setup guide.

License

MIT License