skillsaw

skillsaw Keep your skills sharp. 40+ rules catch weak language, contradictions, attention dead zones, and structural issues — then auto-fix them.

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
• Installation
  • Via uvx (easiest, no install required)
  • Via pip
  • From source
  • Using Docker
  • CI Integration
  • Pre-commit
• Repository Types
  • agentskills.io Skills
  • Single Plugin
  • Marketplace (Multiple Plugins)
  • .claude/ Directory
  • CodeRabbit
  • Promptfoo
  • APM (Agent Package Manager)
• Configuration
  • Version Pinning
  • Exclude Patterns
  • Per-Rule Excludes
  • Inline Suppression
  • Content Paths
• Baseline
  • Creating a baseline
  • How it works
  • Ignoring the baseline
  • Stale entries
  • Baseline and fix
• Quality Grade & Badge
  • README badge
• Supply Chain Protection
• Builtin Rules
• Autofixing
  • Deterministic Fixes
  • Working with Coding Agents
  • LLM-Powered Fixes
  • LLM Setup
• Custom Rules
• Scaffolding
  • Initialize a Marketplace
  • Add Components
  • Context Detection
• Lint Tree
• Documentation Generation
• Exit Codes
• Example Output
• Migrating from claudelint
  • Removed rules
• Development
• Contributing
• License
• See Also
• Support

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 (current directory by default — also accepts multiple
#    directories and/or SKILL.md files: skillsaw lint dir1/ dir2/SKILL.md)
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