skill-installer

Skill Installer

One entry point for all CodeArts skill/tool installers. Pass the target name via --target <name> (or positionally) and the command (init/update/delete/status). The dispatcher validates each target's supported scopes and commands before running, then delegates to the target's adapter.

This is the only installer skill exposed to CodeArts. The four individual installers (superpowers-installer, office-mcp-installer, playwright-cli-installer, openspec-installer) are consolidated as internal adapter modules under scripts/targets/.

Quick Start

node scripts/installer.js list                              # list supported targets
node scripts/installer.js init   --target openspec         # install a target (auto-detect scope)
node scripts/installer.js status --target openspec         # status of one target
node scripts/installer.js status                           # status of all targets
node scripts/installer.js delete --target openspec         # uninstall a target

Positional shorthand: init openspec ≡ init --target openspec.

Commands

Command	Description
list	List supported targets with their scopes, commands, and descriptions
init --target <name>	Install the target into the resolved scope
update --target <name>	Regenerate/refresh the target from latest source
delete --target <name>	Uninstall the target (clean; tracked via manifest where applicable)
status [--target <name>]	Health of one target, or all targets if --target omitted

Supported Targets

Target	Scopes	Commands	Installs
superpowers	project, user	init, update, delete	14 Superpowers skills (brainstorming, TDD, debugging, …) + bootstrap
office-mcp	project	init, update, delete, status	MCP server (39 Word/Excel/PPT/PDF/OCR tools) + skill + MCP config
playwright-cli	project, user	init, update, delete, status	playwright-cli skill + @playwright/cli + chromium browser
openspec	project, user	init, update, delete, status	OpenSpec SDD skills (propose/explore/apply/sync/archive)

Capability gating rejects unsupported combos up front — e.g. init --target office-mcp --user errors ("office-mcp supports project scope only"); status --target superpowers errors ("superpowers has no status command").

Scope

Flag	Scope	Skills Path	Status File
--project	Single project	<project>/.codeartsdoer/skills/	ProjectSkillStatus.txt
--user	All projects	~/.codeartsdoer/skills/	UserSkillStatus.txt
(omit)	Auto-detect	Project if .codeartsdoer/ exists in cwd, else user	—

ALSO, YOU CAN USE NATURAL LANGUAGE TO LET THIS SKILL INSTALL/UPDATE/DELETE any supported target for you — just name the target (e.g. "install openspec", "更新 office-mcp", "uninstall superpowers").

Requirements

Node.js (≥ 20.19.0 for openspec; ≥ 18 otherwise), npm, and git — all already required by CodeArts. Individual targets may install global packages (openspec CLI, @playwright/cli) or download browsers automatically. Works on Windows, Linux, and macOS.

Layout

skill-installer/
├── SKILL.md
├── scripts/
│   ├── installer.js          # dispatcher: parse, validate capabilities, delegate
│   ├── lib/                  # shared helpers (exec, paths, status-file, manifest)
│   └── targets/              # one adapter per target
│       ├── index.js
│       ├── superpowers.js
│       ├── office-mcp.js
│       ├── playwright-cli.js
│       └── openspec.js
└── assets/manifests/         # runtime manifests (gitignored)