skill-smith
Skill0 starsChanged 6 days agoApache-2.0View on GitHub
Cria e mantém NOVAS skills e subagentes do projeto na convenção certa. Use sempre que perceber um workflow repetido/cheio de gotcha que merece virar skill, ou quando precisar de um especialista recorrente que merece virar subagente nativo. Qualquer agente pode invocar esta skill.
4 other projects use a version of this.
Adopted by
Most recently taken up by
- allemaar/open-skillstheir own version, first seen Nov 1, 2026
- DaizeDong/skill-smiththeir own version, first seen Oct 16, 2026
- fbadanouy/skill-smiththeir own version, first seen Oct 15, 2026
- ItsssssJack/seven-skillstheir own version, first seen Aug 1, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- ItsssssJack/seven-skills★ 19same name
- allemaar/open-skills★ 15same name
- DaizeDong/skill-smith★ 1same name
- fbadanouy/skill-smith★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository12 other files it gives its agents.
- busca-eficienteSkill
- docs-context7Skill
- graphifySkill
- grillingSkill
- licao-aprendidaSkill
- prSkill
- rememberSkill
- sem-cara-de-iaSkill
- spec-primeiroSkill
- veracidade-de-numeroSkill
- verifySkill
- wizardSkill
The file
Files
skill-smith — fábrica de skills e agentes do projeto
Autorização do projeto (fundamental): qualquer agente pode criar uma skill ou um subagente quando julgar que otimiza o trabalho. Não peça permissão para criar — apenas siga esta convenção, mantenha enxuto e anote a decisão. Prefira EDITAR uma skill existente a duplicar.
Quando criar
- Skill = um workflow repetido (≥2x) e/ou cheio de gotcha que sempre erra na mão. Encapsula o procedimento + os becos sem saída + o Definition of Done.
- Subagente = um papel especialista recorrente (varredura ampla, dispatch isolado) que
vale ter despachável por tipo. Os playbooks vivem em
docs/agentes/. - NÃO crie se for tarefa única, trivial, ou já coberta por skill/playbook existente. Cheque antes:
ls .claude/skills/,ls .claude/agents/,rg "<tema>" docs/agentes/.
Anatomia de uma SKILL (.claude/skills/<nome-kebab>/SKILL.md)
---
name: <nome-kebab> # == nome da pasta, minúsculo-com-hífen
description: <quando usar — gatilhos concretos em PT-BR; gatilhos do dia a dia.
Inclua a regra nº1 do projeto, se houver.>
---
# Título
<o procedimento real, com os COMANDOS verificados no sistema (não inventados)>
## Gotchas / becos sem saída (não refazer)
## Done (checklist curto)
<links [[memoria]] e caminhos docs/knowledge/>Regras: conciso (economia de token), comandos verificados contra o sistema, nenhum segredo
(senha via env ${VAR}), PT-BR. Cite caminhos em vez de despejar conteúdo.
Teto de 8 KB no SKILL.md (progressive disclosure — decisão 27/07). O SKILL.md inteiro
entra no contexto a cada invocação; as referências só quando lidas. Passou de ~8 KB: deixe
no núcleo o fluxo + gotchas + tabela "tema → arquivo" e mova o detalhe para
<skill>/references/*.md. Skill vendorizada de fora vem gorda — fatie ANTES de usar
(sql-server-performance 48→8 KB, playwright-testing 25→5 KB).
description: gatilhos concretos em ~1-2 linhas — ela pesa em TODA sessão, não só na invocação.
Anatomia de um SUBAGENTE (.claude/agents/<nome>.md)
---
name: <nome-kebab>
description: <quando despachar este especialista; gatilhos>
tools: Read, Grep, Glob, Bash # mínimo necessário (menor privilégio)
model: sonnet # sonnet p/ a maioria; opus só p/ tarefa difícil
---
Você é <Nome>, <papel>. ANTES de agir leia (1x):
`AGENTS.md` do projeto e o playbook da área, se existir.
Siga a regra nº1 do projeto. Devolva só a CONCLUSÃO (sem dumps).
Você tem liberdade de criar skills (via skill-smith) se achar importante.O corpo é fino: referencia o playbook (fonte da verdade), não duplica. Atualize o
team-registry.json se for um papel novo.
Antes de embrulhar uma lib externa
- Confirme a API atual com a skill
docs-context7(ou o subagentedocs-researcher) — a skill nasce com a assinatura certa, não com API alucinada. Cite o libraryId/versão na skill.
Depois de criar (sempre)
- Teste mentalmente os gatilhos da
description(é o que faz a skill ser auto-selecionada). - Garanta que os comandos batem com o sistema real (skill
run-sql/busca-eficientep/ conferir). - Anote a decisão:
node "$HOME/.kit-memoria-ia/kit.mjs" lembrar "nova skill/agente: <nome>"se for não-óbvio. - Permissões: se a skill roda comandos novos repetidos, considere adicionar à allowlist em
.claude/settings.json(permissions.allow).
Princípio
Skill boa é a que você gostaria de ter encontrado pronta da próxima vez. Menos é mais — uma skill afiada vence cinco vagas.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

