Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.copera.ai/llms.txt

Use this file to discover all available pages before exploring further.

copera-ai/copera-skills

Official agent skills for the Copera platform
Copera Skills are portable instruction bundles that teach AI coding agents how to use the copera CLI on a real workspace. They make agents fluent in Copera commands — and let you capture your team’s specific workflows so an agent can repeat them reliably. One source, multiple install paths — see Install for the command for your agent of choice.

Two tiers

The CLI skill

Built-in. Teaches the agent every copera command, the JSON shapes it returns, the discovery-before-write rule, exit-code semantics, and rate-limit behavior. Ships with this repository, works on any workspace.

Workflow skills

User-generated. Capture your workspace structure (this board, that table, those columns) plus a step-by-step procedure (“triage a bug”, “send a weekly report”). Built by interviewing you and probing your workspace. Per-script confirmation flags + reactive schema-drift detection on copera errors.
The CLI skill is the foundation; workflow skills sit on top of it. You install the CLI skill once, then ask any agent that loaded it to build a workflow skill for any procedure you do repeatedly.

Why skills exist

Copera is intentionally unopinionated — no two workspaces look alike. A bare LLM agent given the CLI cannot effectively act on your behalf because:
  • It doesn’t know which board is “the bug tracker” vs “the CRM”.
  • It doesn’t know that column col_a4f2 means “Status” with values Triage / In Progress / Done.
  • It doesn’t know your conventions (“every new bug gets a doc under /Engineering/Bugs/”).
  • Re-discovering all of that costs tokens every single conversation.
Skills are how that workspace knowledge gets captured, versioned, and reused — without leaking secrets, without locking you into a vendor format, without duplicating instructions across tools.

What’s inside the CLI skill

A single router (SKILL.md) plus on-demand reference files:
When the user asks about…The agent reads
Logging in, tokens, profilesreference/auth-and-profiles.md
Boards, tables, column schemasreference/boards-tables.md
Reading, creating, updating rowsreference/rows.md
Markdown documentsreference/docs.md
Drive files and foldersreference/drive.md
Row comments and channel messagesreference/comments-channels.md
Errors, exit codes, rate limitsreference/errors-and-retries.md
Building a custom workflow skillworkflows/build-workflow-skill.md
This progressive disclosure keeps the agent’s base context small — only the relevant reference loads when needed.

Supported agents

AgentHow
Claude CodeNative plugin via /plugin marketplace add
CursorNative plugin via /add-plugin
OpenCodeReads .claude/skills/ natively, or use npx skills add
Codex CLIUniversal install via npx skills add
Windsurf, Cline, Roo, Aider, Continue, othersUniversal install via npx skills add
The same SKILL.md works in every agent — npx skills auto-detects which agents are installed and writes to the right path. See Install for copy-paste commands per agent.

License

Copera Skills are MIT-licensed and developed in the open at github.com/copera-ai/copera-skills. Contributions welcome.

Install

Copy-paste install commands for every supported agent.

Using a skill

How agents discover the skill, plus first-run conventions.

Use cases

Real workflows people run with Copera Skills — boards, docs, drive, knowledge base.

Workflow skills

Capture a reusable workflow with schema-drift detection.