Panoramica Skills

Skill ufficiali per agenti della piattaforma Copera

Copera Skills sono bundle di istruzioni portabili che insegnano agli agenti di coding con IA come usare la copera CLI su un workspace reale. Rendono gli agenti fluenti nei comandi Copera — e ti consentono di catturare i workflow specifici del team così un agente può ripeterli in modo affidabile.

Una sola sorgente, più percorsi di installazione — vedi Installazione per il comando del tuo agente.

Due livelli

La skill CLI

Integrata. Insegna all'agente ogni comando copera, le forme JSON che restituisce, la regola discovery-before-write, la semantica dei codici di uscita e il comportamento dei rate limit. Viene fornita con questo repository e funziona su qualsiasi workspace.

Workflow skills

Generate dall'utente. Catturano la struttura del tuo workspace (questa board, quella table, quelle colonne) più una procedura passo-passo ("triage di un bug", "invio di un report settimanale"). Costruite intervistandoti e sondando il workspace. Flag di conferma per-script + detection reattiva dello schema-drift sugli errori copera.

La skill CLI è le fondamenta; le workflow skill ci si appoggiano sopra. Installi la skill CLI una volta, poi chiedi a qualsiasi agente che l'ha caricata di costruire una workflow skill per qualsiasi procedura che fai ripetutamente.

Perché esistono le skill

Copera è intenzionalmente non opinionata — non esistono due workspace uguali. Un agente LLM nudo a cui dai la CLI non può agire efficacemente per te perché:

Non sa quale board è "il bug tracker" vs "il CRM".
Non sa che la colonna col_a4f2 significa "Status" con valori Triage / In Progress / Done.
Non conosce le tue convenzioni ("ogni nuovo bug ottiene un doc sotto /Engineering/Bugs/").
Riscoprire tutto questo costa token a ogni conversazione.

Le skill sono il modo in cui quella conoscenza del workspace viene catturata, versionata e riutilizzata — senza far trapelare secret, senza chiuderti in un formato vendor, senza duplicare istruzioni tra tool.

Cosa c'è dentro la skill CLI

Un singolo router (SKILL.md) più file di reference on-demand:

When the user asks about…	The agent reads
Logging in, tokens, profiles	`reference/auth-and-profiles.md`
Boards, tables, column schemas	`reference/boards-tables.md`
Reading, creating, updating rows	`reference/rows.md`
Markdown documents	`reference/docs.md`
Drive files and folders	`reference/drive.md`
Row comments and channel messages	`reference/comments-channels.md`
Errors, exit codes, rate limits	`reference/errors-and-retries.md`
Building a custom workflow skill	`workflows/build-workflow-skill.md`

Questa progressive disclosure tiene piccolo il contesto base dell'agente — solo la reference rilevante viene caricata quando serve.

Agenti supportati

Agent	How
Claude Code	Native plugin via `/plugin marketplace add`
Cursor	Native plugin via `/add-plugin`
OpenCode	Reads `.claude/skills/` natively, or use `npx skills add`
Codex CLI	Universal install via `npx skills add`
Windsurf, Cline, Roo, Aider, Continue, others	Universal install via `npx skills add`

Lo stesso SKILL.md funziona in ogni agente — npx skills rileva automaticamente quali agenti sono installati e scrive nel path giusto. Vedi Installazione per i comandi copy-paste per agente.