> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral das Skills

> Skills ensinam novas capacidades ao Claude via instruções em markdown

# Visão Geral das Skills

Skills ensinam novas capacidades ao Claude via instruções em markdown. Não são plugins nem código — são prompts estruturados que o Claude segue quando uma skill é disparada.

## O que é uma Skill?

Uma skill é um diretório em `.claude/skills/` contendo um arquivo `SKILL.md` com:

* **Frontmatter** (`name`, `description`) que controla quando a skill dispara
* **Instruções** que dizem ao Claude exatamente o que fazer, passo a passo

```
.claude/skills/
  fin-daily-pulse/
    SKILL.md          # A definição da skill
  social-post-writer/
    SKILL.md
  int-stripe/
    SKILL.md
```

## Categorias de Skills

Skills são organizadas por prefixo:

O repo entrega **175+ skills** no total: **\~150 skills de negócio** + **25 skills de engenharia (`dev-*`)**.

### Skills da Business Layer

| Prefixo | Categoria | Quantidade | Exemplos |
| - | - | - | - |
| `social-` | Redes sociais | \~17 | `social-post-writer`, `social-analytics-report` |
| `int-` | Integrações | \~13 | `int-stripe`, `int-discord`, `int-youtube` |
| `fin-` | Finanças | \~11 | `fin-daily-pulse`, `fin-weekly-report`, `fin-reconciliation` |
| `prod-` | Produtividade | \~9 | `prod-good-morning`, `prod-end-of-day`, `prod-dashboard` |
| `ops-` | Operações | \~9 | `ops-status-report`, `ops-runbook`, `ops-risk-assessment` |
| `legal-` | Jurídico / Compliance | \~9 | `legal-review-contract`, `legal-triage-nda`, `legal-brief` |
| `hr-` | RH / Pessoas | \~9 | `hr-recruiting-pipeline`, `hr-onboarding`, `hr-comp-analysis` |
| `mkt-` | Marketing | \~8 | `mkt-campaign-plan`, `mkt-seo-audit`, `mkt-content-creation` |
| `data-` | Dados / BI | \~7 | `data-analyze`, `data-build-dashboard`, `data-statistical-analysis` |
| `gog-` | Google (Gmail, Calendar) | \~6 | `gog-email-triage`, `gog-calendar`, `gog-tasks` |
| `pm-` | Product Management | \~6 | `pm-write-spec`, `pm-metrics-review`, `pm-roadmap-update` |
| `cs-` | Customer Success | \~5 | `cs-ticket-triage`, `cs-customer-escalation`, `cs-kb-article` |
| `obs-` | Obsidian | \~5 | `obs-obsidian-cli`, `obs-obsidian-markdown` |
| `discord-` | Discord | \~5 | `discord-get-messages`, `discord-send-message` |
| `pulse-` | Comunidade | \~4 | `pulse-daily`, `pulse-weekly`, `pulse-monthly` |
| `sage-` | Estratégia | \~3 | `sage-okr-review`, `sage-strategy-digest` |

### Skills da Engineering Layer (`dev-*`)

Derivadas do [oh-my-claudecode](https://github.com/yeachan-heo/oh-my-claudecode) (MIT, Yeachan Heo). Veja [Engineering Layer](../agents/engineering-layer) para a história completa.

| Tier | Quantidade | Skills |
| - | - | - |
| **Tier 1 — Orquestração core** | 15 | `dev-autopilot`, `dev-plan`, `dev-ralplan`, `dev-deep-interview`, `dev-deep-dive`, `dev-external-context`, `dev-trace`, `dev-verify`, `dev-ultraqa`, `dev-visual-verdict`, `dev-ai-slop-cleaner`, `dev-sciomc`, `dev-team`, `dev-ccg`, `dev-ralph` |
| **Tier 2 — Setup & infra** | 5 | `dev-mcp-setup`, `dev-deepinit`, `dev-project-session-manager`, `dev-configure-notifications`, `dev-release` |
| **Tier 3 — Meta / utilitárias** | 5 | `dev-cancel`, `dev-remember`, `dev-ask`, `dev-learner`, `dev-skillify` |

## Como o Trigger Funciona

O campo `description` no frontmatter do SKILL.md diz ao Claude quando ativar a skill. O Claude casa a intenção do usuário contra todas as descrições de skill e escolhe a melhor.

Exemplo de `fin-daily-pulse`:

```yaml theme={null}
---
name: fin-daily-pulse
description: "Pulso financeiro diário — consulta Stripe (MRR, cobranças, churn, falhas) e Omie (contas a pagar/receber, notas) para gerar um snapshot HTML da saúde financeira da empresa. Acione quando o usuário disser 'pulso financeiro', 'snapshot financeiro' ou 'métricas financeiras'."
---
```

Dicas-chave para boas descrições:

* Diga o que a skill faz concretamente
* Liste frases-gatilho que o usuário pode dizer
* Seja específico o suficiente para evitar sobreposição com outras skills

## Estrutura do SKILL.md

```markdown theme={null}
---
name: my-skill-name
description: "O que faz e quando acionar."
---

# Título da Skill

Breve descrição do que a skill produz.

## Passo 1 — Coletar Dados

Instruções do primeiro passo...

## Passo 2 — Processar

Instruções de processamento...

## Passo 3 — Gerar Saída

Onde e como salvar a saída...

## Passo 4 — Confirmar

O que mostrar para o usuário ao terminar...
```

## Criando uma Nova Skill

### 1. Crie o diretório e o arquivo

```bash theme={null}
mkdir -p .claude/skills/my-new-skill
```

### 2. Escreva o SKILL.md

```markdown theme={null}
---
name: my-new-skill
description: "Gerar um resumo semanal de standup do time a partir de issues do Linear e PRs do GitHub. Acione quando o usuário disser 'resumo de standup', 'update do time' ou 'o que o time fez'."
---

# Resumo de Standup do Time

Gera um resumo semanal da atividade do time.

## Passo 1 — Coletar Dados do Linear

Use a skill `/int-linear-review` para buscar:
- Issues concluídas esta semana
- Issues em progresso
- Bloqueios

## Passo 2 — Coletar Dados do GitHub

Use a skill `/int-github-review` para buscar:
- PRs mergeados esta semana
- PRs em review

## Passo 3 — Gerar Resumo

Formate como relatório markdown com seções:
- Concluído
- Em Progresso
- Bloqueado
- Destaques

## Passo 4 — Salvar

Salve em `workspace/projects/reports/[C] YYYY-MM-DD-standup.md`
```

### 3. Teste

Abra o Claude Code e diga: "gerar um resumo de standup" — o Claude deve casar com a descrição da sua skill e seguir as instruções.

## Skills vs Agentes

| | Agente | Skill |
| - | - | - |
| **O que é** | Persona com identidade e memória | Instruções passo a passo |
| **Escopo** | Domínio amplo (finanças, comunidade) | Tarefa específica (pulso diário, post writer) |
| **Memória** | Persistente entre sessões | Nenhuma (stateless) |
| **Invocada por** | Slash command ou auto-routing | Match de descrição ou delegação por agente |

Skills são frequentemente usadas *por* agentes. Por exemplo, o agente Flux usa as skills `fin-daily-pulse`, `fin-weekly-report` e `int-stripe` para fazer seu trabalho. Rotinas invocam skills através de agentes via o runner.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.