Full documentation at skillsaw.org — supports Claude Code plugins, agentskills.io, CLAUDE.md, AGENTS.md, Cursor, Copilot, Gemini, Kiro, CodeRabbit, and more.
Table of Contents
Quick Start
No install required — run with uvx skillsaw (or install
it for repeated use).
# 1. See what skillsaw detects in your repo
skillsaw tree
# 2. Lint it
skillsaw
# 3. Fix what you can automatically
skillsaw fix
# 4. Accept remaining violations as the baseline
skillsaw baseline
# Done — only new violations will fail from here on
skillsaw # exit 0
# Curious why a rule fired (or didn't)?
skillsaw explain content-weak-language
For all commands and flags, see the CLI Reference.
[!TIP]
:sparkles: Onboard with AI — let your coding agent handle the entire setup in one shot.
Claude Code:
claude plugin marketplace add stbenjam/skillsaw
claude plugin install skillsaw@skillsaw-marketplace
Then type /skillsaw-onboard — it installs skillsaw, lints your repo, autofixes what it can, walks you through manual fixes, sets up CI, and creates a baseline.
Other agents — see the Getting Started guide.
Installation
Via uvx (easiest, no install required)
uvx skillsaw
uvx skillsaw /path/to/skills
Via pip
pip install skillsaw
From source
git clone https://github.com/stbenjam/skillsaw.git
cd skillsaw
pip install -e .
Using Docker
docker pull ghcr.io/stbenjam/skillsaw:latest
docker run -v $(pwd):/workspace ghcr.io/stbenjam/skillsaw
CI Integration
# GitHub Actions
- uses: stbenjam/skillsaw@v0
with:
strict: true
