# Kit Curar > Verifica a saúde do acervo pessoal de sites — duplicatas, arquivos vazios, fichas mal escritas que a busca nunca vai encontrar, dependências exigidas, imports que quebram quando a peça é copiada para outro projeto, e assets externos que já expiraram. Use quando o usuário perguntar o estado do acervo, reclamar que a busca não acha o que deveria, quiser limpar ou revisar o que está guardado, antes de uma leva grande de ingestão, ou invocar /kit-curar. - Skill: `harebeats/kit-curar` (Agent Skill, multi-file: 53 files) - Install (CLI): `npx skillmds@latest add harebeats/kit-curar` - Raw SKILL.md: https://api.skillmd.com/api/skills/harebeats/kit-curar/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: harebeats (https://skillmd.com/u/harebeats) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/harebeats/kit-curar --- # kit-curar — saúde do acervo ## Antes de qualquer comando: resolva o `SKILL_DIR` Todo comando abaixo roda um script que viaja junto desta skill, em `SKILL_DIR/scripts/`. Defina `SKILL_DIR` como o **caminho absoluto da pasta que contém ESTE SKILL.md que você acabou de ler** — o seu harness informou esse caminho no resultado da leitura. Funciona em qualquer hospedeiro, sem depender de variável de ambiente de nenhum agente específico: ``` ~/.claude/plugins/cache/cannonball/cannonball//skills//SKILL.md ~/.codex/skills//SKILL.md ~/.gemini/skills//SKILL.md ~/.agents/skills//SKILL.md ``` Em todos, `SKILL_DIR` é a pasta do `SKILL.md`, e `SKILL_DIR/scripts/` está ao lado. ```bash python "${SKILL_DIR}/scripts/perfil.py" # o retrato de agora python "${SKILL_DIR}/scripts/curar.py" python "${SKILL_DIR}/scripts/curar.py" --assets --n 20 # testa URLs (usa rede) ``` O `perfil.py` vem primeiro porque dá a escala: ele reporta o total, as lacunas de função e três contadores que dizem onde a curadoria vale mais — peças sem contraindicação escrita, peças com asset já morto, peças com fonte não entregável. **Acervo vazio não precisa de curadoria.** Se o perfil disser que não há nada, mande o usuário para `/kit-ingerir` em vez de rodar o relatório. As seções abaixo seguem a numeração do relatório. O que fazer com cada uma: ## 1. Duplicatas e vazios Duplicata exata significa o mesmo conteúdo em dois ids — os dois competem na busca e nenhum ganha. Mantenha o de melhor ficha, apague o outro. Arquivo vazio é lixo puro. Confirme com o usuário e remova a pasta. ## 2. Fichas fracas — o problema mais importante São itens com `quando_usar` curto demais, sem contraindicação, ou com menos de três tags. **Estes itens existem no acervo mas são invisíveis para a busca.** É a causa número um de "eu sei que tenho isso mas não acho". Corrigir vale mais que ingerir coisa nova. Para cada item fraco: leia o arquivo, reescreva `quando_usar` e `nao_usar_quando` com critério concreto, e edite o `meta.yaml` (ou `item.json`) da pasta. Depois rode `indexar.py`. ## 3. Rascunhos e descartes `rascunho` = incompleto, use com ressalva. `descartar` = candidato a remoção. Decida com o usuário: completar a ficha, ou apagar. Deixar apodrecendo no meio-termo é o pior dos casos, porque continua aparecendo em busca sem servir para nada. ## 4. Dependências A lista mostra o que os projetos vão precisar ter instalado. Repare especialmente nas que começam com `@/` — **não são pacotes npm, são arquivos que precisam existir no projeto**. `@/lib/utils` (a função `cn`) é exigida por boa parte deles; sem ela, o import quebra. ## 5. Assets externos Boa parte do acervo aponta para vídeos e imagens em `cloudfront.net`, `figma.site` e `higgs.ai` — buckets temporários que expiram. Uma peça cujo asset caiu ainda gera código válido, mas a página nasce com mídia quebrada. `--assets` testa as URLs de verdade. O que voltar `MORTO` precisa de substituição antes de ser usado em cliente. Registre isso no `nao_usar_quando` da peça para não descobrir de novo no próximo projeto. ## 7. Contrato de cópia — o que quebra o build no destino A peça sai do acervo **por cópia**, e import relativo que não resolve dentro da pasta dela vira `Module not found` no projeto de destino. O erro parece falta de dependência npm, não falta de peça — é por isso que custa caro: você procura no lugar errado. O relatório lista cada peça e, quando o alvo existe no acervo sob outro id, imprime `está no acervo: ./button -> wml-button`. Duas saídas, nessa ordem: - **o alvo é peça do acervo** → declare em `precisa_componentes` no `item.json`. A busca passa a imprimir `PRECISA JUNTO:` e o problema acaba na escolha, não na entrega. - **o alvo não é peça nenhuma** (um `./icons`, um `../../data` do projeto original) → traga o arquivo para dentro da pasta da peça, ou registre no `nao_usar_quando`. `--autoteste` verifica o detector em si, sem tocar no acervo. ## Ordem recomendada Vazios e duplicatas primeiro (rápido e definitivo), fichas fracas depois (é o que mais melhora a busca), contrato de cópia em seguida (a correção é quase sempre uma linha no `item.json`), assets por último (depende de rede e muda com o tempo). Sempre rode `indexar.py` depois de qualquer edição de ficha.