# Ag Curador Skills

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-andregusman-raiz-a-gusman-claude-ag-curador-skills`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [andregusman-raiz](https://agentstack.voostack.com/s/andregusman-raiz)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [andregusman-raiz](https://github.com/andregusman-raiz)
- **Source:** https://github.com/andregusman-raiz/a-gusman-claude/tree/main/skills/ag-curador-skills

## Install

```sh
agentstack add skill-andregusman-raiz-a-gusman-claude-ag-curador-skills
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```json
{
  "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:**

```bash
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
{
  "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`.

## 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.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-andregusman-raiz-a-gusman-claude-ag-curador-skills
- Seller: https://agentstack.voostack.com/s/andregusman-raiz
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.