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.