Toolkit Setup

Toolkit Setup

Set up the current autopilot-toolkit checkout for local development. Run inside the repository and use its deploy.rs; do not recreate installation logic manually.

Contract

• All skills are discoverable from ${AGENTS_SKILLS_DIR:-$HOME/.agents/skills}.
• A runtime-coupled skill has one installed SKILL.md router.
• Runtime bodies live at runtime/<runtime>/INSTRUCTIONS.md and are not independently discoverable.
• Do not create coupled-skill links in ~/.codex/skills/ or ~/.reasonix/skills/.
• Codex custom agents remain links in ${CODEX_AGENTS_DIR:-$HOME/.codex/agents}.
• Preserve real user files and unrelated symlinks.

Procedure

1. Resolve PROJECT_ROOT to the repository root and confirm these files exist: deploy.rs, .skill-lock.json, .vendor-lock.json, skills/autopilot/, and skills/vendor/.

2. Inspect git status --short. Report existing changes, but do not discard or overwrite them.

3. Run:

   rust-script "$PROJECT_ROOT/deploy.rs" dev
   rust-script "$PROJECT_ROOT/deploy.rs" link-principles "$PROJECT_ROOT/principles"
   

4. Enumerate the Expected set through the toolkit's own enumerator (skill-index's discover_skills, reaching it via deploy.rs output or a small rust-script probe). Read each entry's facts from that enumeration — its Skill source, its Skill files and their kinds, and any missing skill file — instead of re-deriving names or instruction files from the lock files and a directory scan. Do not hardcode the list. Vendor directories without a .vendor-lock.json entry are orphans — report them, do not install them.

5. Verify every enumerated entry resolves all its Skill files, and that every expected shared entry is a valid directory or symlink.

6. For every Skill file whose kind is an agent definition (agent.toml), check the codex agent link rather than an instruction file. For every entry that owns runtime variant skill files, verify:

   • the installed tree contains exactly one file named SKILL.md;
   • runtime/default/INSTRUCTIONS.md exists;
   • each enumerated variant skill file has a corresponding installed runtime/<variant>/INSTRUCTIONS.md;
   • no same-name entry exists in the Codex or Reasonix exclusive skill directory.

7. For every enumerated agent definition, verify the corresponding ~/.codex/agents/<skill>.toml link.

8. Verify ${AGENTS_PRINCIPLES_DIR:-$HOME/.agents/principles} points to $PROJECT_ROOT/principles.

If deploy.rs dev reports a real-directory or real-file conflict, do not replace it. Report the exact path and leave verification failed until the user resolves ownership.

Cleanup

When explicitly asked to remove development links, run:

rust-script "$PROJECT_ROOT/deploy.rs" dev-clean

This removes only links pointing into the current checkout.

Report

Return a compact report containing:

TOOLKIT_SETUP_REPORT
Expected: <count>
Actions: <dev/link-principles actions>
Routers: <count passed>, <count failed>
Codex agents: <count passed>, <count failed>
Principles: PASS|FAIL
Warnings: <paths or none>
Result: ALL PASS|FAILED