CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

plankton-code-quality

Write-time code quality enforcement using Plankton — auto-formatting, linting, and Claude-powered fixes on every file edit via hooks. Use when setting up write-time formatting, linting, or auto-fix hooks on file edits.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/plankton-code-quality/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is information-dense and highly actionable for integrating Plankton, with concrete commands, tables, and a well-sequenced ratchet workflow. Its main weaknesses are length and structure: a long inline tail section with narrative padding, and reference-grade material (config reference, ECC comparison, oxlint detail) that should live in separate bundled files.

Suggestions

Move the Configuration Reference and the ECC pairing/comparison sections into separate bundled reference files (e.g., references/config.md, references/ecc-pairing.md) and keep SKILL.md as a concise overview with clearly signaled one-level-deep links.

Tighten the final 'Gabe's addition' section: strip meta-commentary and attribution narration, keeping the rule-enablement steps, the ratchet sequence, and the source citation as compact instructions.

Add a validation step to the Per-Project Integration workflow (e.g., edit a file and confirm the PostToolUse hook fires and reports) so the setup sequence has an explicit checkpoint.

DimensionReasoningScore

Conciseness

Mostly efficient — the phase diagram, dependency tables, and config reference carry genuinely novel Plankton-specific facts — but the trailing "Gabe's addition" section includes narrative padding ("That is the whole point", "Say so if you use it, do not attribute it to the source") and inline date/version specifics that could be tightened. Not 2 because there is little explanation of concepts Claude already knows, and not 4 because the padding and meta-commentary are more than minor.

3 / 5

Actionability

Provides executable commands ("brew install jaq ruff uv", "uv sync --all-extras"), concrete copy steps, a complete config.json, an env-var table, and an oxlint snippet whose `<MEASURED_CEILING>` placeholder is explicitly justified with instructions for filling it. Not 5 because some commands lack surrounding context (e.g., `uv sync --all-extras` presumes a Plankton checkout without saying so) and the placeholder snippet is not copy-paste ready as-is.

4 / 5

Workflow Clarity

Sequences are clear: Quick Start, a numbered Per-Project Integration list, and a 6-step ratchet technique with explicit measure/re-measure checkpoints and a stated escalation guard. Not 5 because the per-project integration steps lack a validation checkpoint (no step confirming the hooks actually fire) and the quick start offers no verification; not 3 because the ratchet workflow's measurement checkpoints are explicit rather than implicit.

4 / 5

Progressive Disclosure

Headers are well-organized, but no bundle files exist and the ~330-line body inlines content that clearly belongs in separate references (full config reference, ECC pairing matrix, oxlint/ratchet detail). The References section points at external repository docs (REFERENCE.md, SETUP.md) rather than clearly-signaled bundled paths. Not 2 because structure and section headers are present and navigable, and not 4 because substantial reference-grade content is inlined rather than split out.

3 / 5

Total

14

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: it states concrete capabilities in third person and pairs them with an explicit, naturally-phrased 'Use when...' clause. Its only weakness is that trigger coverage omits common synonyms and tool/language terms that users might actually say.

DimensionReasoningScore

Specificity

Lists several specific actions — "auto-formatting, linting, and Claude-powered fixes on every file edit via hooks" — matching the 'several specific actions; minor gaps in coverage' anchor. It is not 5 because coverage is not comprehensive (no mention of language coverage or config protection), and not 3 because it goes beyond naming the domain with 1-2 actions.

4 / 5

Completeness

Explicitly answers both: what ("auto-formatting, linting, and Claude-powered fixes on every file edit via hooks") and when ("Use when setting up write-time formatting, linting, or auto-fix hooks on file edits") with concrete trigger phrases, matching the anchor-5 example structure. A score of 4 would require the 'when' clause to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural trigger phrases like "setting up write-time formatting, linting, or auto-fix hooks" are phrases a user would plausibly say. Not 5 because common synonyms and concrete tool/language terms (e.g., "code quality", "ruff", "biome", "Python linting") are missing; not 3 because coverage goes beyond merely relevant keywords.

4 / 5

Distinctiveness Conflict Risk

Names the distinct Plankton write-time/on-every-edit niche, so it is mostly distinct with only minor overlap risk against general code-quality or linting skills. Not 5 because terms like "linting" and "auto-formatting" could still collide with generic formatter/linter skills.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/plankton-code-quality/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.