CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

instruction-cleanup

Restructures bloated instruction files in bulk to shrink always-loaded context and restore agent performance. Use when CLAUDE.md, AGENTS.md, Cursor rules, or other instruction files have grown too large (200+ lines, 40k+ chars), when agent performance has degraded due to bloated context, or when the user asks to audit, restructure, slim down, or clean up their instruction files. For a single small edit to an instruction file, use instruction-guardian instead.

77

1.05x
Quality

89%

Does it follow best practices?

Impact

100%

1.05x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

Excellent workflow design and executability — three phases, approval gates, and a genuine verify-and-fix loop with copy-paste commands. The weaknesses are self-inflicted: a 280-line single-file body with no reference bundle contradicts the skill's own extraction principles, and the router is documented twice (DOT graph plus destination table) along with four near-identical flag snippets.

Suggestions

Collapse the DOT flowchart and the Destination Guide table into a single representation (the table already encodes the routing decision outcomes), keeping the litmus test as the entry question.

Extract the per-tool flag mechanics (Claude/Codex arming and disarming snippets and their lifecycle rules) into a references/ file with a one-line pitch-style pointer from the body, cutting the four repeated shell blocks to one summary.

Trim the "Why This Matters" section to a single sentence or fold its threshold guidance into Phase 1, removing the motivational research framing.

DimensionReasoningScore

Conciseness

Mostly dense, non-obvious project-specific guidance that earns its tokens, but there is real duplication and padding: the DOT router flowchart restates the Destination Guide table almost entirely, the flag arm/disarm shell snippets appear four times across Claude/Codex variants, and "Why This Matters" spends a paragraph on motivational rationale. Not 4 because the flowchart/table duplication is more than a minor trim; not 2 because nearly all of the rest is actionable and non-inferable.

3 / 5

Actionability

Copy-paste-ready commands throughout: the cksum-keyed flag creation/removal snippets, the Context Budget Report template, the restructuring plan table with a worked example row, the needle-grep and pointer-check verification commands, and a concrete target-metrics table. Guidance is fully executable with specific examples covering the common cases.

5 / 5

Workflow Clarity

A clearly sequenced three-phase cycle with explicit checkpoints: report presented to the user before Phase 2, user approval required before implementing, and a verification stage (needle grep + pointer check) with an explicit feedback loop ("If a key term is unreachable ... Fix it before committing") and a disarm step. This is a bulk/destructive operation and validation is present and thorough, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist and the body is a ~280-line monolith: the per-tool flag mechanics (Claude vs Codex arming/disarming), the Destination Guide, and the DOT router are inlined in one always-on-loaded body rather than split into one-level-deep reference files. Internal structure (headers, tables) is good, so not 2; but content that clearly belongs in separate files is inline, and the skill's own philosophy argues for extracting it, so not 4.

3 / 5

Total

16

/

20

Passed

Description

95%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 description: third-person voice, explicit what/when with concrete thresholds and synonyms, and clean boundary guidance against a closely related skill. The only soft spot is that the capability statement leans on one umbrella action while the variety of verbs (audit/restructure/slim/clean) lives in the trigger clause rather than the capability list.

DimensionReasoningScore

Specificity

"Restructures bloated instruction files in bulk to shrink always-loaded context" names the domain and a concrete primary action, and the trigger clause surfaces further action verbs (audit, restructure, slim down, clean up). Not 5 because the capability side rests on essentially one operation rather than an enumerated list of concrete sub-actions (e.g., it never mentions measuring/auditing line counts or extracting to docs/skills as things it does); not 3 because it goes well beyond naming the domain plus 1-2 actions.

4 / 5

Completeness

Explicitly answers both: what ("Restructures bloated instruction files in bulk to shrink always-loaded context and restore agent performance") and when ("Use when ... grown too large (200+ lines, 40k+ chars), when agent performance has degraded ... or when the user asks to audit, restructure, slim down, or clean up"), with concrete trigger phrases. Also adds a boundary clause ("For a single small edit ... use instruction-guardian instead").

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage: synonyms users would actually say ("audit, restructure, slim down, or clean up their instruction files"), concrete file names (CLAUDE.md, AGENTS.md, Cursor rules), measurable thresholds ("200+ lines, 40k+ chars"), and a symptom-based trigger ("agent performance has degraded due to bloated context"). Matches the top anchor's breadth including file-name variants.

5 / 5

Distinctiveness Conflict Risk

Clear niche (instruction-file context hygiene) with distinct triggers (specific file names, size thresholds, performance degradation) and explicit disambiguation from the sibling instruction-guardian skill for the single-small-edit case. Minimal conflict risk.

5 / 5

Total

19

/

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

ivan-magda/instruction-health-skills

Path

instruction-cleanup/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.