skill-install-dry-run-planner

Skill Install Dry-Run Planner

Produce a maintainer plan from skills-sync dry-run evidence.

Scope: Dry-run planning only. Never run live apply installs from this skill.

Dispatch

$ARGUMENTS	Action
Empty	Full dry-run plan for all harnesses
`--harness <name>`	Plan for one harness adapter
`--format json`	Machine-readable plan
`help`	Show phases, gates, and related runbooks

Planned Phases

Validate — run the repo validation command
Dry-run JSON — run the skills-sync dry-run JSON command
Review gaps — inspect missing, unresolved, and skipped rows per harness
Optional smoke — INSTALL_SMOKE=1 temp-home phase (maintainer machine only)
Apply gate — human approval required before any --apply

Also see skills/cross-agent-install-smoke/ and docs/runbooks/install-smoke.md.

Workflow

uv run python skills/skill-install-dry-run-planner/scripts/plan_dry_run.py
uv run python skills/skill-install-dry-run-planner/scripts/plan_dry_run.py --harness cursor --format json

Validation Contract

uv run python skills/skill-install-dry-run-planner/scripts/check.py

Critical Rules

Default to dry-run; treat sync JSON as evidence, not authority over repo policy.
Never auto-apply installs or run live npx skills add from this skill.
Run phase 1 dry-run checks before recommending reconciliation.
Gate temp-home smoke behind INSTALL_SMOKE=1.
Document unresolved catalog rows instead of silently skipping them.