CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

maintenance

Use when the user asks for a project health audit, a maintenance sweep, or a multi-category lead-engineer scan followed by interactive issue-by-issue resolution. Not for routine lint/test runs, single-file cleanups, or plain check-project requests.

62

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 ./plugins/flowai/skills/maintenance/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

A dense, unusually executable instruction skill with explicit validation gates, loud-failure handling, and a final checklist, supported by three real one-level-deep reference files. Its credibility is undercut by internal bookkeeping contradictions (17 vs 16 categories, mismatched numbering and names between the Context block, Category index, and Step 4) and by over-padded QA-format prose, plus a stale step reference in a bundle file.

Suggestions

Fix the category bookkeeping: the Context block lists 17 categories but Steps 2 and 4 say 16; the Category-index numbering (e.g. "10 Architectural Integrity") contradicts the Context numbering (#10 is "Documentation Health"); and Step 4's "16 English names from the Context block" ("Structural Integrity", "Code Hygiene") are not the names the Context block uses ("Structure", "Hygiene"). Pick one numbering and one name set and apply it everywhere.

Tighten the QA-FORMAT section and Step 5: the ~300-word single-paragraph "Self-contained" bullet and the three-sentence justification of count repetition can each be halved without losing the constraint, and Rules 8–9 duplicate detail already stated in Step 3.

Fix stale or missing navigation: verification-gate.md cites "Step 17.5" while SKILL.md's gate is Step 3, and the five `maintenance-scan-*` agent bodies that hold the executable detail are not in the bundle — link them or inline a pointer to where they live.

DimensionReasoningScore

Conciseness

The body is mostly operational (exact output shapes, thresholds, reply modes), but padding is more than minor: the QA-FORMAT "Self-contained" bullet is a single ~300-word paragraph re-explaining its own test ("Test: with the report deleted, could the reader name every member from this option alone?"), Step 5 spends three sentences justifying why counts are repeated ("The repetition is deliberate, not redundancy to be optimised away..."), and Rules 8–9 duplicate the Step 3 gate detail. Fits anchor 3 (mostly efficient but could be tightened) rather than 4; not 2 since almost nothing explains concepts Claude already knows.

3 / 5

Actionability

Highly concrete for an instruction-only skill: exact line shape "- [N] [Severity] <file/symbol>: <problem>. (Fix: <proposed fix>)", literal reply modes (`critical+high`, `agent's choice`, `done`), numeric thresholds (500/50 lines, "Critical share ≤ 35 %"), and a worked example block. Not 5 because internal contradictions force guessing: the Context block lists 17 categories while Steps 2/4 say 16, and the Category-index numbers ("10 Architectural Integrity") contradict the Context numbering (#10 is "Documentation Health"), so an executor cannot map categories without interpretation.

4 / 5

Workflow Clarity

The sequence is strong: two clearly separated phases, an explicit mandatory verification gate with per-shape checks, a retry-once/loud-failure protocol ("record it as NOT SCANNED and report it prominently"), and a final checklist — matching anchor 5's feedback loops. It drops to 4 because the category pipeline is internally incoherent: Context has 17 categories vs "16 Category Checks" in Step 2, the index numbering doesn't match the Context list, and Step 4 cites "the 16 English names from the Context block above" ("Structural Integrity", "Code Hygiene") that the Context block never uses (it says "Structure", "Hygiene").

4 / 5

Progressive Disclosure

All three referenced bundle files exist (severity-rubric.md, verification-gate.md, example-findings.md), are one level deep, well-signaled at point of use, and the body explicitly delegates detail ("SKILL.md carries only the index below, not the executable detail") — close to anchor 5. Minor gaps hold it at 4: verification-gate.md self-describes as "Reference for Step 17.5 of the maintenance skill" while the body's gate is Step 3 (stale cross-link), and the five `maintenance-scan-*` agents that supposedly hold the executable per-category detail are not present anywhere in the bundle.

4 / 5

Total

15

/

20

Passed

Description

78%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.

A strong, well-scoped description with an explicit trigger clause and unusually good negative scoping that eliminates overlap with routine lint/test skills. Its main weaknesses are a jargon trigger phrase ("multi-category lead-engineer scan") a user would never type and a thin 'what' half that never says what the scan covers or what the user receives.

Suggestions

Replace "multi-category lead-engineer scan" with wording a user would actually type, e.g. "full codebase audit" or "deep maintenance scan", to improve trigger-term quality.

Add one concrete 'what' clause (e.g., "scans 17 check categories and produces a severity-graded findings list with proposed fixes, resolved interactively") so the completeness 'what' half is as explicit as the 'when' half.

DimensionReasoningScore

Specificity

Names several concrete actions — "project health audit", "maintenance sweep", "multi-category lead-engineer scan followed by interactive issue-by-issue resolution" — which matches the 'lists several specific actions; minor gaps' anchor. It falls short of 5 because the actions stay at the audit/sweep/resolve level with no coverage of what the scan actually checks or produces; it is above 3 because more than 1-2 actions are named in a concrete domain.

4 / 5

Completeness

Both halves are present: an explicit "Use when the user asks for..." trigger clause plus negative scope ("Not for routine lint/test runs, single-file cleanups, or plain check-project requests"), and a what of "multi-category ... scan followed by interactive issue-by-issue resolution". Not 5 because the 'what' is thin — no mention of the check categories, severity-graded findings, or proposed fixes — and not 3 because the 'when' is explicit and concrete rather than weakly implied.

4 / 5

Trigger Term Quality

"project health audit", "maintenance sweep", and "check-project" are phrases a user would naturally say, giving good keyword coverage, but "multi-category lead-engineer scan" is jargon no user would type and common synonyms like "tech debt", "code health", or "cleanup" are missing. Fits anchor 4 (good coverage, a few natural terms missing) rather than 5 (comprehensive coverage with synonyms) or 3 (only some relevant keywords).

4 / 5

Distinctiveness Conflict Risk

The negative scope clause ("Not for routine lint/test runs, single-file cleanups, or plain check-project requests") explicitly fences off the nearest overlapping skills, and the niche — multi-category audit plus interactive resolution — is distinct. This matches anchor 5 (clear niche with distinct triggers; minimal conflict risk); anchor 4's 'minor overlap risk' understates the explicit disambiguation.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

korchasa/flowai-plugins

Path

plugins/flowai/skills/maintenance/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.