수술적 GitHub 추출: 전체 저장소가 아닌 하나의 함수를 가져오는 클로드 기술

"아이디어를 빌려오라"고 했을 때 Claude Code가 전체 저장소를 클론하는 경향에 불만을 느낀 한 개발자가 이 문제를 해결하는 오픈 소스 Skill을 출시했습니다. surgical-github-extraction이라는 이 Skill은 Claude가 전체 저장소를 가져오거나 의존성을 추가하는 대신 정확한 워크플로를 따르도록 지시합니다.

작동 방식

이 Skill은 GitHub URL이 영감으로 제공될 때 자동으로 트리거되는 단일 SKILL.md 파일입니다. 규칙은 다음과 같습니다:

• 먼저 README를 읽어 프로젝트 구조를 파악합니다.
• 패턴이 어떻게 연결되어 있는지 확인하기 위해 raw URL을 통해 1~3개의 소스 파일을 가져옵니다(프롬프트, 스키마, 오케스트레이션 파일). 전체 저장소는 절대 가져오지 않습니다.
• 커밋 SHA에 고정하고 /tmp(또는 Windows에서는 %TEMP%)에 저장합니다.
• 함수, 프롬프트 또는 패턴 등 가장 작은 유용한 단위를 추출합니다.
• 자신의 스타일로 다시 작성합니다. 소스 SHA를 인용합니다.

실제 예시

• TradingAgents 저장소: "이 패턴을 구직 지원자에게 사용할 수 있나요?" → README와 몇 개의 에이전트/프롬프트 파일을 읽고, 유사 패턴(JobFitAnalyst + Critic이 논쟁)을 제안했습니다. 프로젝트에 복사된 내용은 없습니다.
• litl/backoff 라이브러리: "지수 백오프를 훔쳐오라"고 요청 → 하나의 파일(_wait_gen.py)을 가져와 8줄의 제너레이터를 추출하고, 출처 주석과 함께 인라인으로 다시 작성했습니다. pip install은 필요하지 않았습니다.

MCP가 아닌 Skill을 선택한 이유

저자는 MCP 서버 대신 Claude Skill로 구축하기로 선택했습니다. Skill은 Claude가 이미 가지고 있는 도구(WebFetch, curl, gh, Read)에 대한 순수한 규율이기 때문입니다. MCP는 새로운 도구를 제공하는 반면, Skill은 지침을 제공합니다. 이는 Anthropic의 자체 mcp-builder와 동일한 형태입니다 — Skill이지 MCP가 아닙니다.

설치

MIT 라이선스, 단일 파일 설치:

mkdir -p ~/.claude/skills/surgical-github-extraction
curl -fsSL https://raw.githubusercontent.com/jeet-dhandha/jd-skills/main/skills/surgical-github-extraction/SKILL.md \
  -o ~/.claude/skills/surgical-github-extraction/SKILL.md

두 Skill 모두 jd-skills 컬렉션에 있습니다: github.com/jeet-dhandha/jd-skills.

code-graft라는 관련 Skill은 일회성 스니펫으로는 부족하지만 런타임 의존성은 너무 큰 경우를 처리합니다 — 사용하는 라이브러리 일부만 가져와 나머지를 제거하고, 선택적으로 업스트림과 다시 동기화할 수 있습니다.

대상 사용자

AI 에이전트가 오픈 소스 코드를 가져오고 참조하는 방식을 정밀하게 제어하려는 Claude Code 사용자 — 실수로 git clone하거나 의존성이 불어나는 것을 방지합니다.