docs: add skill manager documentation

2026-04-23 21:27:52 -05:00
parent f01721a45b
commit 494e29f797
7 changed files with 423 additions and 1 deletions
@@ -0,0 +1,61 @@
+# Codex Manual Install
+
+## Skill Root
+
+Codex skills are installed under:
+
+```bash
+~/.codex/skills/<skill-name>/
+```
+
+Manual install example:
+
+```bash
+mkdir -p ~/.codex/skills/create-plan
+cp -R skills/create-plan/codex/* ~/.codex/skills/create-plan/
+```
+
+Repeat with `skills/<skill>/codex/*` for `atlassian`, `create-plan`, `do-task`, `implement-plan`, and `web-automation`.
+
+## Reviewer Runtime
+
+Workflow skills need the shared runtime helpers:
+
+```bash
+mkdir -p ~/.codex/skills/reviewer-runtime
+cp skills/reviewer-runtime/run-review.sh ~/.codex/skills/reviewer-runtime/
+cp skills/reviewer-runtime/notify-telegram.sh ~/.codex/skills/reviewer-runtime/
+chmod +x ~/.codex/skills/reviewer-runtime/*.sh
+```
+
+## Superpowers
+
+Workflow skills require Obra Superpowers. Codex variants expect the shared root:
+
+```bash
+mkdir -p ~/.agents/skills
+ln -s /absolute/path/to/obra/superpowers/skills ~/.agents/skills/superpowers
+```
+
+Verify planning skills:
+
+```bash
+test -f ~/.agents/skills/superpowers/brainstorming/SKILL.md
+test -f ~/.agents/skills/superpowers/writing-plans/SKILL.md
+```
+
+Verify execution skills:
+
+```bash
+test -f ~/.agents/skills/superpowers/test-driven-development/SKILL.md
+test -f ~/.agents/skills/superpowers/verification-before-completion/SKILL.md
+test -f ~/.agents/skills/superpowers/finishing-a-development-branch/SKILL.md
+```
+
+## Verify
+
+```bash
+test -f ~/.codex/skills/create-plan/SKILL.md
+test -x ~/.codex/skills/reviewer-runtime/run-review.sh
+codex --version
+```