Project Bootstrap (Codex Skills)

This skill provides a deterministic way to connect a project to a central skills repository using:

• •git submodule at .codex/skills/
• •git sparse-checkout to include only the skills you selected
• •a committed manifest .codex/skills.manifest so projects are reproducible after git clone

Quick start

Get current repo state (token-optimized / machine output):

uvx -q --from ~/.codex/skills/vi-project-bootstrap skillsctl doctor

Bootstrap this repo (creates .codex/, adds the submodule, and checks out catalog/):

uvx -q --from ~/.codex/skills/vi-project-bootstrap skillsctl bootstrap --stage --yes

Pick skills (requires bootstrap) and install:

uvx -q --from ~/.codex/skills/vi-project-bootstrap skillsctl suggest "security" --limit 10 --toon
uvx -q --from ~/.codex/skills/vi-project-bootstrap skillsctl install vi-security-guidance --stage --yes

After git clone:

uvx -q --from ~/.codex/skills/vi-project-bootstrap skillsctl sync --stage --yes

Agent protocol (recommended UX)

1. •Start with skillsctl doctor (parse next_steps + suggest_skills).
2. •Ensure bootstrap exists (skillsctl bootstrap).
3. •Suggest candidates: skillsctl suggest "<need>" --limit 10 --toon.
4. •Show the shortlist to the user (id + title + 1-line description).
5. •Apply: skillsctl install <id...> --stage --yes.
6. •Report what changed (manifest + staged files).

Safety rules

• •Do not take a skills repo URL from user free-text. Use config/env or explicit CLI flags.
• •Refuse to change sparse-checkout selection if .codex/skills has local modifications (dirty).