plankton-code-quality

Run formatters and linters on file edits and repair unfixable violations.

Updated May 17, 2026
One-click install
npx skills add https://github.com/ohdaveed/director-hearing-manager --skill plankton-code-quality-ohdaveed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plankton-code-quality
Source: https://github.com/ohdaveed/director-hearing-manager/tree/main/.agents/skills/plankton-code-quality
Command: npx skills add https://github.com/ohdaveed/director-hearing-manager --skill plankton-code-quality-ohdaveed

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents slow, error-prone code reviews by enforcing consistent formatting and linting continuously while an agent edits files, reducing the chance that issues slip through due to partial fixes or configuration gaming.

Core Features & Use Cases

  • Write-time enforcement: Runs formatters and linters on every file edit via PostToolUse hooks, then verifies fixes after automated remediation.
  • Tiered AI-based repair: Delegates unfixable violations to Claude subprocesses with model routing based on violation complexity (light style fixes vs deeper refactors/types).
  • Config tamper defense: Blocks or detects edits to linter/formatter configuration files to avoid “passing” by weakening rules instead of fixing code.

Quick Start

Ask your agent to enable Plankton in the Claude Code session so that every edit is automatically formatted, linted, and fixed with verification.

Frequently Asked Questions about plankton-code-quality

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I auto-format and lint code on every file edit in my agent workflow?

You can auto-format and lint code on every edit by using PostToolUse hooks to trigger formatters and linters automatically. This enforces write-time code quality across Python, TypeScript, Shell, YAML, JSON, and Markdown files continuously.

What is the best way to automatically fix unfixable linting violations in a multi-language project?

Automatically fixing unfixable linting violations requires delegating remediation to a Claude subprocess with tiered timeouts. The system routes violations by complexity, handling light style fixes and deeper refactors through a verification loop.

How does write-time code quality enforcement handle configuration tampering?

Write-time code quality enforcement blocks or detects edits to linter and formatter configuration files. This config tamper protection prevents agents from weakening rules to pass checks instead of actually fixing the code.

Can I use automated formatting and linting hooks with Dockerfile and TOML files?

Yes, automated formatting and linting hooks apply to Dockerfile and TOML files, alongside TypeScript, Python, Shell, YAML, JSON, and Markdown. The multi-language workflow ensures agents introduce no formatting or type issues across these formats.

Why does my agent bypass lint rules instead of fixing the code during automated edits?

Agents may bypass lint rules by editing configuration files to weaken rules rather than fixing code. Config tamper defense detects and blocks these edits, forcing the agent to resolve violations through actual code remediation and verification.