CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-simplifier

Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Use when asked to "simplify code", "clean up code", "refactor for clarity", "improve readability", or review recently modified code for elegance. Focuses on project-specific best practices.

66

Quality

83%

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

The canonical home for this skill is code-simplifier in roman01la/skills-agents

SKILL.md
Quality
Evals
Security

Quality

Content

68%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 lean, well-structured skill body with concrete, executable before/after examples and clear principles. Its main weakness is the refinement process: validation steps are named but lack any concrete mechanism (tests, build, diff review) to confirm functionality is preserved.

Suggestions

Add a concrete validation checkpoint to the Refinement Process, e.g., 'Verify: run the project's tests (or build) to confirm all functionality remains unchanged' — this would lift workflow clarity above its current validation gap.

Trim bullets that restate common knowledge (e.g., 'Maintain consistent naming conventions', 'Improving readability through clear variable and function names') to tighten token efficiency.

Consider moving the extended before/after examples to a references/ file (e.g., EXAMPLES.md) with a one-line pointer, keeping SKILL.md as a leaner overview.

DimensionReasoningScore

Conciseness

The body is efficient — no basic-concept explanations, and every section (principles, process, examples) carries real guidance. Not 5 because a few bullets restate what Claude already knows ("Maintain consistent naming conventions", "Improving readability through clear variable and function names") and could be trimmed.

4 / 5

Actionability

The three before/after TypeScript examples are complete and copy-paste ready, and the project-standards list is concrete (import sorting, function keyword, explicit return types). Not 5 because the guidance delegates specifics to CLAUDE.md and offers no concrete verification commands, leaving minor gaps between the principles and executable steps.

4 / 5

Workflow Clarity

The six-step process (Identify → Analyze → Apply → Ensure → Verify → Document) is a clear sequence, but "Ensure all functionality remains unchanged" and "Verify the refined code is simpler" name validation without any concrete checkpoint (e.g., run tests/build) — checkpoints are implicit, matching the anchor-3 pattern of steps listed with validation gaps. Not 4 because no executable validation mechanism is given for a workflow whose core guarantee is unchanged behavior.

3 / 5

Progressive Disclosure

Well-organized single-file skill with clear sections and no unnecessary external references; at ~110 lines with examples that could arguably move to a reference file, structure is good with minor organization gaps, fitting anchor 4. Not 5 because it exceeds the simple-skill threshold and the examples section is inline content that could be split out.

4 / 5

Total

15

/

20

Passed

Description

91%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 well-crafted description in third person that explicitly states what the skill does and when to use it, with a strong set of natural quoted trigger phrases. The only weaknesses are mildly abstract action verbs and slight overlap with generic refactoring/code-review skills.

DimensionReasoningScore

Specificity

Lists several specific actions — "Simplifies and refines code", "preserving all functionality", "review recently modified code" — which parallels the anchor-4 example of multiple concrete actions with minor gaps. It falls short of 5 because the actions are less granular than the comprehensive multi-operation examples (no concrete mechanisms or concrete outputs beyond the refinement verbs), and sits above 3 because coverage goes beyond 1-2 generic actions.

4 / 5

Completeness

Clearly answers both: "Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality" (what) and "Use when asked to 'simplify code', 'clean up code', 'refactor for clarity'..." (when) with concrete trigger phrases. This directly matches the anchor-5 example structure; the 'when' clause is explicit, not weakly implied as at 4.

5 / 5

Trigger Term Quality

Includes natural quoted phrases users would actually say — "simplify code", "clean up code", "refactor for clarity", "improve readability" — giving comprehensive synonym coverage. Not 4 because the quoted trigger list already covers the common variations users would naturally use for this task; file extensions are not applicable to a non-file-format skill.

5 / 5

Distinctiveness Conflict Risk

The trigger phrases carve out a clear simplification/clean-up niche with dedicated triggers, making it mostly distinct. It is not 5 because "refactor for clarity" and reviewing modified code overlap with general refactoring and code-review skills, leaving minor conflict risk.

4 / 5

Total

18

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/code-simplifier/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.