skillsaw-fixlisted
Install: claude install-skill stbenjam/skillsaw
# skillsaw Fix
Review and fix **skillsaw** lint violations in this repo. skillsaw lints agentic
contextual building blocks (CLAUDE.md, skills, plugins, agents, hooks,
etc.). The tool applies deterministic fixes itself; handle everything else
yourself — read the violation, load the rule's how-to-fix guidance, and
make a targeted edit.
Follow the steps in order. Report progress to the user at each stage.
## Step 1: Install and locate skillsaw
Run `skillsaw --version`. If the command is missing, use `uvx skillsaw` as the
prefix for every command below (or `pip install skillsaw` if uvx is
unavailable).
## Step 2: Run the lint and build an inventory
Run `skillsaw` (lint) from the repo root and capture the output. Each
violation line includes the severity, file path, line number, message, and
rule ID — read them all.
If the lint exits 0 with no violations, tell the user the repo is clean and stop.
Build an inventory: group the violations by rule ID and check how many files
each rule touches. Review this summary with the user before making changes.
## Step 3: Run deterministic autofixes
Run `skillsaw fix`. This applies safe, structural fixes (missing frontmatter, kebab-case names, plugin registration, and similar).
Then run `skillsaw fix --suggest --dry-run` to preview the suggested tier.
Suggested fixes (e.g. updating stale references after a rename) are
mechanically derived but may over-match, so review each hunk in the diff
individually: for a stale-reference rewrite,