O que é uma "skill" no contexto de IA e como você constrói uma para seu fluxo de trabalho?

Question

Accepted Answer

Uma **skill** empacota um fluxo de trabalho reutilizável e sob demanda para um agente de IA: **instruções** para uma tarefa recorrente (quando e como fazer), mais **scripts ou recursos opcionais** que o agente carrega apenas quando a tarefa é relevante. É a diferença entre re-explicar um procedimento toda vez e ensiná-lo uma única vez.

## O que é uma skill

```text
SKILL = a self-contained folder the agent can pull in on demand:
  SKILL.md   → metadata + instructions (the TRIGGER + the STEPS)
  scripts/   → optional helper scripts the agent runs (e.g. a linter, a generator)
  resources/ → optional templates, examples, reference files
→ loaded ONLY when relevant → keeps the base context small, the workflow repeatable
```

O benefício é **divulgação progressiva**: o agente sabe que a skill *existe* a partir de uma descrição curta, e puxa as instruções completas e scripts apenas quando uma tarefa correspondente aparece — então dezenas de skills não incham cada conversa.

## Construindo uma

Uma skill tem três partes: o **gatilho** (quando), os **passos** (como) e quaisquer **scripts auxiliares** (ferramentas). Mantenha focado e composável — um trabalho bem feito, não uma bagunça.

```markdown
---
name: changelog-entry
description: Add a CHANGELOG entry. Use when finishing a user-facing change.
---
# Add a changelog entry

## Steps
1. Read the latest commits since the last release tag.
2. Categorize each as Added / Changed / Fixed.
3. Prepend a dated section to CHANGELOG.md under [Unreleased].
4. Run `scripts/validate.sh` to check the format.
```

A `description` é o **gatilho** — ela diz ao agente quando usar esta skill. A lista numerada são os **passos**, e `validate.sh` é um **script auxiliar** que garante a correção para que o agente não tenha que raciocinar sobre o formato do zero. Como a skill é pequena e com um único propósito, se compõe bem com outras (por exemplo, uma skill "release" separada pode chamá-la).

## Por que isso importa

Skills transformam um agente de um assistente geral que você precisa re-explicar constantemente em um que conhece *seus* procedimentos recorrentes. Ao empacotar o gatilho, passos e scripts em uma unidade focada e composável que carrega apenas sob demanda, você codifica conhecimento institucional uma vez e o reutiliza de forma confiável — obtendo resultados consistentes em tarefas repetitivas sem re-explicá-las e sem pagar o custo de contexto de cada fluxo de trabalho em cada solicitação.