Skip to content

Keep your skills sharp.

skillsaw lints the files that steer your AI coding agents: skills, plugins, instructions, and tool configs across Claude Code, Codex, Copilot, Agent Skills, OpenCode, and more. It catches security risks, structural flaws, and content dead zones with 89 rules, then applies deterministic autofixes.

PyPI version Tests License skillsaw grade

Get Started View Rules

  • 🛡 Security & Supply Chain

    Supply chain protection blocks dangerous lifecycle hooks (curl | sh, eval, arbitrary execution), prohibited MCP servers, invisible Unicode (ASCII smuggling), high-entropy encoded payloads, and unallowlisted dynamic context before they run.

  • 📦 Multi-Ecosystem Structure

    Schema and syntax validation across supported ecosystems: Agent Skills, Claude Code, OpenAI Codex, Agent Plugins v1, Copilot custom agents, OpenCode, Muse Code, APM, and MCP Registry.

  • 🔧 Deterministic Autofixes

    Safe, instant autofixes via skillsaw fix; bundled skills guide coding agents through remaining manual resolutions — see demo below.

  • 🧠 Context & Token Economy

    Research-backed content intelligence: eliminates instruction drift, attention dead zones, cognitive overload, contradictions, and redundant tooling.

  • 🤖 CI-Ready & Baselines

    GitHub and GitLab integration with PR comments, SARIF reporting, and baselines for gradual, zero-friction adoption.

  • 🔌 Extensible

    Custom rules in Python, pip-installable rule plugins, and typed lint tree traversal tailor skillsaw to your repository.

Reading this with an AI agent? Fetch llms.txt for an index of the docs, or llms-full.txt for everything in one plain-markdown file.