mcpField
S
skill-install-dry-run-planner

skill-install-dry-run-planner

github.com/wyattowalshAgent workflows535 installsUpdated 8w ago
Repository

About skill-install-dry-run-planner

A maintainer skill that turns skills-sync dry-run evidence into an installation plan across harnesses or for one selected harness. It keeps installs behind human approval and does not perform live apply operations.

Key features

  1. 01Plan installs across harnesses
  2. 02Select a harness adapter
  3. 03Review missing, unresolved, and skipped rows
  4. 04Optional temp-home smoke phase
  5. 05Require approval before apply

Use cases

  1. 01Prepare a skills-sync reconciliation plan
  2. 02Inspect install gaps for one harness
  3. 03Produce a machine-readable plan
  4. 04Check install readiness without applying changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wyattowalsh/agents --skill skill-install-dry-run-planner

After installing, type/skill-install-dry-run-plannerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/
evals.json
scripts/
check.py
plan_dry_run.py
scripts/asset_toolkit/
validate_hooks.py

Details

From the project README

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

$ARGUMENTSAction
EmptyFull dry-run plan for all harnesses
--harness <name>Plan for one harness adapter
--format jsonMachine-readable plan
helpShow phases, gates, and related runbooks

Planned Phases

  1. Validate — run the repo validation command
  2. Dry-run JSON — run the skills-sync dry-run JSON command
  3. Review gaps — inspect missing, unresolved, and skipped rows per harness
  4. Optional smoke — INSTALL_SMOKE=1 temp-home phase (maintainer machine only)
  5. 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

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

Comments

Markdown supported