docs: add skill manager documentation

This commit is contained in:
Stefano Fiorini
2026-04-23 21:27:52 -05:00
parent f01721a45b
commit 494e29f797
7 changed files with 423 additions and 1 deletions
+17 -1
View File
@@ -122,15 +122,31 @@ Use the repository skill manager to install, update/reinstall, or remove skills
node scripts/manage-skills.mjs
```
Useful non-interactive modes:
Useful non-interactive modes and examples:
```bash
# Preview detected clients and planned changes without writing files
node scripts/manage-skills.mjs --dry-run
# Emit a machine-readable operation plan from an answers file
node scripts/manage-skills.mjs --plan-only --answers answers.json
# Install/update a skill for a specific client
node scripts/manage-skills.mjs --client codex --scope global --skill create-plan --action install --yes
node scripts/manage-skills.mjs --client codex --scope global --skill create-plan --action update --yes
# Remove a skill from a specific client
node scripts/manage-skills.mjs --client claude-code --scope global --skill do-task --action remove --yes
# Install the Pi package globally or project-locally through the manager
node scripts/manage-skills.mjs --client pi --scope packageGlobal --pi-package --action install --yes
node scripts/manage-skills.mjs --client pi --scope packageLocal --pi-package --action install --yes
```
The wizard detects Codex, Claude Code, Cursor, OpenCode, and Pi, previews operations, checks Superpowers dependencies for workflow skills, and prints a final operation report.
`ai_plan/` is gitignored local planning state used by `create-plan` and `do-task`. The skill manager does not install, sync, or publish `ai_plan/` contents.
## Pi Package
The repo root now includes a pi package manifest that ships only the pi-specific surface: