/scout — GitHub Repo Scout

내 환경을 분석하고, GitHub에서 나에게 필요한 레포를 찾아주는 스카우터.

두 가지 모드

Mode 1: 환경 분석 모드 (인자 없이 실행)

/scout

내 .claude/, .codex/ 환경을 분석 → 공백 식별 → GitHub 검색 → 맞춤 추천

Mode 2: 검색 엔진 모드 (인자와 함께 실행)

/scout "investment analysis tool"
/scout "react state management 2026"
/scout "mcp server for slack"

사용자 키워드로 GitHub을 검색 → 스타/활동성 기준 필터링 → 결과 표시

실행 시작 시 필수 행동

1. ARGUMENTS 확인
   - 인자가 있으면 → Mode 2 (검색 엔진 모드) 로 직행
   - 인자가 없으면 → Mode 1 (환경 분석 모드)

2. Reference 파일 읽기:
   - references/categories.md (고정 카테고리 목록)
   - references/search-queries.md (검색 쿼리 템플릿)

Mode 1: 환경 분석 모드

Step 1: 환경 스캔

아래 경로를 Glob + Read 도구로 스캔:

1. Glob("~/.claude/skills/**/SKILL.md") → 스킬 목록 수집
   각 SKILL.md에서 name, description 추출

2. Glob("~/.claude/agents/*.md") → 에이전트 목록 수집
   각 파일에서 역할/설명 추출

3. Glob("~/.claude/rules/*.md") → 규칙 목록 수집
   파일명 + 내용에서 카테고리 추출

4. Read("~/.claude/settings.json") → MCP 서버 목록
   mcpServers 키에서 서버 이름 추출

5. Read("~/.mcp.json") → 추가 MCP 설정 (있으면)

6. Glob("~/.codex/**") → Codex 설정 확인

7. Read("~/.claude/CLAUDE.md") → 전역 설정 키워드

출력:

🔍 환경 분석 중...

  현재 환경:
  ├── 스킬: {N}개
  ├── 에이전트: {N}개
  ├── 규칙: {N}개
  ├── MCP 서버: {N}개 ({서버명 리스트})
  └── Codex 설정: {있음/없음}

  감지된 카테고리:
  ✅ {있는 카테고리 1}
  ✅ {있는 카테고리 2}
  ...

Step 2: 공백 식별

references/categories.md의 고정 카테고리 목록과 스캔 결과를 대조:

for each category in fixed_categories:
    if category.keywords NOT IN scanned_environment:
        → 공백으로 표시

출력:

📊 공백 영역:
  ⚠️ {공백 카테고리 1} — {설명}
  ⚠️ {공백 카테고리 2} — {설명}

Step 3: GitHub 검색

references/search-queries.md의 쿼리 템플릿을 사용하여 순차 검색:

기본 검색 (항상 실행):

mcp__github__search_repositories:
  query: "claude-code OR claude-code-skills OR .claude in:name,description,readme"
  sort: "stars"
  order: "desc"
  perPage: 10

mcp__github__search_repositories:
  query: "mcp-server OR model-context-protocol in:name,description"
  sort: "stars"
  order: "desc"
  perPage: 10

mcp__github__search_repositories:
  query: "codex-cli OR codex-app in:name,description"
  sort: "stars"
  order: "desc"
  perPage: 10

공백 카테고리별 추가 검색: 공백이 식별된 카테고리에 대해 추가 쿼리 실행. 예: CI/CD 공백 → "claude" AND "github-actions" 검색

범위: Claude Code/Codex 스킬/플러그인만이 아니라, 이 도구들의 사용을 최적화하는 모든 레포 포함:

• CLI 도구, 자동화 스크립트
• 워크플로우 템플릿
• 설정/dotfile 컬렉션
• 개발 효율 도구
• AI 코딩 관련 유틸리티

출력:

🔎 GitHub 검색 중...
  ├── Claude Code 생태계 검색 완료 ({N}개)
  ├── MCP 서버 검색 완료 ({N}개)
  └── 공백 카테고리 검색 완료 ({N}개)

Step 4: 매칭 & 랭킹

검색 결과를 환경 데이터와 매칭:

for each repo in search_results:
    score = 0
    if repo.category in gap_categories:
        score += 3  (공백 해결)
    elif repo.category in existing_categories:
        score += 1  (보강 가능)

    if repo.stars > category_threshold * 2:
        score += 1  (인기도 보너스)

    if repo.last_updated < 7_days:
        score += 1  (활발한 개발)

    filter out: score == 0 (중복/무관)
    filter out: archived repos
    filter out: forks (원본만)

중복 제거: 같은 레포가 여러 검색에서 나왔으면 1개만.

Step 5: CLI 출력

카테고리별 그룹화 + 상세 정보:

📦 MCP 서버 ({N}개 발견)

  1. {owner}/{repo} (⭐ {stars}, 활동: {days}일전)
     매칭: {왜 추천하는지 — 공백 해결/보강/트렌드}
     추천: {한 줄 설명}
     설치: {설치 명령어 또는 URL}

  2. ...

🛠️ 스킬/에이전트 ({N}개 발견)

  1. ...

🔧 개발 도구 ({N}개 발견)

  1. ...

✅ 총 {N}개 레포 추천 완료

  📦 MCP 서버: {N}개
  🛠️ 스킬/에이전트: {N}개
  🔧 개발 도구: {N}개

  공백 해결: {카테고리 리스트}
  보강 가능: {카테고리 리스트}

Mode 2: 검색 엔진 모드

사용자가 /scout "키워드" 형태로 인자를 넘기면 이 모드로 실행.

Step 1: 쿼리 생성

사용자 키워드를 분석하여 GitHub 검색 쿼리 생성:

사용자 입력: "investment analysis tool"

쿼리 생성:
1. "investment analysis tool" in:name,description,readme stars:>10
2. "investment" AND "analysis" in:name,description stars:>10
3. 관련 확장 키워드 추가 (AI 판단):
   "finance" AND "analysis" AND ("python" OR "api") stars:>10

Step 2: GitHub 검색

mcp__github__search_repositories:
  query: {생성된 쿼리}
  sort: "stars"
  order: "desc"
  perPage: 15

여러 쿼리를 순차 실행, 결과 합산 & 중복 제거.

Step 3: 필터링 & 출력

🔎 "{사용자 키워드}" 검색 결과

  스타순 정렬, 최근 활동 기준 필터링:

  1. {owner}/{repo} (⭐ {stars}, 활동: {days}일전)
     설명: {repo description}
     언어: {primary language}
     토픽: {topics}
     URL: https://github.com/{owner}/{repo}

  2. ...

  ...

✅ 총 {N}개 레포 발견 (스타 10+ 기준)

검색 모드에서는:

• 환경 분석 건너뜀
• 매칭 점수 계산 안 함
• 순수 검색 결과를 스타순으로 정렬하여 표시
• 각 레포의 description, language, topics, URL 표시

에러 처리

제약사항

• GitHub Search API: 인증 시 30 req/min — 쿼리 수를 10개 이내로 유지
• 실행 시간 목표: 60초 이내
• 결과 최대: 15개 레포
• Stateless: 결과를 파일로 저장하지 않음 (CLI 출력만)