Skip to content

Home

skillsaw logo

Keep your skills sharp.

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

Get Started View Rules

Features

  • 🧠 Content Intelligence

    Research-backed rules that catch weak language, tautological instructions, attention dead zones, embedded secrets, contradictions, and more.

  • 🔧 LLM Autofix

    Fix violations with any LLM via skillsaw fix --llm — parallel processing, scoped re-lint, per-file rollback.

  • 🔍 Context-Aware

    Auto-detects repo type and instruction formats: CLAUDE.md, AGENTS.md, Cursor, Copilot, Gemini, Kiro, and more.

  • 📐 50 Rules

    Validates structure, metadata, commands, cross-file consistency, context budget, and content quality.

  • 🏗 Scaffolding

    skillsaw add generates plugins, skills, commands, agents, and hooks with best-practice structure.

  • 📝 Documentation

    skillsaw docs generates HTML or Markdown documentation for your plugins and marketplaces.

  • 🔌 Extensible

    Custom rules, banned patterns, per-rule thresholds — tailor skillsaw to your project.

  • 🤖 CI-Ready

    GitHub Action with inline PR comments, deduplication, and automatic thread resolution.

  • ⚡ Version-Gated

    New rules gated behind config versions — no surprises on upgrade.

Quick Start

# Lint current directory (no install required)
uvx skillsaw

# Fix structural issues automatically
skillsaw fix

# Fix content quality issues with an LLM
skillsaw fix --llm

Full installation guide