| name | 005-agents-installation |
| description | Use when you need to install the embedded robot agents into .github/agents, .claude/agents, .cursor/agents, or .codex/agents, selecting the destination interactively and copying the embedded agent definitions from project assets. This should trigger for requests such as Install embedded agents; Bootstrap .github/agents; Bootstrap .cursor/agents; Bootstrap .claude/agents; Bootstrap .codex/agents; Copy robot agents. Part of Plinth Toolkit |
| license | Apache-2.0 |
| metadata | {"author":"Juan Antonio Breña Moral","version":"0.17.0"} |
Embedded agents installer
Install a predefined set of embedded agent definitions from repository assets into a user-selected target directory. This is an interactive skill.
What is covered in this Skill?
- Interactive target selection (
.github/agents, .claude/agents, .cursor/agents, or .codex/agents)
- Deterministic copy of all embedded agents defined via XInclude from
assets/agents
- Idempotent re-installation with clear overwrite reporting
Constraints
This skill installs only the embedded robot agents bundle and must ask for destination before writing files.
- MUST ask the user to choose
.github/agents, .claude/agents, .cursor/agents, or .codex/agents before installing
- MUST copy all embedded agent files defined in
references/005-agents-installation.md
- MUST preserve file names from the reference content and report overwrite actions
When to use this skill
- Install embedded agents
- Bootstrap .github/agents
- Bootstrap .cursor/agents
- Bootstrap .claude/agents
- Bootstrap .codex/agents
- Copy robot agents
Workflow
- Choose destination
Ask exactly one question to choose .github/agents, .claude/agents, .cursor/agents, or .codex/agents and wait for an explicit answer before copying files.
Step constraints:
- Do not copy any file until destination is explicitly confirmed
- If destination is ambiguous, ask a clarification question
- Install embedded agents
Create the destination directory if needed, then copy all embedded agent files defined in the reference content, preserving filenames and warning before overwriting existing files.
- Report installation result
Return a concise checklist with selected destination, created/updated files, overwrite actions, and an optional verification command.
Reference
For detailed guidance, examples, and constraints, see references/005-agents-installation.md.
