stbenjam/skillsaw

Create a skillsaw rule plugin — a pip-installable Python package that adds custom lint rules to skillsaw. Walks through scaffolding the package, writing rules against the lint tree, testing, and publishing to PyPI. Use when a user wants to share skillsaw rules across repositories or publish them for others.

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.

Use when modifying agentic contextual building blocks like skills (SKILL.md), slash commands, agents, hooks, plugins, marketplaces, and instruction files (CLAUDE.md, AGENTS.md, GEMINI.md, Cursor, Copilot, Cline, or Kiro rules). Run skillsaw on the files you touched, apply autofixes, resolve remaining violations with skillsaw explain guidance, and re-lint until clean before considering the work complete.

Onboard a repository to skillsaw — run the linter, apply autofixes, manually fix remaining violations, set up CI, and create a baseline. Use when adopting skillsaw on a new or existing project.