plankton-code-quality

Format and lint edited files via PostToolUse hooks with LLM-based remediation.

Updated Sep 13, 2025
One-click install
npx skills add https://github.com/llmh333/employee_management_spring --skill plankton-code-quality-llmh333
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plankton-code-quality
Source: https://github.com/llmh333/employee_management_spring/tree/main/.gemini/skills/plankton-code-quality
Command: npx skills add https://github.com/llmh333/employee_management_spring --skill plankton-code-quality-llmh333

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plankton prevents slow, error-prone code quality work by automatically formatting and linting files as they are edited, then using an LLM to remediate violations that can’t be fixed by standard tools.

Core Features & Use Cases

  • Write-time enforcement via hooks: Runs auto-formatters and linters on every file edit using Gemini CLI PostToolUse hooks.
  • Tiered LLM-based remediation: Delegates remaining violations to Haiku/Sonnet/Opus subprocesses based on complexity, then verifies the fixes by re-running the quality phases.
  • Config tamper resistance: Blocks and detects attempts to game quality by modifying linter/formatter configuration files (e.g., Ruff/Biome configs).
  • Package-manager guardrails: Blocks legacy package managers and enforces approved tooling to reduce environment drift.
  • Multi-language coverage: Supports Python, TypeScript/JavaScript, Shell, YAML, Markdown, Dockerfile, TOML, and JSON.

Quick Start

Ask Gemini CLI to run Plankton hooks from within the Plankton directory so edits automatically trigger formatting, linting, and LLM-assisted 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 auto-fix lint and formatting violations on every file edit?

Auto-fixing lint and formatting violations on every file edit is handled by Plankton using PostToolUse hooks to run formatters and linters, then delegating remaining violations to a tiered LLM subprocess for remediation.

How do I stop config tampering that games linter rules?

To stop config tampering that games linter rules, Plankton detects and blocks modifications to formatter and linter configuration files, preventing attempts to bypass quality enforcement during development.

Can I enforce multi-language code quality across Python, TypeScript, and YAML?

You can enforce multi-language code quality across Python, TypeScript, JavaScript, Shell, YAML, Markdown, Dockerfile, TOML, and JSON using Plankton's automated formatting and linting hooks.

What is write-time code quality enforcement and how does it work?

Write-time code quality enforcement is a process that formats and lints files during edits using git hooks, then escalates unresolved violations to tiered LLM subprocesses based on complexity for auto-remediation.

How do I enforce approved package managers and block legacy tooling?

Enforcing approved package managers and blocking legacy tooling is achieved through Plankton's package-manager guardrails, which restrict environment drift by validating tooling on every run.

Why do my auto-formatted files still have linting violations after edits?

Auto-formatted files may still have linting violations after edits because standard tools cannot fix complex issues, which Plankton addresses by delegating remaining violations to tiered LLM subprocesses for remediation.