Codex Skill System Bootstrap
Goal
Install a lightweight Codex skill system into a target repository without disrupting the project.
When to use
Use when setting up .agents/skills/, AGENTS.md, project notes, reusable prompts, or validation scripts in another repo.
When not to use
Do not use when the target repo already has a mature agent system and only needs one specific skill update.
Inputs
Inspect the target repo root, existing AGENTS.md, package manager files, .gitignore, docs, and current project conventions.
Workflow
- Detect the target project's stack and package manager.
- Create
.agents/skills/only if missing. - Add a concise
AGENTS.mdif missing or improve it if weak. - Add project state docs only if they will be used.
- Copy only relevant skills, not the whole library by default.
- Add validation scripts that fit the target project.
- Ensure secrets are ignored.
- Document how to use the installed skills.
Quality bar
A good bootstrap is minimal, reversible, and aligned with the target repo's existing conventions.
Validation
Run available package checks and confirm no secret files were copied.
Final response
Report installed files, skipped files, validation commands, and how to start the next Codex session.