← ClaudeAtlas

skillsaw-fixlisted

Fix skillsaw lint violations — apply deterministic autofixes, then resolve the remaining violations with targeted edits guided by `skillsaw explain`. Use when skillsaw reports violations, when asked to clean up lint findings, or after `skillsaw fix` leaves violations behind.
stbenjam/skillsaw · ★ 73 · AI & Automation · score 90
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,