Ag Curador Skills

ag-curador-skills — Curador Trimestral de Skills

Maquina de curadoria do ecossistema Claude Code. Coleta skills externas lancadas por Anthropic e comunidade, compara com o sistema ag-* local, e recomenda decisoes de absorcao, wrapper ou ignorar. NAO instala automaticamente — toda acao passa por aprovacao do usuario.

Modos

| Modo | Scope | Tempo estimado | |------|-------|----------------| | --quick | Anthropic oficial + top awesome-list | ~15 min | | --full | Todos os sources (default trimestral) | ~45 min | | --diff | Compara contra report anterior, mostra apenas novidades | ~10 min |

Uso:

/ag-curador-skills              # full (trimestral)
/ag-curador-skills --quick      # scan rapido
/ag-curador-skills --diff       # so novidades desde o ultimo report

---

Pipeline (4 fases)

Fase 1: COLETA

Buscar skills externas nos seguintes sources.

Para modo --quick: fontes A + B apenas. Para modo --full: fontes A, B, C, D + WebSearch. Para modo --diff: mesmos sources que --full, mas filtrar por data > ultima execucao.

Fontes

A. Anthropic Oficial

WebFetch: https://github.com/anthropics/skills

Coletar: nome, descricao, status (released/beta), data de lancamento, URL.

B. VoltAgent Awesome List

WebFetch: https://github.com/VoltAgent/awesome-agent-skills

Coletar: nome, descricao, autor, stars, ultima atualizacao, URL.

C. Composio Awesome Claude Skills

WebFetch: https://github.com/ComposioHQ/awesome-claude-skills

Coletar: nome, descricao, autor, stars, ultima atualizacao, URL.

D. Travis VQ (Community Curator)

WebFetch: https://github.com/travisvq (listar repos relevantes)

Filtrar repos com "skill" ou "claude" no nome ou descricao.

E. WebSearch (modo --full)

WebSearch: "claude code skill" filtrado por 90 dias
WebSearch: "site:github.com claude skill" filtrado por 90 dias

Coletar: URL, titulo, data, descricao resumida.

Estrutura de cada skill coletada

{
  "name": "string",
  "description": "string",
  "author": "string",
  "stars": "number | null",
  "last_updated": "YYYY-MM-DD | null",
  "source": "anthropic-official | plugin | community",
  "canonical_url": "string"
}

---

Fase 2: COMPARACAO

**1. Listar skills ag- locais:*

ls ~/Claude/.claude/skills/ | sort

2. Para cada skill coletada na Fase 1, classificar:

| Classificacao | Criterio | |---------------|---------| | DUPLICATA | Temos skill ag-* com escopo equivalente (>=80% de sobreposicao funcional) | | GAP | Nao temos skill equivalente E faz sentido para nosso dominio (educacional/RH/BI/TOTVS) | | IRRELEVANTE | Nao se aplica ao dominio (ex: Remotion videos, jogos, IoT) | | WRAPPER | Temos skill equivalente, mas a skill externa tem patterns ou tecnicas que melhorariam a nossa |

Regras de classificacao:

• Se a skill e uma subcategoria de algo que ag-0-orquestrador ja cobre → DUPLICATA
• Se a skill resolve problema que usuarios do workspace solicitam regularmente → GAP
• Se a skill usa tecnica nova (ex: novo padrao de RAG, novo protocolo de tool use) mas escopo e duplicado → WRAPPER
• Se a skill foi lancada por Anthropic oficial E nao e DUPLICATA → prioridade alta como GAP
• Em caso de duvida: IRRELEVANTE (menos ruido no report final)

---

Fase 3: AVALIACAO

Para skills classificadas como GAP ou WRAPPER:

1. Analisar conteudo (WebFetch do README/SKILL.md da skill):

• Frontmatter (model, tools, parametros)
• Descricao do pipeline (fases, logica)
• Exemplos de uso
• Dependencias externas

2. Calcular score 1-5 em 3 dimensoes:

| Dimensao | O que avaliar | |----------|--------------| | Relevancia | Quanto se aplica ao dominio educacional/TOTVS/BI do workspace | | Qualidade | Estrutura do SKILL.md, clareza do pipeline, uso de boas praticas | | Manutencao | Data da ultima atualizacao, issues abertas, evidencias de uso ativo |

Score total = media das 3 dimensoes (arredondar para 1 casa decimal).

3. Recomendacao final:

| Criterio | Recomendacao | |----------|-------------| | Score >= 4.0 E Relevancia >= 4 | ABSORVER — criar nova skill ag- baseada nesta | | Score >= 3.0 E classificacao WRAPPER | CRIAR-WRAPPER — evoluir skill ag- existente absorvendo patterns | | Score = 4.5)

• [ ] [nome] — [acao: /ag-1-construir feature ou /ag-1-construir refatorar]
• Razao: ...
• Analogia ag-* local: ...

P1 — Media prioridade (Score 3.5-4.4)

• [ ] [nome] — ...

P2 — Baixa prioridade (Score 3.0-3.4)

• [ ] [nome] — ...

Anti-Recomendacoes

Skills que parecem boas mas nao se aplicam ao nosso contexto:

• [nome]: [razao de nao ser relevante]

Metodologia

Sources consultados: [lista] Data de corte para --diff: [data do report anterior, se --diff] Skills locais ag-* comparadas: N

---

## Composicao com Sistema ag

### Output

- Report gerado em `~/Claude/docs/workspace/` (path cross-project, permitido por `docs-location-guard.sh`)
- Report NAO modifica skills automaticamente
- Report NAO cria branches ou PRs

### Acao apos aprovacao do usuario

Quando usuario aprova recomendacao `ABSORVER`:

/ag-1-construir feature "nova skill ag-X baseada em [nome-externo]"

Quando usuario aprova recomendacao `CRIAR-WRAPPER`:

/ag-1-construir refatorar "evoluir ag-Y absorvendo patterns de [nome-externo]"

### Registro de decisoes

Para cada skill com recomendacao `ABSORVER` ou `CRIAR-WRAPPER` que o usuario REJEITAR,
registrar motivo no report como `DESCARTADO: [motivo]` para evitar re-avaliacao no proximo trimestre.

---

## Quando Rodar

- **Trimestral**: 1o dia de cada trimestre (jan/abr/jul/out), 09h — via `/schedule`
- **On-demand**: quando usuario pergunta "quais skills novas?", "estamos atualizados?", "o que a comunidade lancou?"
- **Apos release major Anthropic**: quando Anthropic anunciar novo modelo ou update de Claude Code

---

## Anti-Patterns

- **Instalar automaticamente** — toda absorcao requer aprovacao explicita do usuario
- **Confiar em stars sem ler conteudo** — popular != relevante para nosso dominio especifico
- **Duplicar skills sem comparar** — SEMPRE verificar se `ag-*` equivalente existe antes de propor nova
- **Ignorar skills oficiais Anthropic** — mesmo que parecam simples, geralmente sao baseline de boas praticas
- **Re-avaliar skills ja rejeitadas** — registrar DESCARTADO no report para skip no proximo ciclo
- **Propor skills de dominio totalmente diferente** — Remotion, jogos, robotica = IRRELEVANTE direto
- **Score inflado por novidade** — skill lancada ha 2 semanas sem uso comprovado = penalizar Manutencao

---

## Cron Suggestion

Apos a primeira execucao, sugerir ao usuario:

Quer agendar /ag-curador-skills --full trimestralmente? 1o de jan/abr/jul/out, 09h00 Via /schedule para criar rotina automatica.

Nao criar o agendamento automaticamente — aguardar confirmacao.

---

## Estado Persistente

Para suportar `--diff`, registrar metadata apos cada execucao:

~/.claude/state/skills-curadoria-last-run.json { "lastrun": "YYYY-MM-DD", "mode": "full", "reportpath": "~/Claude/docs/workspace/skills-curadoria-YYYY-MM-DD.md", "skillscollected": N, "skillsrecommended": N }

`--diff` le `last_run` e filtra sources por data > `last_run`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [andregusman-raiz](https://github.com/andregusman-raiz)
- **Source:** [andregusman-raiz/a-gusman-claude](https://github.com/andregusman-raiz/a-gusman-claude)
- **License:** MIT

Install and usage instructions live in the source repository linked above.