Skip to content

Skillsaw

Keep your skills sharp. Intelligence for agent context.

Install

$npx skills add stbenjam/skillsaw
Claude Code
claude mcp add skillsaw -- npx skills add stbenjam/skillsaw
Cursor / Claude Desktop (mcp.json)
{
  "mcpServers": {
    "skillsaw": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "stbenjam/skillsaw"
      ]
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.

skillsaw

Keep your skills sharp.

A linter for the files that steer AI coding agents.

Agent instructions behave like code, but most teams still review them like prose. skillsaw gives them a linter. It validates structure across every major AI coding ecosystem, guards against many supply-chain attacks, and applies content and context rules backed by research and frontier lab guidance.

It understands Agent Skills, Agent Plugins v1, Claude Code plugins, OpenAI Codex plugins and marketplaces, CLAUDE.md, AGENTS.md, GEMINI.md, QWEN.md, Cursor plugins and marketplaces, Copilot, Cline, Devin, Kiro, OpenCode, Goose recipes, Muse Code, Pi, Grok Build, Google Antigravity, native OpenClaw plugins, hooks, agent configuration, MCP Registry server.json publisher metadata, Vercel skills CLI lockfiles, and eval formats. Safe structural fixes can be applied automatically; everything else comes with precise, agent-friendly guidance.

Get started | Browse the rules | Read the documentation

See it work

Watch an AI agent grade, fix, and configure a repository from scratch.

Try it

Paste this into your coding agent to onboard skillsaw now:

Read and follow the instructions at
https://raw.githubusercontent.com/stbenjam/skillsaw/refs/heads/main/skills/skillsaw-onboard/SKILL.md
to onboard this repo to skillsaw.

Or install the onboarding skill for regular use (recommended). Run this from the repository you want to lint:

npx skills add stbenjam/skillsaw

Select skillsaw-onboard and your coding agent, then ask the agent to use that skill to onboard the repo. See Onboard with AI for plugin installation alternatives.

Or run it yourself. No installation is required with uvx:

uvx skillsaw tree      # See what skillsaw detects
uvx skillsaw           # Lint the current repository
uvx skillsaw fix       # Apply safe, deterministic fixes
uvx skillsaw baseline  # Accept existing findings and fail only on new ones

For lint --fail-on info, use baseline --include-info to accept existing INFO findings too. A configured fail-on: info includes them automatically.

Goose recipes under .goose/recipes/ receive shared content and MCP security checks. Enable the optional recipe checks for standalone recipe directories with:

uvx skillsaw lint my-recipes --type goose --rule goose-recipe-valid --rule goose-subrecipe-references

See Goose recipe support for discovery, path resolution and validation limits.

What it catches

Similar plugs

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…

Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.

The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…