Visão Geral das Skills

Skills oficiais de agente para a plataforma Copera

Copera Skills são pacotes portáteis de instruções que ensinam agentes de IA de programação a usar a copera CLI em um workspace real. Eles tornam os agentes fluentes nos comandos da Copera — e permitem que você capture os workflows específicos do seu time para que um agente possa repeti-los de forma confiável.

Uma fonte, múltiplos caminhos de instalação — veja Instalar para o comando do seu agente de escolha.

Dois níveis

A skill da CLI

Embutida. Ensina ao agente todo comando copera, os formatos JSON que ele retorna, a regra de descoberta-antes-da-escrita, a semântica dos códigos de saída e o comportamento de limite de taxa. Vem com este repositório, funciona em qualquer workspace.

Skills de workflow

Geradas pelo usuário. Capturam a estrutura do seu workspace (este board, aquela tabela, aquelas colunas) mais um procedimento passo a passo ("triar um bug", "enviar um relatório semanal"). Construídas entrevistando você e sondando seu workspace. Flags de confirmação por script + detecção reativa de mudança de schema em erros do copera.

A skill da CLI é a base; as skills de workflow ficam por cima dela. Você instala a skill da CLI uma vez, depois pede a qualquer agente que a carregou para construir uma skill de workflow para qualquer procedimento que você faz repetidamente.

Por que as skills existem

A Copera é intencionalmente sem opinião — não há dois workspaces iguais. Um agente LLM básico ao qual se dá a CLI não consegue agir efetivamente em seu nome porque:

Ele não sabe qual board é "o rastreador de bugs" vs. "o CRM".
Ele não sabe que a coluna col_a4f2 significa "Status" com os valores Triage / In Progress / Done.
Ele não conhece suas convenções ("todo novo bug ganha um doc em /Engineering/Bugs/").
Redescobrir tudo isso custa tokens em cada conversa.

As skills são como esse conhecimento do workspace é capturado, versionado e reutilizado — sem vazar segredos, sem prender você a um formato de fornecedor, sem duplicar instruções entre ferramentas.

O que tem dentro da skill da CLI

Um único roteador (SKILL.md) mais arquivos de referência sob demanda:

Quando o usuário pergunta sobre…	O agente lê
Login, tokens, perfis	`reference/auth-and-profiles.md`
Boards, tabelas, schemas de colunas	`reference/boards-tables.md`
Ler, criar, atualizar linhas	`reference/rows.md`
Documentos markdown	`reference/docs.md`
Arquivos e pastas do drive	`reference/drive.md`
Comentários de linha e mensagens de channel	`reference/comments-channels.md`
Erros, códigos de saída, limites de taxa	`reference/errors-and-retries.md`
Construir uma skill de workflow customizada	`workflows/build-workflow-skill.md`

Essa divulgação progressiva mantém o contexto base do agente pequeno — apenas a referência relevante é carregada quando necessário.

Agentes suportados

Agente	Como
Claude Code	Plugin nativo via `/plugin marketplace add`
Cursor	Plugin nativo via `/add-plugin`
OpenCode	Lê `.claude/skills/` nativamente, ou use `npx skills add`
Codex CLI	Instalação universal via `npx skills add`
Windsurf, Cline, Roo, Aider, Continue, outros	Instalação universal via `npx skills add`

O mesmo SKILL.md funciona em todo agente — npx skills detecta automaticamente quais agentes estão instalados e escreve no caminho certo. Veja Instalar para comandos de copiar e colar por agente.