cc-os/plugins/os-doc-hygiene/skills/sweep/SKILL.md

1.1 KiB

description
Run doc-hygiene check then clean in sequence — a convenience wrapper. The confirm gate in `clean` still applies; sweep never auto-approves confirm-tier or generative entries. Invoked by `/os-doc-hygiene:sweep [--scope <glob-or-path>] [--category <class|subtype>]`.

Sweep Skill

sweep is check-then-clean: a convenience that runs both skills in sequence, passing the same --scope and --category through to each.

Workflow

  1. First, invoke the check skill (Skill tool, skill: "check"), passing --scope and --category verbatim. Surface the check summary to the user.

  2. Then, invoke the clean skill (Skill tool, skill: "clean"), passing the same --scope and --category verbatim.

The confirm gate in clean applies identically under sweep — sweep does not auto-approve any confirm-tier or generative entries (invariant #7). The user will still be prompted to approve any entries that require it before any file mutation occurs.

sweep produces at most one cleanup commit (the clean step); the check step writes only to the gitignored .cc-os/dochygiene/ and does not commit.