plankton-code-quality

Format and lint code automatically with Plankton hooks in Claude Code.

1|Updated Jan 30, 2021
One-click install
npx skills add https://github.com/fideguch/my_dotfiles --skill plankton-code-quality-fideguch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plankton-code-quality
Source: https://github.com/fideguch/my_dotfiles/tree/main/claude/skills/plankton-code-quality
Command: npx skills add https://github.com/fideguch/my_dotfiles --skill plankton-code-quality-fideguch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plankton Code Quality integrates write-time quality enforcement into Claude Code workflows, automatically formatting and linting code as you edit to prevent drift and reduce review effort.

Core Features & Use Cases

  • Auto-Format Phase: Runs formatters (ruff format, biome, shfmt, taplo, markdownlint) and fixes many issues silently.
  • Violation Collection: Runs linters and collects unfixable issues into a structured report for review.
  • Delegation & Tiering: Spawns Claude subprocesses and routes fixes to Haiku/Sonnet/Opus based on violation complexity; re-runs for verification.
  • Defense against config tampering: PreToolUse hooks block unwanted linter-config edits, with a Stop hook to detect changes and a protected-files list.
  • Language Support: Python, TypeScript, Shell, YAML, Markdown, Dockerfile, TOML, JSON.

Quick Start

Install Plankton hooks in your Claude Code project and run Claude Code to enable write-time formatting, linting, and automated fixes.

Frequently Asked Questions about plankton-code-quality

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

FAQPage Schema
How do I automate code formatting and linting in Claude Code?

Automated code formatting and linting in Claude Code works by applying Plankton hooks to run formatters like ruff, biome, and shfmt silently during edits, then collecting unfixable violations into a structured report.

Can I enforce code quality across multiple languages like Python and TypeScript?

Yes, multi-language code quality enforcement supports Python, TypeScript, Shell, YAML, Markdown, Dockerfile, TOML, and JSON by running language-specific formatters and linters through unified Plankton hooks.

How do I prevent linter configuration tampering in automated workflows?

Preventing linter config tampering uses PreToolUse hooks to block unwanted edits to linter configurations, supplemented by a Stop hook to detect changes and a protected-files list for enforcement.

What is the best way to handle unfixable linting violations automatically?

Handling unfixable linting violations involves collecting them into a structured report and spawning Claude subprocesses that route fixes to Haiku, Sonnet, or Opus models based on violation complexity, then re-running for verification.

Does write-time code quality enforcement work without manual linting commands?

Write-time code quality enforcement works without manual commands by integrating Plankton hooks into Claude Code workflows, automatically formatting and linting code as you edit to prevent drift and reduce review effort.