Resumen de Skills

Skills oficiales de agentes para la plataforma Copera

Las Copera Skills son paquetes de instrucciones portables que enseñan a los agentes de codificación con IA cómo usar la CLI copera en un Workspace real. Hacen que los agentes dominen los comandos de Copera, y te permiten capturar los flujos de trabajo específicos de tu equipo para que un agente los repita de forma confiable.

Una sola fuente, múltiples rutas de instalación: consulta Instalación para el comando del agente de tu elección.

Dos niveles

La Skill de la CLI

Integrada. Enseña al agente cada comando copera, las formas de JSON que devuelve, la regla de descubrimiento-antes-de-escribir, la semántica de los códigos de salida y el comportamiento ante límites de tasa. Viene incluida con este repositorio y funciona en cualquier Workspace.

Skills de flujo de trabajo

Generadas por el usuario. Capturan tu estructura de Workspace (este board, esa tabla, esas columnas) más un procedimiento paso a paso ("clasificar un bug", "enviar un reporte semanal"). Se construyen entrevistándote y explorando tu Workspace. Incluyen flags de confirmación por script + detección reactiva de desfase de esquema ante errores de copera.

La Skill de la CLI es la base; las skills de flujo de trabajo se apoyan sobre ella. Instalas la Skill de la CLI una vez y luego le pides a cualquier agente que la haya cargado que construya una skill de flujo de trabajo para cualquier procedimiento que realices repetidamente.

Por qué existen las skills

Copera es intencionalmente flexible: no hay dos Workspaces iguales. Un agente LLM básico al que se le entrega la CLI no puede actuar eficazmente en tu nombre porque:

No sabe cuál board es "el rastreador de bugs" frente al "CRM".
No sabe que la columna col_a4f2 significa "Estado" con los valores Triage / In Progress / Done.
No conoce tus convenciones ("cada nuevo bug recibe un doc bajo /Engineering/Bugs/").
Volver a descubrir todo eso cuesta tokens en cada conversación.

Las skills son la forma en que ese conocimiento del Workspace se captura, versiona y reutiliza, sin filtrar secretos, sin atarte a un formato propietario y sin duplicar instrucciones entre herramientas.

Qué hay dentro de la Skill de la CLI

Un único enrutador (SKILL.md) más archivos de referencia bajo demanda:

Cuando el usuario pregunta sobre…	El agente lee
Inicio de sesión, tokens, perfiles	`reference/auth-and-profiles.md`
Boards, tablas, esquemas de columnas	`reference/boards-tables.md`
Leer, crear, actualizar filas	`reference/rows.md`
Documentos Markdown	`reference/docs.md`
Archivos y carpetas de Drive	`reference/drive.md`
Comentarios de filas y mensajes de Channels	`reference/comments-channels.md`
Errores, códigos de salida, límites de tasa	`reference/errors-and-retries.md`
Construir una skill de flujo de trabajo personalizada	`workflows/build-workflow-skill.md`

Esta divulgación progresiva mantiene pequeño el contexto base del agente: solo se carga la referencia relevante cuando se necesita.

Agentes compatibles

Agente	Cómo
Claude Code	Plugin nativo mediante `/plugin marketplace add`
Cursor	Plugin nativo mediante `/add-plugin`
OpenCode	Lee `.claude/skills/` de forma nativa, o usa `npx skills add`
Codex CLI	Instalación universal mediante `npx skills add`
Windsurf, Cline, Roo, Aider, Continue, otros	Instalación universal mediante `npx skills add`

El mismo SKILL.md funciona en todos los agentes: npx skills detecta automáticamente qué agentes están instalados y escribe en la ruta correcta. Consulta Instalación para comandos listos para copiar y pegar por agente.