Extração Cirúrgica do GitHub: Uma Habilidade do Claude para Buscar Apenas uma Função, Não o Repositório Inteiro

Um desenvolvedor frustrado com a tendência do Claude Code de clonar repositórios inteiros quando solicitado a "pegar emprestada uma ideia" lançou um Skill de código aberto que resolve o problema. O Skill, chamado surgical-github-extraction, instrui o Claude a seguir um fluxo de trabalho preciso em vez de buscar todo o repositório ou adicionar uma dependência.

Como Funciona

O Skill é um único arquivo SKILL.md que é acionado automaticamente quando uma URL do GitHub é inserida como inspiração. As regras são:

• Leia o README primeiro para entender a estrutura do projeto.
• Puxe 1–3 arquivos fonte via URLs brutas para ver como o padrão está configurado — prompts, esquemas, arquivos de orquestração. Nunca o repositório inteiro.
• Fixe em um commit SHA, salve em /tmp (ou %TEMP% no Windows).
• Extraia a menor unidade útil: uma função, um prompt ou apenas o padrão.
• Reescreva no seu estilo. Cite o SHA de origem.

Exemplos Reais

• Repositório TradingAgents: Perguntou "podemos usar este padrão para um candidato a emprego?" → README mais alguns arquivos de agente/prompt, propôs um análogo (JobFitAnalyst + Critic argumentando contra). Nada copiado para o projeto.
• Biblioteca litl/backoff: Pediu para "roubar o backoff exponencial" → buscou um arquivo (_wait_gen.py), extraiu o gerador de 8 linhas, reescreveu inline com um comentário de proveniência. Sem pip install.

Por que um Skill, não um MCP

O autor escolheu construir isso como um Skill do Claude em vez de um servidor MCP porque Skills são pura disciplina nas ferramentas que o Claude já possui (WebFetch, curl, gh, Read). MCPs entregam novas ferramentas; Skills entregam instruções. A mesma forma que o próprio mcp-builder da Anthropic — isso é um Skill, não um MCP.

Instalação

Licença MIT, instalação de arquivo único:

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

Ambos os skills estão na coleção jd-skills: github.com/jeet-dhandha/jd-skills.

Um skill irmão chamado code-graft lida com casos onde um snippet único não é suficiente, mas uma dependência de runtime é demais — ele fornece apenas a parte da biblioteca que você usa, remove o resto e pode ressincronizar seletivamente a partir do upstream.

Para Quem é

Desenvolvedores usando Claude Code que desejam controle preciso sobre como agentes de IA buscam e referenciam código-fonte aberto — sem git clone acidental ou inchaço de dependências.