@yeongjaeyou/claude-code-config 0.5.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +159 -129
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,146 +1,170 @@
1
1
  # Claude Code Config
2
2
 
3
- Claude Code CLI를 위한 커스텀 슬래시 커맨드, 에이전트, 스킬 모음입니다.
3
+ A collection of custom slash commands, agents, and skills for Claude Code CLI.
4
4
 
5
- ## 구조
5
+ ## Structure
6
6
 
7
7
  ```
8
8
  .claude/
9
- ├── commands/ # 슬래시 커맨드
10
- │ ├── ask-codex.md # Codex MCP로 코드 검토 요청
11
- │ ├── ask-deepwiki.md # DeepWiki로 GitHub 리포 심층 질의
12
- │ ├── ask-gemini.md # Gemini CLI로 코드 검토 요청
13
- │ ├── code-review.md # CodeRabbit 등 외부 리뷰 처리
14
- │ ├── commit-and-push.md # Git 커밋 및 푸시 자동화
15
- │ ├── edit-notebook.md # Jupyter Notebook 안전 편집
16
- │ ├── plan.md # 구현 계획 수립 (코드 작성 전)
9
+ ├── commands/ # Slash commands
10
+ │ ├── ask-codex.md # Request code review via Codex MCP
11
+ │ ├── ask-deepwiki.md # Deep query GitHub repos via DeepWiki
12
+ │ ├── ask-gemini.md # Request code review via Gemini CLI
13
+ │ ├── code-review.md # Process external code reviews (CodeRabbit, etc.)
14
+ │ ├── commit-and-push.md # Automate Git commit and push
15
+ │ ├── council.md # Consult multiple AI models (LLM Council)
16
+ │ ├── edit-notebook.md # Safely edit Jupyter Notebooks
17
+ │ ├── plan.md # Create implementation plan (before coding)
17
18
  │ ├── gh/
18
- │ │ ├── create-issue-label.md # GitHub 이슈 라벨 생성
19
- │ │ ├── decompose-issue.md # 큰 작업을 이슈로 분해
20
- │ │ ├── init-project.md # GitHub Project 보드 초기화
21
- │ │ ├── post-merge.md # PR 머지 후 정리 작업
22
- │ │ └── resolve-issue.md # GitHub 이슈 해결 워크플로우
19
+ │ │ ├── create-issue-label.md # Create GitHub issue labels
20
+ │ │ ├── decompose-issue.md # Decompose large work into issues
21
+ │ │ ├── init-project.md # Initialize GitHub Project board
22
+ │ │ ├── post-merge.md # Post-merge cleanup
23
+ │ │ └── resolve-issue.md # GitHub issue resolution workflow
23
24
  │ └── tm/
24
- │ ├── convert-prd.md # PRD 초안을 TaskMaster 형식으로 변환
25
- │ ├── post-merge.md # TaskMaster 연동 PR 머지 후 정리
26
- │ ├── resolve-issue.md # TaskMaster 기반 이슈 해결
27
- │ ├── review-prd-with-codex.md # PRD를 Codex로 검토
28
- │ └── sync-to-github.md # TaskMaster -> GitHub 동기화
29
- ├── agents/ # 커스텀 에이전트
30
- │ ├── web-researcher.md # 다중 플랫폼 웹 리서치
31
- │ ├── python-pro.md # Python 전문가
32
- │ ├── generate-llmstxt.md # llms.txt 생성
33
- │ └── langconnect-rag-expert.md # RAG 기반 문서 검색
34
- └── skills/ # 스킬 (재사용 가능한 도구 모음)
35
- └── code-explorer/ # GitHub/HuggingFace 코드 탐색
25
+ │ ├── convert-prd.md # Convert PRD draft to TaskMaster format
26
+ │ ├── post-merge.md # TaskMaster-integrated post-merge cleanup
27
+ │ ├── resolve-issue.md # TaskMaster-based issue resolution
28
+ │ ├── review-prd-with-codex.md # Review PRD with Codex
29
+ │ └── sync-to-github.md # Sync TaskMaster -> GitHub
30
+ ├── guidelines/ # Shared guidelines
31
+ │ ├── work-guidelines.md # Common work guidelines
32
+ │ └── id-reference.md # GitHub/TaskMaster ID reference
33
+ ├── agents/ # Custom agents
34
+ │ ├── web-researcher.md # Multi-platform web research
35
+ │ ├── python-pro.md # Python expert
36
+ │ ├── generate-llmstxt.md # Generate llms.txt
37
+ │ └── langconnect-rag-expert.md # RAG-based document search
38
+ └── skills/ # Skills (reusable tool collections)
39
+ ├── code-explorer/ # GitHub/HuggingFace code exploration
40
+ │ ├── SKILL.md
41
+ │ ├── scripts/
42
+ │ └── references/
43
+ ├── notion-md-uploader/ # Upload Markdown to Notion
44
+ │ ├── SKILL.md
45
+ │ ├── scripts/
46
+ │ └── references/
47
+ └── skill-creator/ # Guide for creating skills
36
48
  ├── SKILL.md
37
- ├── scripts/
38
- │ ├── search_github.py
39
- │ └── search_huggingface.py
40
- └── references/
41
- ├── github_api.md
42
- └── huggingface_api.md
49
+ └── scripts/
43
50
  ```
44
51
 
45
- ## 슬래시 커맨드
52
+ ## Slash Commands
46
53
 
47
- ### 일반 커맨드
54
+ ### General Commands
48
55
 
49
- | 커맨드 | 설명 |
50
- |--------|------|
51
- | `/plan` | 요구사항을 분석하고 코드 작성 전 구현 계획만 수립 |
52
- | `/commit-and-push` | 변경된 파일 분석 후 Conventional Commits 형식으로 커밋 및 푸시 |
53
- | `/code-review` | CodeRabbit 등 외부 코드 리뷰 결과를 분석하고 자동 수정 적용 |
54
- | `/edit-notebook` | Jupyter Notebook 파일을 NotebookEdit 도구로 안전하게 편집 |
55
- | `/ask-deepwiki` | DeepWiki MCP를 활용하여 GitHub 리포지토리에 심층 질의 |
56
- | `/ask-codex` | Codex MCP로 현재 작업 코드 검토 요청 (Claude cross-check 포함) |
57
- | `/ask-gemini` | Gemini CLI로 현재 작업 코드 검토 요청 (Claude cross-check 포함) |
56
+ | Command | Description |
57
+ |---------|-------------|
58
+ | `/plan` | Analyze requirements and create implementation plan (no coding) |
59
+ | `/commit-and-push` | Analyze changes and commit with Conventional Commits format |
60
+ | `/code-review` | Process external code review results and apply auto-fixes |
61
+ | `/edit-notebook` | Safely edit Jupyter Notebook files with NotebookEdit tool |
62
+ | `/ask-deepwiki` | Deep query GitHub repositories via DeepWiki MCP |
63
+ | `/ask-codex` | Request code review via Codex MCP (with Claude cross-check) |
64
+ | `/ask-gemini` | Request code review via Gemini CLI (with Claude cross-check) |
65
+ | `/council` | Consult multiple AI models and synthesize collective wisdom |
58
66
 
59
- ### GitHub 워크플로우 커맨드 (`/gh/`)
67
+ ### GitHub Workflow Commands (`/gh/`)
60
68
 
61
- | 커맨드 | 설명 |
62
- |--------|------|
63
- | `/gh/create-issue-label` | 프로젝트 구조 분석 후 적절한 GitHub 이슈 라벨 생성 |
64
- | `/gh/decompose-issue` | 큰 작업을 관리 가능한 독립적인 이슈들로 분해 |
65
- | `/gh/init-project` | GitHub Project 보드 초기화 및 설정 |
66
- | `/gh/post-merge` | PR 머지 후 브랜치 정리 및 CLAUDE.md 업데이트 |
67
- | `/gh/resolve-issue` | GitHub 이슈 번호를 받아 체계적으로 분석하고 해결 |
69
+ | Command | Description |
70
+ |---------|-------------|
71
+ | `/gh/create-issue-label` | Analyze project and create appropriate GitHub issue labels |
72
+ | `/gh/decompose-issue` | Decompose large work into manageable independent issues |
73
+ | `/gh/init-project` | Initialize and configure GitHub Project board |
74
+ | `/gh/post-merge` | Clean up branch and update CLAUDE.md after PR merge |
75
+ | `/gh/resolve-issue` | Systematically analyze and resolve GitHub issues |
68
76
 
69
- ### TaskMaster 연동 커맨드 (`/tm/`)
77
+ ### TaskMaster Integration Commands (`/tm/`)
70
78
 
71
- | 커맨드 | 설명 |
72
- |--------|------|
73
- | `/tm/convert-prd` | PRD 초안을 TaskMaster PRD 형식으로 변환 |
74
- | `/tm/sync-to-github` | TaskMaster tasks.json을 GitHub Issue/Milestone으로 동기화 |
75
- | `/tm/resolve-issue` | GitHub Issue를 TaskMaster subtask 단위로 체계적 해결 |
76
- | `/tm/review-prd-with-codex` | PRD를 Codex MCP로 검토하고 Claude가 cross-check |
77
- | `/tm/post-merge` | PR 머지 후 TaskMaster 상태 업데이트 및 브랜치 정리 |
79
+ | Command | Description |
80
+ |---------|-------------|
81
+ | `/tm/convert-prd` | Convert PRD draft to TaskMaster PRD format |
82
+ | `/tm/sync-to-github` | Sync TaskMaster tasks.json to GitHub Issues/Milestones |
83
+ | `/tm/resolve-issue` | Resolve GitHub Issues by TaskMaster subtask units |
84
+ | `/tm/review-prd-with-codex` | Review PRD with Codex MCP and Claude cross-check |
85
+ | `/tm/post-merge` | TaskMaster status update and branch cleanup after PR merge |
78
86
 
79
- ## 에이전트
87
+ ## Agents
80
88
 
81
- | 에이전트 | 설명 |
82
- |----------|------|
83
- | `web-researcher` | 다중 플랫폼(Reddit, GitHub, SO, HF, arXiv 등)에서 기술 리서치 수행 |
84
- | `python-pro` | Python 고급 기능(데코레이터, 제너레이터, async/await) 전문가 |
85
- | `generate-llmstxt` | 웹사이트나 로컬 디렉토리에서 llms.txt 문서 생성 |
86
- | `langconnect-rag-expert` | RAG 기반 문서 컬렉션에서 정보 검색 및 종합 |
89
+ | Agent | Description |
90
+ |-------|-------------|
91
+ | `web-researcher` | Multi-platform tech research (Reddit, GitHub, SO, HF, arXiv, etc.) |
92
+ | `python-pro` | Python advanced features expert (decorators, generators, async/await) |
93
+ | `generate-llmstxt` | Generate llms.txt documentation from websites or local directories |
94
+ | `langconnect-rag-expert` | Retrieve and synthesize information from document collections |
87
95
 
88
- ## 스킬
96
+ ## Skills
89
97
 
90
98
  ### code-explorer
91
99
 
92
- GitHub와 Hugging Face에서 코드/모델/데이터셋을 검색하고 분석하는 스킬입니다.
100
+ Search and analyze code/models/datasets on GitHub and Hugging Face.
93
101
 
94
102
  ```bash
95
- # GitHub 리포지토리 검색
103
+ # Search GitHub repositories
96
104
  python scripts/search_github.py "object detection" --limit 10
97
105
 
98
- # Hugging Face 모델/데이터셋/Spaces 검색
106
+ # Search Hugging Face models/datasets/Spaces
99
107
  python scripts/search_huggingface.py "qwen vl" --type models
100
108
  ```
101
109
 
102
- ## 설치
110
+ ### notion-md-uploader
103
111
 
104
- ### npx로 설치 (권장)
112
+ Upload Markdown files to Notion pages with full formatting support.
113
+
114
+ - Headings, lists, code blocks, images, tables, callouts, todos
115
+ - Automatic image uploads
116
+ - Preserved formatting
117
+
118
+ ### skill-creator
119
+
120
+ Guide for creating effective Claude Code skills.
121
+
122
+ - Skill structure templates
123
+ - Best practices
124
+ - Validation scripts
125
+
126
+ ## Installation
127
+
128
+ ### Install with npx (Recommended)
105
129
 
106
130
  ```bash
107
- # 현재 프로젝트에 설치
131
+ # Install to current project
108
132
  npx @yeongjaeyou/claude-code-config
109
133
 
110
- # 전역 설치 (모든 프로젝트에서 사용)
134
+ # Global install (available in all projects)
111
135
  npx @yeongjaeyou/claude-code-config --global
112
136
  ```
113
137
 
114
- ### 수동 설치
138
+ ### Manual Installation
115
139
 
116
140
  ```bash
117
- # 방법 1: 직접 복사
141
+ # Method 1: Direct copy
118
142
  git clone https://github.com/YoungjaeDev/claude-code-config.git
119
143
  cp -r claude-code-config/.claude /path/to/your/project/
120
144
 
121
- # 방법 2: 심볼릭 링크
145
+ # Method 2: Symbolic link
122
146
  ln -s /path/to/claude-code-config/.claude /path/to/your/project/.claude
123
147
  ```
124
148
 
125
- ### CLI 옵션
149
+ ### CLI Options
126
150
 
127
151
  ```bash
128
- npx @yeongjaeyou/claude-code-config [옵션]
152
+ npx @yeongjaeyou/claude-code-config [options]
129
153
 
130
- 옵션:
131
- -g, --global 전역 설치 (~/.claude/)
132
- -h, --help 도움말 출력
133
- -v, --version 버전 출력
154
+ Options:
155
+ -g, --global Global install (~/.claude/)
156
+ -h, --help Show help
157
+ -v, --version Show version
134
158
  ```
135
159
 
136
- ## MCP 서버 설정
160
+ ## MCP Server Configuration
137
161
 
138
- 패키지에 포함된 `.mcp.json`을 프로젝트 루트에 복사하여 사용할 수 있습니다.
162
+ The package includes `.mcp.json` that can be copied to your project root.
139
163
 
140
- ### 전제조건
164
+ ### Prerequisites
141
165
 
142
- - **Node.js**: npx 명령어 사용
143
- - **Python uv**: [uv 설치](https://docs.astral.sh/uv/getting-started/installation/)
166
+ - **Node.js**: For npx command
167
+ - **Python uv**: [Install uv](https://docs.astral.sh/uv/getting-started/installation/)
144
168
  ```bash
145
169
  # macOS/Linux
146
170
  curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -149,68 +173,74 @@ npx @yeongjaeyou/claude-code-config [옵션]
149
173
  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
150
174
  ```
151
175
 
152
- ### 포함된 MCP 서버
176
+ ### Included MCP Servers
153
177
 
154
- | 서버 | 설명 | API 키 |
155
- |------|------|--------|
156
- | mcpdocs | Claude Code, Cursor 문서 검색 (mcp-cache 래퍼) | 불필요 |
157
- | deepwiki | GitHub 리포지토리 문서화 질의 | 불필요 |
158
- | serena | LSP 기반 코드 분석 도구 | 불필요 |
178
+ | Server | Description | API Key |
179
+ |--------|-------------|---------|
180
+ | mcpdocs | Claude Code, Cursor docs search (mcp-cache wrapper) | Not required |
181
+ | deepwiki | GitHub repository documentation query | Not required |
182
+ | serena | LSP-based code analysis tool | Not required |
159
183
 
160
- ### 사용 방법
184
+ ### Usage
161
185
 
162
186
  ```bash
163
- # .mcp.json 복사
187
+ # Copy .mcp.json
164
188
  cp node_modules/@yeongjaeyou/claude-code-config/.mcp.json .
165
189
 
166
- # 또는 기존 .mcp.json이 있는 경우 내용 병합
190
+ # Or merge contents if you have existing .mcp.json
167
191
  ```
168
192
 
169
- > **참고**: 자체 `.mcp.json`이 있는 경우 `mcpServers` 객체를 수동으로 병합하세요.
170
-
171
- ## 사용법
193
+ > **Note**: If you have your own `.mcp.json`, manually merge the `mcpServers` object.
172
194
 
173
- ### 실행 예시
195
+ ## Usage Examples
174
196
 
175
197
  ```bash
176
- # 구현 계획 수립
177
- /plan 새로운 인증 시스템 구현
198
+ # Create implementation plan
199
+ /plan implement new authentication system
178
200
 
179
- # 커밋 및 푸시
201
+ # Commit and push
180
202
  /commit-and-push src/auth.ts src/utils.ts
181
203
 
182
- # GitHub 이슈 해결
204
+ # Resolve GitHub issue
183
205
  /gh/resolve-issue 42
206
+
207
+ # Consult AI council
208
+ /council "Should we use REST or GraphQL for this API?"
184
209
  ```
185
210
 
186
- ## 주요 기능
211
+ ## Key Features
212
+
213
+ ### `/plan` - Implementation Planning
214
+ - Understand requirements intent (ask questions if unclear)
215
+ - Investigate and understand relevant codebase
216
+ - Create step-by-step execution plan
217
+ - **No immediate coding - plan only**
187
218
 
188
- ### `/plan` - 구현 계획 수립
189
- - 요구사항의 의도를 파악하고 불명확하면 질문
190
- - 관련 코드베이스를 조사하고 이해
191
- - 단계별 실행 계획 작성
192
- - **바로 코드를 작성하지 않고 계획만 수립**
219
+ ### `/commit-and-push` - Git Automation
220
+ - Follow Conventional Commits format (feat, fix, refactor, docs, etc.)
221
+ - Analyze changes and generate appropriate commit message
222
+ - Selectively commit specified files only
193
223
 
194
- ### `/commit-and-push` - Git 자동화
195
- - Conventional Commits 형식 준수 (feat, fix, refactor, docs 등)
196
- - 변경 내용 분석 후 적절한 커밋 메시지 생성
197
- - 지정된 파일만 선택적으로 커밋
224
+ ### `/edit-notebook` - Jupyter Notebook Editing
225
+ - Use only `NotebookEdit` tool (protect JSON structure)
226
+ - Track cell_id for correct insertion order
227
+ - Include source format issue resolution guide
198
228
 
199
- ### `/edit-notebook` - Jupyter Notebook 편집
200
- - `NotebookEdit` 도구만 사용 (JSON 구조 보호)
201
- - 셀 삽입 순서 보장을 위한 cell_id 추적
202
- - source 형식 문제 해결 가이드 포함
229
+ ### `/council` - LLM Council
230
+ - Query multiple AI models (Opus, Sonnet, Codex, Gemini) in parallel
231
+ - Anonymize responses for unbiased evaluation
232
+ - Synthesize collective wisdom into consensus
203
233
 
204
- ### `web-researcher` 에이전트
205
- - GitHub(`gh` CLI), Hugging Face(`huggingface_hub`), Reddit, SO, arXiv 등 다중 플랫폼 검색
206
- - Context7/DeepWiki를 통한 공식 문서 수집
207
- - 한글 리서치 리포트 자동 생성
234
+ ### `web-researcher` Agent
235
+ - Multi-platform search: GitHub (`gh` CLI), Hugging Face, Reddit, SO, arXiv
236
+ - Official documentation via Context7/DeepWiki
237
+ - Auto-generate research reports
208
238
 
209
- ### `code-explorer` 스킬
210
- - `gh` CLI를 활용한 GitHub 리포지토리/코드 검색
211
- - `huggingface_hub` API를 활용한 모델/데이터셋/Spaces 검색
212
- - 임시 디렉토리(`/tmp/`)에 소스 코드 다운로드 및 분석
239
+ ### `code-explorer` Skill
240
+ - GitHub repository/code search via `gh` CLI
241
+ - Hugging Face model/dataset/Spaces search via `huggingface_hub` API
242
+ - Download and analyze source code in temp directory (`/tmp/`)
213
243
 
214
- ## 라이선스
244
+ ## License
215
245
 
216
246
  MIT License
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yeongjaeyou/claude-code-config",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
4
4
  "description": "Claude Code CLI custom commands, agents, and skills",
5
5
  "bin": {
6
6
  "claude-code-config": "./bin/cli.js"