What does this skill do?

The Plankton Code Quality Skill applies formatting, linting, and automatic fixes to every file edited by Claude Code using three-phase hooks. It routes violations to Claude subprocesses organized hierarchically by model (Haiku, Sonnet, Opus) based on their complexity, and blocks obsolete package managers to enforce the use of modern ones.

Automatic formatting in every issue
Runs ruff, biome, shfmt, taplo, and markdownlint silently every time a file is edited.
Protecting Linter Settings
Prevents tampering with linter configuration files to ensure that agents do not bypass rules.
Delegation by Model
Routes violations to Haiku (style), Sonnet (logic), or Opus (types) subprocesses based on complexity.
Blocking Obsolete Managers
Disables pip, npm, yarn, and pnpm; requires uv for Python and bun for JavaScript.

Usage examples

🔧 Minimum Python Requirements
Configure Plankton for a Python project: enable Python, JSON, and TOML; disable Shell and TypeScript; and enable thread delegation.
🔇 Skip a subprocess in a session
I want to edit code without launching any Claude subprocesses in this session—just direct formatting and linting.
🐛 Refine model selection
Enable debug mode to see which Claude model is selected for each linting violation.
🚫 Temporarily allow npm
I need to run `npm install` on this specific project; please disable the package manager block for this session.

Features

Three-phase architecture Phase 1: Silent auto-formatting; Phase 2: Compilation of violations in JSON; Phase 3: Delegation to a subprocess with verification.
Model-Based Routing Haiku for style violations, Sonnet for logic, Opus for type inference, with configurable timeouts and turns.
Multilingual It supports Python, TypeScript, Shell, YAML, JSON, TOML, Markdown, and Dockerfile with specific linters.
Multi-layered configuration protection Hook PreToolUse, hook Stop with git diff, and a list of protected files to prevent tampering with linting rules.
Control Environment Variables HOOK_SKIP_SUBPROCESS, HOOK_DEBUG_MODEL, and HOOK_SKIP_PM to adjust behavior on a per-session basis.

Frequently asked questions

The base dependencies are jaq, ruff, and uv (via brew). For Python, also run `uv sync --all-extras`. Each language has its own specific linters listed in the dependencies table in SKILL.md.
Yes. You can enable or disable languages individually in .claude/hooks/config.json depending on your project's needs.
Plankton blocks editing in three layers: the `PreToolUse` hook before editing, the `Stop` hook when running `git diff` upon closing, and a list of protected files (.ruff.toml, biome.json, etc.).
Yes. Set HOOK_SKIP_SUBPROCESS=1 before starting Claude Code to skip Phase 3 and report violations directly to the main agent.
Plankton Code Quality — Linting and Automatic Formatting with Claude AI

¿Prefieres escuchar el contenido? Genera la narración de audio con un clic.