005 Agents Installation

---
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.19.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

1. **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

2. **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.

3. **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](references/005-agents-installation.md).