convez.ai
SkillProdutividadeAvançado
gabriel-f-santos

Coding Agents — Catálogo de Skills

gabriel-f-santos/coding-agents

Pipeline produto→código modular com skills reutilizáveis versionadas

Ver no GitHub
InicialPluginScore · de 0 a 100

Catálogo curado de Agent Skills reutilizáveis e versionadas para Claude Code, OpenAI Codex e opencode. Implementa um pipeline completo product→build (brainstorming, discovery, PRD, research, planning) com suporte a authoring, security scanning e helpers de infraestrutura. Escreva uma skill uma vez, instale em qualquer projeto.

Instalação

$npx convez-ai gabriel-f-santos/coding-agents

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
7
Contribuidores
1

Casos de uso

  • Validar e estruturar novas ideias de produto (brainstorming → discovery)
  • Gerar PRDs e decisões técnicas granulares de forma consistente
  • Orquestrar arquitetura e planning em equipes multidisciplinares
  • Distribuir capabilities padronizadas entre múltiplos projetos/agentes

Veredito

Projeto ambicioso que traz structure e reusabilidade ao desenvolvimento guiado por IA, cobrindo todo o arco product→code. A modularidade e versionamento das skills reduzem fragmentação; depende de disciplina do time para manter o catálogo canônico e evitar divergências nas cópias distribuídas.

README

A tradução para o português deste README ainda está na fila.

coding-agents — Agent Skills catalog

A curated catalog of portable Agent Skills — reusable, version- controlled capabilities for Claude Code, OpenAI Codex, and opencode. This repo is the central place we author, store, and distribute skills; copy what you need into a project.

Skills live under skills/ (one folder per skill, each with a SKILL.md). Install them into a project's .claude/skills/ (the discovery path) with install-skills.sh.

Fonte da verdade. Este repo é canônico. Edite uma skill aqui; os projetos consumidores (cota8, maripassa, …) recebem cópias via install-skills.sh ou cp -r. Nunca hand-edite a cópia num consumidor — a mudança é feita aqui e copiada de volta.


The flow — product → build

The skills compose into a discovery-to-delivery pipeline. Each stage produces an artifact the next consumes (the feature slug carries through every step):

product-brainstorming ─┐
                       ├─► product-discovery ─► tech-discovery ─► prd-creator ─► research ─► (plan → implement)
ideia / problema       │   discovery brief     tech brief        prd-<slug>.md  decisions
                       │   (problema validado)  (arquitetura)
                       └─ pura ideação
  • product-brainstorming — sparring partner pra explorar o espaço do problema (pura ideação).
  • product-discovery — entrevista o founder (Mom Test/JTBD), faz pesquisa de mercado, gera instrumentos de pesquisa com usuários, e escreve o discovery brief (problema validado).
  • tech-discovery — arquiteto técnico sênior: arquitetura, boundaries, dados, NFRs, STRIDE, riscos/spikes → Tech Discovery Brief.
  • prd-creator — PRD que define o quê construir, no formato da casa.
  • research — decisões técnicas granulares (lib/pattern) por fase, com trade-offs.
  • plan-phase → implement-phase — decompõem e executam (vivem no projeto cota8; opcional aqui).

Fluxos possíveis (entre por onde fizer sentido)

Não precisa rodar o pipeline inteiro — entre no estágio certo pro seu ponto de partida. * = skill fora deste catálogo (vive no cota8).

SituaçãoFluxo
Greenfield (ideia nova, do zero)product-brainstorming → product-discovery → tech-discovery → prd-creator → research → plan-phase* → implement-phase*
Ideia já validada, sistema novotech-discovery → prd-creator → research → plan-phase* → implement-phase*
Feature nova em produto existenteprd-creator → research → plan-phase* → implement-phase*
Feature pequena/clara (decisões óbvias)prd-creator → plan-phase* → implement-phase* (pula research)
Já tem PRD + decisões, só construirplan-phase* → implement-phase*
Iniciar o monorepo do zero (scaffold do esqueleto)greenfield-monorepo (entrevista → apps, AGENTS.md, lint/test/pre-commit, docker+seed, CI)
Só descobrir/validar o problemaproduct-discovery (standalone)
Só explorar/estressar ideiasproduct-brainstorming
Só desenhar/revisar a arquiteturatech-discovery (standalone)
Só uma decisão técnica pontualresearch
Só escrever o PRDprd-creator
Mudança técnica grande num código existentetech-discovery (foco em risco/boundaries) → research → plan-phase*
Criar/melhorar uma skillskill-gen → skill-scanner (auditar antes de distribuir)
Commit / infra (avulsos)commit-message · hetzner-vm · linux-vm-hardening · tailscale-setup

Princípios:

  • Pule estágios quando o artefato já existe (tem PRD? vá pro research/plan; decisões óbvias? pule research).
  • O slug atravessa tudo — discovery-<slug> → tech-discovery-<slug> → prd-<slug> → technical-decisions-<slug> → phase-NN-<slug>.
  • Discovery (produto e técnico) é opcional pra mudanças pequenas; obrigatório pra apostas grandes/irreversíveis.
  • Decisões em duas altitudes (ambas são hard constraints): ADRs (docs/adr/, da tech-discovery) = arquiteturais/irreversíveis; technical-decisions (docs/decisions/, da research) = granulares por fase. research e plan-phase leem ambas e não as reabrem.

Catálogo de skills

Produto → entrega (pipeline)

SkillO que faz
product-discoveryIdéia vaga → discovery brief validado: entrevista (Mom Test/JTBD), pesquisa de mercado, instrumentos de pesquisa com usuários.
tech-discoveryArquiteto técnico: explora opções, desenha C4/boundaries, data model, NFRs+custo, STRIDE, spikes → tech brief.
prd-creatorGera docs/prd-<slug>.md no formato da casa, ancorado no codebase real.
researchPesquisa opções técnicas e gera um doc de decisões (trade-offs) por fase.

Meta — criar e auditar skills

SkillO que faz
skill-genGera e melhora skills portáveis via entrevista; research/grounding (plan→capture→consolidate), iteração por exemplos, otimização de trigger, validação. (repo)
skill-scannerAudita uma skill (prompt injection, código malicioso, permissões, secrets) antes de instalar.
example-skillTemplate mínimo de uma página pra começar uma skill nova.

Dev

SkillO que faz
commit-messageGera mensagem Conventional Commits a partir do diff staged (apresenta; não commita).

Infra

SkillO que faz
hetzner-vmProvisiona VM Hetzner + Coolify via Terraform.
linux-vm-hardeningGera cloud-init.yaml com hardening (UFW, fail2ban, SSH key-only, Docker…).
tailscale-setupConfigura tailnet/VPN de acesso SSH.

skill-gen (a principal de autoria) é portável nos três runtimes e tem o repo dedicado gabriel-f-santos/gen-skill.

Instalar skills num projeto

install-skills.sh copia (ou linka via submódulo) skills daqui para o .claude/skills/ do projeto-alvo — que é o path que Claude Code e opencode descobrem nativamente (Codex usa .codex/skills/ ou uma entrada no config.toml; veja o PORTABILITY.md de cada skill).

# rode a partir do projeto-alvo, apontando pra este repo
./caminho/para/coding-agents/install-skills.sh --list                 # lista o catálogo
./caminho/para/coding-agents/install-skills.sh                        # instala todas
./caminho/para/coding-agents/install-skills.sh tech-discovery prd-creator   # específicas

# ou mantenha em sincronia via submódulo git
./caminho/para/coding-agents/install-skills.sh --submodule tech-discovery

Manualmente, é só copiar a pasta da skill (o nome da pasta tem que bater com o name:):

cp -r coding-agents/skills/tech-discovery <seu-projeto>/.claude/skills/

Portabilidade (Claude Code · Codex · opencode)

O corpo das skills é portável; o controle por plataforma é sidecar:

  • Claude Code / opencode — descobrem em .claude/skills/. allowed-tools só vale no Claude.
  • Codex — copie pra .codex/skills/ ou aponte no config.toml; deps em agents/openai.yaml.
  • Cada skill multi-runtime traz um PORTABILITY.md com o que configurar onde.

Autoria & qualidade

Inspirações & adaptações

Parte do catálogo e do fluxo foi adaptada/inspirada em terceiros — crédito completo em CREDITS.md:

  • Sentry (getsentry/skills) — adaptação direta: skill-scanner, sentry-security-review, e o reporte confidence-based dos reviewers; aprendizado do skill-writer (iteração + description-optimization) foi pra skill-gen.
  • Full Cycle — influência metodológica: DDD/bounded contexts/event-driven → tech-discovery e ddd; os projetos mba-ia-* (refactor, PR evaluation, greenfield) ecoam review-phase, refactor e a mentalidade do pipeline discovery → design → plan → execute.

Skills oficiais recomendadas (não duplicamos — usamos)

Para alguns domínios já existe uma skill oficial do fornecedor, mantida e sincronizada com a doc deles. Em vez de duplicar (e envelhecer), recomendamos instalar a oficial e deixar as nossas cuidarem do workflow (deploy, CI, pipeline).

DomínioSkill oficialDe quem / fonteComo instalar
Cloudflare (Workers/Pages, D1/R2/KV, Workers AI/Agents, DNS, WAF, IaC)cloudflareCloudflare, via marketplace oficial da Anthropic anthropics/claude-plugins-official. Viesada a buscar na doc em tempo real ("trust the docs")./plugin marketplace add anthropics/claude-plugins-official → /plugin install cloudflare@claude-plugins-official

Divisão: a skill oficial cobre profundidade de plataforma/API; as nossas (greenfield-monorepo, github-actions) cobrem o workflow de deploy/CI (wrangler, OIDC, gate por environment). Não criamos uma cloudflare nossa — seria redundante com a oficial.

MCPs e ferramentas recomendadas

Algumas skills descobrem e usam servidores MCP / apps externos em runtime (e degradam de boa se não estiverem conectados). Recomendados:

FerramentaO que éUsada porInstalar / conectar
Context7 (MCP)Docs de libs/frameworks version-specific, em tempo real (melhor que memória)research, tech-discovery, skill-gen (grounding), copilotkitclaude mcp add context7 -- npx -y @upstash/context7-mcp (Upstash) — ou via marketplace oficial
Playwright (MCP)Automação de browser (snapshot, click, navigate, network)e2e-test-review, ux-design (validação visual)claude mcp add playwright -- npx -y @playwright/mcp@latest (Microsoft)
pencil.dev (app + MCP)Ferramenta de design AI-first; gera telas a partir de spec; MCP localpencil, ux-designBaixar o app em pencil.dev; a MCP sobe local e é auto-registrada pela extensão (sem claude mcp add). Abrir com o alias pencil
Figma (MCP) (opcional)Dev Mode MCP — cria/edita framesfigma, ux-designHabilitar o Figma Dev Mode MCP (precisa de seat pago p/ write)

As skills de design (ux-design → pencil/figma) e de docs (research/tech-discovery → context7) fazem descoberta em runtime: usam a MCP se estiver conectada, senão degradam (wireframes textuais / docs por web). Nada quebra se a ferramenta não estiver presente.

Também neste repo

Além do catálogo de skills, o repo mantém:

  • templates/ — templates de projeto (FastAPI, Next.js, Flutter, Fastify) pra início rápido.
  • .claude/ — sistema multi-agente + PRP (agents/, commands/, docs de PRP) usado pelos templates.

Estrutura:

coding-agents/
├── skills/                 # ← o catálogo (uma pasta por skill)
├── install-skills.sh       # instalador (copy ou submódulo)
├── docs/                   # advanced-skill-engineering.md, etc.
├── templates/              # templates de projeto
└── .claude/                # multi-agente + PRP (agents, commands)
Ver o original no GitHub

Bom para

Relacionados