plankton-code-quality

Installation
Summary

Write-time code quality enforcement with auto-formatting, linting, and Claude-powered subprocess fixes on every file edit.

  • Three-phase architecture: silent auto-formatting, violation collection, and tiered model routing (Haiku for style, Sonnet for complexity, Opus for types) to fix unfixable issues
  • Supports Python, TypeScript, Shell, YAML, JSON, TOML, Markdown, and Dockerfile with 20+ linters including ruff, biome, shellcheck, and hadolint
  • Config protection via PreToolUse and Stop hooks prevents agents from disabling rules instead of fixing code; blocks legacy package managers (pip, npm, yarn)
  • Main agent only sees violations the subprocess couldn't fix; most quality problems resolve transparently with exit code 0
SKILL.md

Plankton Code Quality Skill

Integration reference for Plankton (credit: @alxfazio), a write-time code quality enforcement system for Claude Code. Plankton runs formatters and linters on every file edit via PostToolUse hooks, then spawns Claude subprocesses to fix violations the agent didn't catch.

When to Use

  • You want automatic formatting and linting on every file edit (not just at commit time)
  • You need defense against agents modifying linter configs to pass instead of fixing code
  • You want tiered model routing for fixes (Haiku for simple style, Sonnet for logic, Opus for types)
  • You work with multiple languages (Python, TypeScript, Shell, YAML, JSON, TOML, Markdown, Dockerfile)

How It Works

Three-Phase Architecture

Every time Claude Code edits or writes a file, Plankton's multi_linter.sh PostToolUse hook runs:

Phase 1: Auto-Format (Silent)
Related skills
Installs
3.2K
GitHub Stars
179.7K
First Seen
Mar 3, 2026