@yeongjaeyou/claude-code-config 0.1.0

package/.claude/skills/code-explorer/scripts/search_huggingface.py

@@ -0,0 +1,306 @@
+#!/usr/bin/env python3
+"""
+Hugging Face Search Script
+
+Search Models, Datasets, and Spaces on Hugging Face Hub.
+Requires: huggingface_hub library (pip install huggingface_hub)
+
+Usage:
+    python search_huggingface.py "keyword" --type {models,datasets,spaces,all}
+
+Examples:
+    python search_huggingface.py "object detection" --type models --limit 10
+    python search_huggingface.py "coco" --type datasets --limit 5
+    python search_huggingface.py "gradio demo" --type spaces --limit 10
+    python search_huggingface.py "segment anything" --type all
+"""
+
+import argparse
+import json
+import sys
+from typing import Optional
+
+try:
+    from huggingface_hub import HfApi, list_models, list_datasets, list_spaces
+    HF_AVAILABLE = True
+except ImportError:
+    HF_AVAILABLE = False
+
+
+def search_models(
+    query: str,
+    limit: int = 10,
+    task: Optional[str] = None,
+    library: Optional[str] = None
+) -> list[dict]:
+    """
+    Search Hugging Face models.
+
+    Args:
+        query: Search keyword
+        limit: Maximum number of results
+        task: Filter by task (e.g., 'object-detection', 'image-segmentation')
+        library: Filter by library (e.g., 'transformers', 'diffusers')
+
+    Returns:
+        List of model information dictionaries
+    """
+    api = HfApi()
+
+    kwargs = {
+        "search": query,
+        "limit": limit,
+        "sort": "downloads",
+        "direction": -1,  # Descending
+    }
+
+    if task:
+        kwargs["task"] = task
+    if library:
+        kwargs["library"] = library
+
+    try:
+        models = list(api.list_models(**kwargs))
+        return [
+            {
+                "id": m.id,
+                "author": m.author,
+                "downloads": m.downloads,
+                "likes": m.likes,
+                "task": m.pipeline_tag,
+                "library": m.library_name,
+                "tags": m.tags[:10] if m.tags else [],
+                "url": f"https://huggingface.co/{m.id}",
+                "last_modified": str(m.last_modified) if m.last_modified else None,
+            }
+            for m in models
+        ]
+    except Exception as e:
+        print(f"Error searching models: {e}", file=sys.stderr)
+        return []
+
+
+def search_datasets(
+    query: str,
+    limit: int = 10,
+    task: Optional[str] = None
+) -> list[dict]:
+    """
+    Search Hugging Face datasets.
+
+    Args:
+        query: Search keyword
+        limit: Maximum number of results
+        task: Filter by task category
+
+    Returns:
+        List of dataset information dictionaries
+    """
+    api = HfApi()
+
+    kwargs = {
+        "search": query,
+        "limit": limit,
+        "sort": "downloads",
+        "direction": -1,
+    }
+
+    if task:
+        kwargs["task_categories"] = task
+
+    try:
+        datasets = list(api.list_datasets(**kwargs))
+        return [
+            {
+                "id": d.id,
+                "author": d.author,
+                "downloads": d.downloads,
+                "likes": d.likes,
+                "tags": d.tags[:10] if d.tags else [],
+                "url": f"https://huggingface.co/datasets/{d.id}",
+                "last_modified": str(d.last_modified) if d.last_modified else None,
+            }
+            for d in datasets
+        ]
+    except Exception as e:
+        print(f"Error searching datasets: {e}", file=sys.stderr)
+        return []
+
+
+def search_spaces(
+    query: str,
+    limit: int = 10,
+    sdk: Optional[str] = None
+) -> list[dict]:
+    """
+    Search Hugging Face Spaces.
+
+    Args:
+        query: Search keyword
+        limit: Maximum number of results
+        sdk: Filter by SDK ('gradio', 'streamlit', 'docker', 'static')
+
+    Returns:
+        List of space information dictionaries
+    """
+    api = HfApi()
+
+    kwargs = {
+        "search": query,
+        "limit": limit,
+        "sort": "likes",
+        "direction": -1,
+    }
+
+    if sdk:
+        kwargs["sdk"] = sdk
+
+    try:
+        spaces = list(api.list_spaces(**kwargs))
+        return [
+            {
+                "id": s.id,
+                "author": s.author,
+                "likes": s.likes,
+                "sdk": s.sdk,
+                "tags": s.tags[:10] if s.tags else [],
+                "url": f"https://huggingface.co/spaces/{s.id}",
+                "last_modified": str(s.last_modified) if s.last_modified else None,
+            }
+            for s in spaces
+        ]
+    except Exception as e:
+        print(f"Error searching spaces: {e}", file=sys.stderr)
+        return []
+
+
+def format_model(model: dict, index: int) -> str:
+    """Format model info as a summary string."""
+    return (
+        f"\n[{index}] MODEL: {model['id']}\n"
+        f"    Downloads: {model['downloads']:,} | Likes: {model['likes']:,}\n"
+        f"    Task: {model['task'] or 'N/A'} | Library: {model['library'] or 'N/A'}\n"
+        f"    Tags: {', '.join(model['tags'][:5]) if model['tags'] else 'None'}\n"
+        f"    URL: {model['url']}\n"
+    )
+
+
+def format_dataset(dataset: dict, index: int) -> str:
+    """Format dataset info as a summary string."""
+    return (
+        f"\n[{index}] DATASET: {dataset['id']}\n"
+        f"    Downloads: {dataset['downloads']:,} | Likes: {dataset['likes']:,}\n"
+        f"    Tags: {', '.join(dataset['tags'][:5]) if dataset['tags'] else 'None'}\n"
+        f"    URL: {dataset['url']}\n"
+    )
+
+
+def format_space(space: dict, index: int) -> str:
+    """Format space info as a summary string."""
+    return (
+        f"\n[{index}] SPACE: {space['id']}\n"
+        f"    Likes: {space['likes']:,} | SDK: {space['sdk'] or 'N/A'}\n"
+        f"    Tags: {', '.join(space['tags'][:5]) if space['tags'] else 'None'}\n"
+        f"    URL: {space['url']}\n"
+    )
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Search Hugging Face Hub (Models, Datasets, Spaces)",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  %(prog)s "object detection" --type models --limit 10
+  %(prog)s "coco" --type datasets --limit 5
+  %(prog)s "gradio demo" --type spaces --limit 10
+  %(prog)s "segment anything" --type all
+
+Tasks (for --task filter):
+  Models: object-detection, image-segmentation, image-classification, etc.
+  Datasets: object-detection, image-classification, etc.
+
+SDKs (for --sdk filter):
+  gradio, streamlit, docker, static
+        """
+    )
+
+    parser.add_argument("query", help="Search keyword")
+    parser.add_argument("--type", "-t", choices=["models", "datasets", "spaces", "all"], default="all", help="Resource type to search (default: all)")
+    parser.add_argument("--limit", "-n", type=int, default=10, help="Number of results per type (default: 10)")
+    parser.add_argument("--task", help="Filter by task (models/datasets only)")
+    parser.add_argument("--library", help="Filter by library (models only)")
+    parser.add_argument("--sdk", help="Filter by SDK (spaces only): gradio, streamlit, docker, static")
+    parser.add_argument("--json", "-j", action="store_true", help="Output as JSON")
+
+    args = parser.parse_args()
+
+    # Check huggingface_hub
+    if not HF_AVAILABLE:
+        print("Error: huggingface_hub is not installed.", file=sys.stderr)
+        print("Install: pip install huggingface_hub", file=sys.stderr)
+        sys.exit(1)
+
+    results = {}
+
+    # Search based on type
+    if args.type in ["models", "all"]:
+        print(f"Searching Models for: '{args.query}'...", file=sys.stderr)
+        results["models"] = search_models(
+            query=args.query,
+            limit=args.limit,
+            task=args.task,
+            library=args.library
+        )
+
+    if args.type in ["datasets", "all"]:
+        print(f"Searching Datasets for: '{args.query}'...", file=sys.stderr)
+        results["datasets"] = search_datasets(
+            query=args.query,
+            limit=args.limit,
+            task=args.task
+        )
+
+    if args.type in ["spaces", "all"]:
+        print(f"Searching Spaces for: '{args.query}'...", file=sys.stderr)
+        results["spaces"] = search_spaces(
+            query=args.query,
+            limit=args.limit,
+            sdk=args.sdk
+        )
+
+    # Output results
+    if args.json:
+        print(json.dumps(results, indent=2, default=str))
+    else:
+        print(f"\n{'='*60}")
+        print(f"Hugging Face Search Results for: '{args.query}'")
+        print(f"{'='*60}")
+
+        if "models" in results:
+            print(f"\n--- MODELS ({len(results['models'])} found) ---")
+            if results["models"]:
+                for i, model in enumerate(results["models"], 1):
+                    print(format_model(model, i))
+            else:
+                print("  No models found.")
+
+        if "datasets" in results:
+            print(f"\n--- DATASETS ({len(results['datasets'])} found) ---")
+            if results["datasets"]:
+                for i, dataset in enumerate(results["datasets"], 1):
+                    print(format_dataset(dataset, i))
+            else:
+                print("  No datasets found.")
+
+        if "spaces" in results:
+            print(f"\n--- SPACES ({len(results['spaces'])} found) ---")
+            if results["spaces"]:
+                for i, space in enumerate(results["spaces"], 1):
+                    print(format_space(space, i))
+            else:
+                print("  No spaces found.")
+
+
+if __name__ == "__main__":
+    main()

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 YoungjaeDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+# Claude Code Config
+
+Claude Code CLI를 위한 커스텀 슬래시 커맨드, 에이전트, 스킬 모음입니다.
+
+## 구조
+
+```
+.claude/
+├── commands/                    # 슬래시 커맨드
+│   ├── ask-deepwiki.md          # DeepWiki로 GitHub 리포 심층 질의
+│   ├── code-review.md           # CodeRabbit 등 외부 리뷰 처리
+│   ├── commit-and-push.md       # Git 커밋 및 푸시 자동화
+│   ├── edit-notebook.md         # Jupyter Notebook 안전 편집
+│   ├── plan.md                  # 구현 계획 수립 (코드 작성 전)
+│   └── gh/
+│       ├── create-issue-label.md  # GitHub 이슈 라벨 생성
+│       ├── decompose-issue.md     # 큰 작업을 이슈로 분해
+│       ├── post-merge.md          # PR 머지 후 정리 작업
+│       └── resolve-issue.md       # GitHub 이슈 해결 워크플로우
+├── agents/                      # 커스텀 에이전트
+│   ├── web-researcher.md        # 다중 플랫폼 웹 리서치
+│   ├── python-pro.md            # Python 전문가
+│   ├── generate-llmstxt.md      # llms.txt 생성
+│   └── langconnect-rag-expert.md # RAG 기반 문서 검색
+└── skills/                      # 스킬 (재사용 가능한 도구 모음)
+    └── code-explorer/           # GitHub/HuggingFace 코드 탐색
+        ├── SKILL.md
+        ├── scripts/
+        │   ├── search_github.py
+        │   └── search_huggingface.py
+        └── references/
+            ├── github_api.md
+            └── huggingface_api.md
+```
+
+## 슬래시 커맨드
+
+### 일반 커맨드
+
+| 커맨드 | 설명 |
+|--------|------|
+| `/plan` | 요구사항을 분석하고 코드 작성 전 구현 계획만 수립 |
+| `/commit-and-push` | 변경된 파일 분석 후 Conventional Commits 형식으로 커밋 및 푸시 |
+| `/code-review` | CodeRabbit 등 외부 코드 리뷰 결과를 분석하고 자동 수정 적용 |
+| `/edit-notebook` | Jupyter Notebook 파일을 NotebookEdit 도구로 안전하게 편집 |
+| `/ask-deepwiki` | DeepWiki MCP를 활용하여 GitHub 리포지토리에 심층 질의 |
+
+### GitHub 워크플로우 커맨드 (`/gh/`)
+
+| 커맨드 | 설명 |
+|--------|------|
+| `/gh/create-issue-label` | 프로젝트 구조 분석 후 적절한 GitHub 이슈 라벨 생성 |
+| `/gh/decompose-issue` | 큰 작업을 관리 가능한 독립적인 이슈들로 분해 |
+| `/gh/post-merge` | PR 머지 후 브랜치 정리 및 CLAUDE.md 업데이트 |
+| `/gh/resolve-issue` | GitHub 이슈 번호를 받아 체계적으로 분석하고 해결 |
+
+## 에이전트
+
+| 에이전트 | 설명 |
+|----------|------|
+| `web-researcher` | 다중 플랫폼(Reddit, GitHub, SO, HF, arXiv 등)에서 기술 리서치 수행 |
+| `python-pro` | Python 고급 기능(데코레이터, 제너레이터, async/await) 전문가 |
+| `generate-llmstxt` | 웹사이트나 로컬 디렉토리에서 llms.txt 문서 생성 |
+| `langconnect-rag-expert` | RAG 기반 문서 컬렉션에서 정보 검색 및 종합 |
+
+## 스킬
+
+### code-explorer
+
+GitHub와 Hugging Face에서 코드/모델/데이터셋을 검색하고 분석하는 스킬입니다.
+
+```bash
+# GitHub 리포지토리 검색
+python scripts/search_github.py "object detection" --limit 10
+
+# Hugging Face 모델/데이터셋/Spaces 검색
+python scripts/search_huggingface.py "qwen vl" --type models
+```
+
+## 설치
+
+### npx로 설치 (권장)
+
+```bash
+# 현재 프로젝트에 설치
+npx @yeongjaeyou/claude-code-config
+
+# 전역 설치 (모든 프로젝트에서 사용)
+npx @yeongjaeyou/claude-code-config --global
+```
+
+### 수동 설치
+
+```bash
+# 방법 1: 직접 복사
+git clone https://github.com/YoungjaeDev/claude-code-config.git
+cp -r claude-code-config/.claude /path/to/your/project/
+
+# 방법 2: 심볼릭 링크
+ln -s /path/to/claude-code-config/.claude /path/to/your/project/.claude
+```
+
+### CLI 옵션
+
+```bash
+npx @yeongjaeyou/claude-code-config [옵션]
+
+옵션:
+  -g, --global   전역 설치 (~/.claude/)
+  -h, --help     도움말 출력
+  -v, --version  버전 출력
+```
+
+## 사용법
+
+### 실행 예시
+
+```bash
+# 구현 계획 수립
+/plan 새로운 인증 시스템 구현
+
+# 커밋 및 푸시
+/commit-and-push src/auth.ts src/utils.ts
+
+# GitHub 이슈 해결
+/gh/resolve-issue 42
+```
+
+## 주요 기능
+
+### `/plan` - 구현 계획 수립
+- 요구사항의 의도를 파악하고 불명확하면 질문
+- 관련 코드베이스를 조사하고 이해
+- 단계별 실행 계획 작성
+- **바로 코드를 작성하지 않고 계획만 수립**
+
+### `/commit-and-push` - Git 자동화
+- Conventional Commits 형식 준수 (feat, fix, refactor, docs 등)
+- 변경 내용 분석 후 적절한 커밋 메시지 생성
+- 지정된 파일만 선택적으로 커밋
+
+### `/edit-notebook` - Jupyter Notebook 편집
+- `NotebookEdit` 도구만 사용 (JSON 구조 보호)
+- 셀 삽입 순서 보장을 위한 cell_id 추적
+- source 형식 문제 해결 가이드 포함
+
+### `web-researcher` 에이전트
+- GitHub(`gh` CLI), Hugging Face(`huggingface_hub`), Reddit, SO, arXiv 등 다중 플랫폼 검색
+- Context7/DeepWiki를 통한 공식 문서 수집
+- 한글 리서치 리포트 자동 생성
+
+### `code-explorer` 스킬
+- `gh` CLI를 활용한 GitHub 리포지토리/코드 검색
+- `huggingface_hub` API를 활용한 모델/데이터셋/Spaces 검색
+- 임시 디렉토리(`/tmp/`)에 소스 코드 다운로드 및 분석
+
+## 라이선스
+
+MIT License

package/bin/cli.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+
+const pkg = require('../package.json');
+const args = process.argv.slice(2);
+
+// 옵션 파싱
+const isGlobal = args.includes('--global') || args.includes('-g');
+const showHelp = args.includes('--help') || args.includes('-h');
+const showVersion = args.includes('--version') || args.includes('-v');
+
+// 버전 출력
+if (showVersion) {
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+// 도움말 출력
+if (showHelp) {
+  console.log(`
+Claude Code Config v${pkg.version}
+
+사용법:
+  npx @yeongjaeyou/claude-code-config [옵션]
+
+옵션:
+  -g, --global   전역 설치 (~/.claude/)
+  -h, --help     도움말 출력
+  -v, --version  버전 출력
+
+예시:
+  npx @yeongjaeyou/claude-code-config          # 현재 프로젝트에 설치
+  npx @yeongjaeyou/claude-code-config --global # 전역 설치
+`);
+  process.exit(0);
+}
+
+const source = path.join(__dirname, '..', '.claude');
+const dest = isGlobal
+  ? path.join(os.homedir(), '.claude')
+  : path.join(process.cwd(), '.claude');
+
+/**
+ * 사용자에게 질문하고 답변을 받는다
+ * @param {string} question - 질문 내용
+ * @returns {Promise<string>} - 사용자 답변
+ */
+function askQuestion(question) {
+  // 비대화형 환경 감지 (CI/CD, 파이프라인 등)
+  if (!process.stdin.isTTY) {
+    console.log('비대화형 환경이 감지되었습니다. 기본값(Y)을 사용합니다.');
+    return Promise.resolve('');
+  }
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
+/**
+ * 메인 함수
+ */
+async function main() {
+  console.log('');
+  console.log('Claude Code Config');
+  console.log('==================');
+  console.log('');
+
+  // 소스 폴더 존재 확인
+  if (!fs.existsSync(source)) {
+    console.error('오류: 소스 .claude/ 폴더를 찾을 수 없습니다.');
+    process.exit(1);
+  }
+
+  // 설치 위치 안내
+  if (isGlobal) {
+    console.log('전역 설치 모드: ~/.claude/에 설치합니다.');
+  } else {
+    console.log('로컬 설치 모드: 현재 디렉토리에 설치합니다.');
+  }
+  console.log(`설치 경로: ${dest}`);
+  console.log('');
+
+  // 대상 폴더가 이미 존재하는 경우
+  if (fs.existsSync(dest)) {
+    console.log('기존 .claude/ 폴더가 발견되었습니다.');
+
+    const answer = await askQuestion('덮어쓰시겠습니까? (Y/n): ');
+
+    // 빈 값(Enter)이거나 y/Y면 덮어쓰기
+    if (answer === '' || answer === 'y') {
+      fs.rmSync(dest, { recursive: true });
+      console.log('기존 폴더를 삭제했습니다.');
+    } else {
+      console.log('설치가 취소되었습니다.');
+      process.exit(0);
+    }
+  }
+
+  // 폴더 복사
+  fs.cpSync(source, dest, { recursive: true });
+
+  console.log('');
+  console.log('.claude/ 폴더가 성공적으로 설치되었습니다!');
+  console.log('');
+  console.log('설치된 내용:');
+  console.log('  - commands/  : 슬래시 커맨드');
+  console.log('  - agents/    : 커스텀 에이전트');
+  console.log('  - skills/    : 스킬 (재사용 가능한 도구 모음)');
+  console.log('');
+
+  if (isGlobal) {
+    console.log('전역 설치가 완료되었습니다.');
+    console.log('모든 프로젝트에서 Claude Code 커맨드를 사용할 수 있습니다.');
+  }
+}
+
+main().catch((error) => {
+  console.error('오류:', error.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@yeongjaeyou/claude-code-config",
+  "version": "0.1.0",
+  "description": "Claude Code CLI custom commands, agents, and skills",
+  "bin": {
+    "claude-code-config": "./bin/cli.js"
+  },
+  "files": [
+    ".claude",
+    "bin"
+  ],
+  "keywords": [
+    "claude-code",
+    "cli",
+    "commands",
+    "agents",
+    "skills"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YoungjaeDev/claude-code-config.git"
+  },
+  "author": "YoungjaeDev",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/YoungjaeDev/claude-code-config/issues"
+  },
+  "homepage": "https://github.com/YoungjaeDev/claude-code-config#readme"
+}