CtrlK
BlogDocsLog inGet started
Tessl Logo

code-simplification

Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.

66

Quality

80%

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/code-simplification/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-structured, highly actionable process skill with an exemplary workflow (validation checkpoints, feedback loops, checklist) and specific pattern catalogs. Its main cost is token weight: basic-idiom code examples and a long single-file body add tokens without adding much beyond what Claude already knows.

Suggestions

Trim or replace the Language-Specific Guidance before/after examples of basic idioms (filter vs. loop, `||` assignment, dict comprehension, early returns) with a one-line pointer to the pattern tables, or move the section to a references/ file loaded only when the target language is involved.

Condense the Chesterton's Fence explanation to the rule itself plus the checklist, since the fence parable re-teaches a concept Claude already knows.

Consider splitting the pattern tables and rationalization tables into a separate reference file so the SKILL.md body carries the principles and workflow at lower token cost.

DimensionReasoningScore

Conciseness

The process sections and pattern tables are tight, but the Language-Specific Guidance works through before/after pairs of idioms Claude already knows (filter vs. for-loop push, `||` vs. if/else assignment, dict comprehension, early returns), and the Chesterton's Fence section re-explains a familiar concept. On re-reading the anchors, this is more than the 'minor instances of over-explanation' of anchor 4, fitting anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened').

3 / 5

Actionability

Concrete, pattern-by-pattern tables (e.g., "Deep nesting (3+ levels) → Extract conditions into guard clauses", "Boolean parameter flags `doThing(true, false, true)` → Replace with options objects") plus explicit before/after code, a named 500-line automation threshold, and a closing verification checklist give fully executable guidance. As an instruction skill, its guidance is specific and copy-paste-usable, matching anchor 5; it is not anchor 4 because there are no meaningful gaps in the common cases.

5 / 5

Workflow Clarity

A clear four-step sequence (Understand → Identify → Apply incrementally → Verify) with an explicit feedback loop ("If tests fail → revert and reconsider"), per-change test runs, pre-change questions to answer, and a final verification checklist. This matches anchor 5's 'explicit validation steps; feedback loops for error recovery; checklists'; the destructive-change cap does not apply since test-after-each-change validation is present throughout.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the single-file structure is well-sectioned with clear headers and easy navigation, fitting anchor 4's 'good structure; most content is appropriately placed'. It falls short of anchor 5 (which rewards well-signaled one-level references) and shows some anchor-3 traits: the ~100 lines of language-specific before/after examples are content that could live in separate reference files.

4 / 5

Total

17

/

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 description with explicit, multi-clause trigger guidance and third-person voice. Its main limitation is that the 'what' side rests on a single action statement, so capability coverage is thinner than the trigger coverage.

DimensionReasoningScore

Specificity

"Simplifies code for clarity" names the domain and one concrete action, but the rest of the description only adds trigger conditions rather than additional capabilities (e.g., no mention of behavior-preserving refactoring, dead-code removal, or naming improvements). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') and falls short of anchor 4, which expects several specific listed actions.

3 / 5

Completeness

The description explicitly answers both questions: what ("Simplifies code for clarity") and when, via three concrete 'Use when...' trigger clauses. Both are explicit and concrete, matching anchor 5; it is not anchor 4 because the 'when' guidance here is more specific and multi-trigger than that anchor's example.

5 / 5

Trigger Term Quality

Natural phrases like "refactoring code for clarity", "harder to read, maintain, or extend", and "unnecessary complexity" map well to what users would actually say. A few common variants ("cleanup", "readability", "reduce complexity") are missing, keeping it below the comprehensive synonym coverage of anchor 5 but clearly above the generic-keyword level of anchor 3.

4 / 5

Distinctiveness Conflict Risk

The focus on clarity-focused, behavior-preserving simplification distinguishes it from general refactoring, formatting, and code-review skills, but "simplifies code" still overlaps with adjacent code-quality skills. Mostly distinct with minor overlap risk, matching anchor 4 rather than anchor 5's 'clear niche with minimal conflict risk'.

4 / 5

Total

16

/

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
addyosmani/agent-skills
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.