marola-dev/agent-skills

o catálogo das skills da marola · índice completo · auditoria · achados · quando usar cada uma
Uma lista de todas as skills e subagentes do Claude Code que usamos na
marola-dev e nos repositórios do
h0ffmann. Para cada um: onde mora, de onde veio, o que já foi
testado e o que precisa de uma pessoa olhando.
**Skill** é um arquivo SKILL.md com instruções que o Claude Code segue numa tarefa.
**Subagente** é um ajudante com papel fixo, como revisar um PR.
**Este repositório só descreve.** Nada aqui é carregado pelo Claude Code. Cada skill continua no
repositório que a usa, e é lá que ela é corrigida.
Automação
Todo dia às 06:17 UTC, o refresh.yml roda o scripts/refresh.py. Você
também pode rodar à mão, pela aba Actions, ou com just refresh.
O script procura todo SKILL.md e todo subagente:
- em todos os repositórios públicos da **marola-dev**;
- nos repositórios do **h0ffmann** com push nos últimos 15 dias (active_days em
data/sources.json);
- nos repositórios de fora que a gente acompanha (watch, no mesmo arquivo).
Ele escreve data/index.json e
docs/4-reference_index.md. Pastas de teste, de exemplo e de
evals/ ficam de fora.
**Não gasta tokens de modelo.** Só usa a API do GitHub. Um repositório sem push novo custa uma
resposta 304 (o GitHub diz "nada mudou"). Só a lista "esperando revisão" precisa de um agente
lendo.
Para acompanhar as skills de outra pessoa, ponha "dono" ou "dono/repo" em watch.
Num relance
Contagem do índice gerado em 2026-10-16.
| | Quantos |
|---|---|
| Skills e subagentes nossos | 81 (74 skills, 7 subagentes), 75 nomes diferentes |
| Escritos aqui | 54 |
| Copiados de terceiros (vendored) | 27: 16 iguais à versão fixada, 10 atrás da versão de origem, 1 diferente |
| Revisados | 33 |
| Esperando revisão | 48: 34 novos, 14 mudaram depois da revisão |
| Skills de fora que acompanhamos | 263 |
Onde moram: marola-site (21), marola-devkit (17), ww3-gpu (15), picasso (11), closed-source (8),
o guarda-chuva marola (4), h0ffmann (2), marola-app, marola-corpus e marola-research (1 cada).
Os subagentes: mip-reviewer e mip-claims-auditor (devkit), jar-verifier (marola-app),
news-copy-review e news-fact-check (marola-site), revisor-proposta e security-reviewer
(ww3-gpu).
Por etiqueta
Cada skill tem uma etiqueta (tag) que diz para que serve:
| Etiqueta | Para quê | Quantas |
|---|---|---|
| FE | o mapa e as páginas do marola.dev: design, animação, testes, Mapbox | 17 |
| workflow | o processo do time: MIPs, issues, PRs empilhados, trazer skills de fora | 12 |
| research | escrever, citar e publicar pesquisa | 10 |
| backend | qualidade e simplicidade do código, o app em Scala | 8 |
| DE | trazer dados para dentro: documentos do corpus, notas de voz | 2 |
| sem etiqueta | ainda não classificadas, a maioria nova | 33 |
A lista completa, com links, está no índice. A
auditoria tem a origem, os testes e as notas de cada uma.
Plugins e servidores MCP
Um **plugin** traz várias skills, agentes e ganchos (hooks) de uma vez. Um **servidor MCP** dá
ao Claude Code uma ferramenta nova, como buscar documentação ou abrir um navegador. Esta lista
vem do .claude/settings.json e do .mcp.json de cada repositório, lidos em 2026-10-16.
| Nome | O que é | Onde está ligado | Para quê |
|---|---|---|---|
| marola-devkit | plugin nosso, v0.12.0 | marola, marola-app, marola-site, marola-oods, marola-ml, marola-corpus, marola-skills | skills de MIP e de issues, os agentes revisores e os ganchos comuns a todo repositório |
| Ponytail 5 | plugin, v5.2.0 | marola-site; marola-research liga o plugin sem declarar de onde ele vem, então pode não carregar | a solução mais simples que funciona; ponytail-review e ponytail-audit também vêm copiados dentro do devkit |
| superpowers | plugin oficial | marola, marola-app | o fluxo de trabalho: planos, TDD, revisão de código |
| skill-creator | plugin oficial da Anthropic | marola, marola-app | criar skills e rodar as evals delas |