ag-curador-skills

name	ag-curador-skills
description	Curador trimestral de skills externas (Anthropic + comunidade). Avalia o que pegou no ecossistema, compara com sistema ag local, e recomenda absorver/wrapper/ignorar. Nao instala automaticamente.
model	sonnet
cache_policy	{"enabled":false}
argument-hint	[--quick | --full | --diff]
allowed-tools	Read, Write, Bash, WebFetch, WebSearch

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 < 3.0 OU Relevancia <= 2	IGNORAR

---

Fase 4: REPORT

Gerar arquivo em:

~/Claude/docs/workspace/skills-curadoria-YYYY-MM-DD.md

Estrutura do report

# Skills Curadoria — YYYY-MM-DD
**Modo:** [quick/full/diff] | **Skills coletadas:** N | **Skills avaliadas:** N

## Sumario Executivo

Top 5 recomendacoes:
1. [skill-name] — ABSORVER — [razao em 1 linha]
2. ...

## Tabela Completa

| Skill | Origem | Classificacao | Score | Recomendacao |
|-------|--------|---------------|-------|--------------|
| nome  | official/community | GAP/WRAPPER/DUPLICATA/IRRELEVANTE | 4.2 | ABSORVER |

## Plano de Acao

### P0 — Alta prioridade (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
{
  "last_run": "YYYY-MM-DD",
  "mode": "full",
  "report_path": "~/Claude/docs/workspace/skills-curadoria-YYYY-MM-DD.md",
  "skills_collected": N,
  "skills_recommended": N
}

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