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.
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_daysemdata/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.
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).
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.
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 |
| writing-skills | plugin, fixado num commit | marola | estilos de escrita: plain-language, google-dev-docs e outros |
| Graphify | ferramenta de linha de comando, não plugin | todo repositório com o devkit, pelo just graph |
um grafo do código para o agente consultar (veja Em destaque) |
| context7 | servidor MCP | marola-app (.mcp.json, precisa de CONTEXT7_API_KEY) |
documentação atual de bibliotecas, em vez da memória do modelo |
| playwright | servidor MCP, @playwright/mcp@0.0.83 |
marola-site | dirigir um navegador para as fotos de antes e depois do site |
| figma | servidor MCP | marola-site | ler os desenhos do Figma |
| marola | servidor MCP nosso | marola-app (just mcp-server, in a marola-app checkout) |
as ferramentas da própria marola: praias, condições do mar |
| ai-memory | servidor MCP | só no ambiente do mantenedor; nenhum repositório liga | memória de longo prazo por projeto, entre sessões |
| mattpocock-skills | plugin | só no ambiente do mantenedor; nenhum repositório liga | skills do dia a dia de um engenheiro; está no top 20 |
ouroboric-dev (13 repositórios) não liga nenhum plugin nem servidor MCP. A regra de lá é o
contrário: copiar as skills de fora para o havamal, fixadas e revisadas num skills.lock, como
na MIP-0080, e nunca instalar ganchos de plugin. Ponytail, superpowers e Graphify aparecem só na
documentação, como referência.
O Graphify transforma um código num grafo de conhecimento. Um agente consulta o grafo em vez de ler pasta por pasta. A marola usa o Graphify pela MIP-0076. Não instalamos a skill. É assim:
- Um comando só. O devkit traz o Graphify fixado pelo Nix. Você usa
just graph buildejust graph query "<pergunta>". - Offline e sem chave. Cada chamada roda sem rede e sem variáveis de ambiente além de cinco.
Os modos que chamariam um modelo (
extract,update,--backend) são recusados. - Fora do repositório. O grafo fica em
~/.cache/marola-graph/<repo>, nunca num commit. - Quando usar. O
AGENTS.mddo guarda-chuva manda perguntas como "onde mora este símbolo?" para ojust graph query. A skillroutingdo devkit diz quando ogit grepsai mais barato. - No CI. O guarda-chuva monta o grafo quando um submódulo, o devkit ou o Graphify mudam.
A MIP-0075 monta um lago de dados do oceano (um lugar único para guardar os dados) no Cloudflare R2. Estas são as skills que ajudam: as da Cloudflare, as da DuckDB e as de engenharia de dados. Cada uma faz um ou mais de cinco trabalhos: INIT, MANAGE, GOV, DEBUG e CONNECT. A atualização diária conta quantas já foram adotadas:
0 of 13 adopted in MIP-0075's repos. By job: INIT 0/2 · MANAGE 0/6 · GOV 0/5 · DEBUG 0/6 · CONNECT 0/3.
Cada skill, a origem, como entra e o que vigiar.
Escolhidas para o nosso trabalho e ordenadas pelas estrelas ganhas nos últimos 30 dias. Só
listadas, não revisadas: passe uma pela auditoria antes de copiar. O GitHub só mostra os clones
para quem mantém o repositório, então estrelas e forks são o sinal que temos. A tabela é refeita
todo dia a partir de data/curated.json. Até juntar 30 dias de histórico,
"Gained" conta desde a primeira leitura.
| # | Repository | Stars | Forks | Gained | Tag | Why it is here |
|---|---|---|---|---|---|---|
| 1 | mattpocock/skills | 295,576 | 24,800 | +2,631 since 2026-10-15 | backend | An engineer's day-to-day skills; the most starred skills repo this month |
| 2 | affaan-m/ECC | 282,918 | 42,016 | +2,465 since 2026-10-15 | backend | A whole agent harness (skills, memory, security); compare with marola-devkit before borrowing |
| 3 | K-Dense-AI/scientific-agent-skills | 52,539 | 4,651 | +1,993 since 2026-10-15 | research | 177 science skills: scientific writing, peer review, marine carbonate chemistry, CFD, GPU, Polars and Dask |
| 4 | cathrynlavery/diagram-design | 57,323 | 3,655 | +1,361 since 2026-10-15 | FE | Diagram design rules for docs and READMEs (MIP-0068's diagrams) |
| 5 | tt-a1i/archify | 85,138 | 5,771 | +1,060 since 2026-10-15 | FE | Architecture and workflow diagrams as self-contained HTML; the same job as the umbrella's architecture-diagram |
| 6 | cloudflare/security-audit-skill | 30,887 | 1,932 | +960 since 2026-10-15 | backend | Multi-phase security audit with machine-readable findings, for the app and the site |
| 7 | addyosmani/agent-skills | 107,996 | 11,258 | +927 since 2026-10-15 | backend | Production engineering skills: testing, performance, review |
| 8 | mksglu/context-mode | 30,592 | 2,240 | +775 since 2026-10-15 | backend | Context-window savings for agents, the token budget this repo optimises for |
| 9 | nexu-io/open-design | 102,060 | 11,721 | +688 since 2026-10-15 | FE | Design-system skills for agent-built UI; a candidate next to marola-site's design-taste-frontend |
| 10 | thedotmack/claude-mem | 101,509 | 8,905 | +440 since 2026-10-15 | backend | Memory across sessions; overlaps the devkit's obsidian-vault handoffs |
| 11 | alibaba/open-code-review | 47,564 | 3,472 | +164 since 2026-10-15 | backend | Code review skills, next to ponytail-review and Claude Code Review |
| 12 | NVIDIA/SkillSpector | 20,457 | 1,802 | +148 since 2026-10-15 | research | Scans a skill for risks before it is installed; automates part of this repo's audit |
| 13 | VoltAgent/awesome-agent-skills | 35,928 | 3,898 | +134 since 2026-10-15 | research | A curated directory of 1,000+ skills, to search before writing one |
| 14 | Agents365-ai/drawio-skill | 10,218 | 836 | +43 since 2026-10-15 | FE | draw.io diagrams from text, for proposal and docs figures |
| 15 | max-sixty/worktrunk | 9,282 | 331 | +28 since 2026-10-15 | backend | Git worktrees for parallel agents, the devkit's stacked-PR worktrees |
| 16 | teng-lin/notebooklm-py | 19,778 | 2,635 | +27 since 2026-10-15 | research | NotebookLM from an agent, for literature and proposal reading |
| 17 | yusufkaraaslan/Skill_Seekers | 15,176 | 1,672 | +18 since 2026-10-15 | DE | Turns documentation sites, repos and PDFs into skills, e.g. the WAVEWATCH III manual for ww3-gpu |
| 18 | tigerless-labs/autoharness | 11,136 | 629 | +3 since 2026-10-15 | DE | Distils skills from past sessions and prunes unused ones |
| 19 | Graphify-Labs/graphify | 126,931 | 12,243 | +0 since 2026-10-15 | backend | Codebase knowledge graph; marola adopts it through MIP-0076 (docs/4-reference_graphify.md) |
| 20 | Orchestra-Research/AI-Research-SKILLs | research | ML research and training skills, for marola-ml's fine-tune and benchmark |
Do mais grave para o menos grave. Cada um tem a prova, uma correção proposta e a issue no repositório que vai corrigir. Situação em 2026-10-16:
| Achado | Situação | |
|---|---|---|
| R1 | mip-solve-perpetual implementa MIPs em rascunho sem ninguém olhando |
corrigido em marola-devkit#142 |
| R2 | voice-to-feature pode abrir e fechar issues |
corrigido em marola-devkit#142 |
| R3 | cópias velhas das skills de MIP na conta claude.ai | na sua conta claude.ai, sem issue |
| R4 | caminhos para uma pasta que mudou de nome | corrigido em marola-devkit#142 |
| R5 | humanizer atrás da versão de origem |
marola-devkit#39; atualizado em #57, e o índice já o mostra atrás de novo |
| R6 | ponytail-review e ponytail-audit atrás da origem |
PR aberto: marola-devkit#141 |
| R7 | sharingan e skill-copy fixam um modelo e o esforço máximo |
aberto: marola-devkit#41 |
| R8 | evals que vêm junto e nunca rodaram aqui | aberto: marola#700 |
| R9 | design-taste-frontend puxa contra as regras do site |
PR aberto: marola-site#152 |
| R10 | duas skills de Mapbox que não servem ao site | PR aberto: marola-site#153 |
| R11 | karpathy-guidelines sem arquivo de licença |
aberto: marola-site#91; a origem não tem o texto da licença |
| R12 | duas skills diferentes chamadas eli5 |
não precisa corrigir |
| R13 | o teste de base do site-frontend foi citado, mas não registrado |
aberto: marola-site#92 |
- Índice: gerado todo dia; todas as skills, com links.
- Auditoria: escrita à mão; origem, versão fixada e testes de cada uma.
- Precisa de revisão: os achados, com prova e correção proposta.
- Graphify: como a marola usa, as regras e o que falta.
- Skills do lago OODS: o que ajuda a montar o lago da MIP-0075.
- Desenvolvimento: como cada situação foi verificada, com os comandos.
A página Agent skills do guarda-chuva diz quando usar cada skill. Este repositório é o inventário e a auditoria.
| Direção | O que passa |
|---|---|
| repositórios → aqui | Só leitura: as skills são lidas do main de cada repositório; nada volta |
| aqui → guarda-chuva | submodule-updated a cada push no main, e submodule-docs-updated quando README.md ou docs/ mudam (notify-umbrella.yml) |
| aqui → devkit | bump-ready quando o CI de um PR de bump do devkit termina verde (bump-ready.yml) |
| devkit → aqui | o marola-devkit, fixado numa tag em flake.nix, nos workflows e em .claude/settings.json |
AGENTS.md tem as regras para agentes que trabalham aqui. Licença MIT; cada skill mantém a licença do repositório onde mora.