Teach your coding agent the Agentia workflow
Agentia Skills are portable, project-local Markdown playbooks that teach compatible coding agents how to operate Agentia CLI and its MCP tools safely. The generated skills cover Copado CI/CD workflows, Copado Robotic Testing workflows, and Copado AI agents and prompts. They provide command order, prerequisites, workflow boundaries, examples, and guardrails, so agents choose the right CLI or MCP operation, inspect before changing data, keep local and cloud delivery flows separate, and stop for approval before destructive actions.
Agentia Skills
Skill packs
- CICD (
--cicd): User Stories, promotions, jobs, pipelines, deployment steps, and release data. - Testing (
--testing): Copado Robotic Testing projects, tests, jobs, builds, and live testing. - AI (
--ai): Copado AI agents, prompts, workspaces, dialogues, and chat.
Run create without selectors to create all three packs; add selectors to create only those packs. The interactive command asks where to install the skills.
agentia setup skills create
agentia setup skills create \
--cicd \
--testing
Targets
- agents (
.agents/skills): portable, client-neutral skills. - cursor (
.cursor/skills): Cursor project skills. - claude (
.claude/skills): Claude-compatible project skills.
Pass --target (repeatable) with --no-prompt for a non-interactive installation. Without --target in non-interactive or JSON mode, Agentia uses .agents/skills. When the same skill exists in several roots, load only one copy: prefer the client-specific root and use .agents/skills as the portable fallback.
agentia setup skills create \
--target cursor \
--no-prompt
agentia setup skills create \
--target agents \
--target cursor \
--no-prompt
Create and update
Use create for the first installation and update to refresh after upgrading Agentia CLI; both accept the same pack and target options. create adds missing files but leaves existing managed files unchanged. update refreshes managed files and restores missing packaged files. Both preserve unrelated files and stop rather than overwrite an unmanaged file at a packaged path.
agentia setup skills update \
--target agents \
--no-prompt
agentia setup skills update \
--ai \
--target cursor \
--no-prompt
The CLI performs the operation. The local MCP server exposes supported Agentia operations as native tools. Skills tell the agent which operation to choose, in which order, what to inspect first, and which safety constraints apply. Installing a skill never authenticates the CLI, starts MCP, changes Copado data, or runs a deployment.
Safety and limitations
- Skill setup writes only local Markdown files and does not contact Copado gateways.
- It does not read or modify keychain credentials or configure operational authentication.
- There is no MCP setup-skills tool; use the CLI.
- Generated skills are guidance, not permission or policy enforcement.
--force can overwrite custom content at packaged paths. Do not edit Agentia-managed skill files directly.- Inside a Git worktree, files are written at the repository root; outside Git, the current directory is used. Generated files are not committed automatically.
AGENTS.md
AGENTS.md gives AI coding agents project-level workflow and safety guidance. Agentia creates or updates a managed section in the project's root AGENTS.md and keeps the instructions your team wrote outside that section.
Create or update AGENTS.md
Run agentia setup and accept the prompt “Install or update Agentia skills and AGENTS.md workflow guidance?”. This installs or updates the skill packs, lets you choose one or more targets, and creates or refreshes the Agentia-managed section in AGENTS.md, preserving everything outside it. The focused agentia setup skills create and agentia setup skills update commands do not touch AGENTS.md.
What the managed section tells agents
<!-- agentia:managed:start -->
...
<!-- agentia:managed:end -->
- Prefer registered Agentia MCP tools when available, and use CLI
--json for machine-readable operations. - Configure authentication before operational commands, and never expose credentials or tokens.
- Follow the Copado work-item lifecycle.
- Load exactly one copy of each applicable skill, preferring client-specific skills over the portable
.agents/skills fallback. - Treat project rules as higher priority than managed skill guidance.
- Refresh managed skills with
agentia setup skills update.
Existing AGENTS.md files
- Valid managed section: setup replaces only that section; content before and after it is kept.
- No managed section: setup appends the managed section and keeps the existing content.
- Invalid markers: if one of the pair is missing, duplicated, reversed or malformed, setup stops. Repair the markers and run it again.
Add project-specific guidance
Don't edit inside the managed markers: a future setup run can replace that content. Put team rules outside them. Project instructions take precedence over managed skill guidance.
# Project instructions
Use the team's approved branch naming convention.
Run the project regression suite before requesting review.
<!-- agentia:managed:start -->
Agentia-managed content appears here.
<!-- agentia:managed:end -->
## Additional project rules
Document any repository-specific deployment approval requirements here.
- Branching and review requirements.
- Required test and quality-gate commands.
- Project-specific Copado IDs or context that are safe to store.
- Approval requirements for promotion or deployment.
- Documentation and changelog expectations.
- Restrictions on destructive operations.
Never store credentials, API keys, access tokens, session values or other secrets in AGENTS.md.
Update managed guidance
Rerun agentia setup and accept the workflow guidance prompt to refresh the managed section from the template shipped with your installed CLI version. Content outside the markers is kept; review the file before committing it. To refresh only the skill files without changing AGENTS.md:
agentia setup skills update \
--target agents \
--no-prompt
Safety and limitations
AGENTS.md is guidance, not executable policy enforcement, and does not grant Copado permissions or configure credentials.- Only the full setup wizard manages the Agentia section; the focused skill commands do not.
- Content inside the managed section can be replaced by a future setup run; content outside a valid section is preserved.
- Malformed or duplicate markers block the update.
- Setup does not commit generated files automatically.
Read the Agent Skills guide in Docs →