CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

60

Quality

71%

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-simplifier/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

61%Scale 1-5

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

This is a reasonably well-structured code simplification skill with strong concrete examples that clearly demonstrate desired transformations. Its main weaknesses are some verbosity in explaining concepts Claude already understands (role description, basic principles) and a lack of concrete validation steps in the workflow—particularly important for refactoring where functionality preservation is critical. The before/after examples are the strongest element and provide genuinely useful, actionable guidance.

Suggestions

Add explicit validation steps to the refinement process, such as 'Run the project's test suite to confirm no behavioral changes' or 'Diff the output to verify functional equivalence'.

Remove or significantly trim the opening role description paragraph and obvious principles like 'Never change what the code does' — Claude already understands these from the skill description and context.

DimensionReasoningScore

Conciseness

The skill contains some unnecessary verbosity, particularly the opening paragraph that re-explains Claude's role ('You are an expert code simplification specialist...') and several principles that Claude already understands (e.g., 'Never change what the code does'). The project standards section references CLAUDE.md conventions that may not apply universally. However, the examples are efficient and the overall structure isn't excessively padded.

3 / 5

Actionability

The skill provides concrete before/after code examples that clearly demonstrate the desired transformations. The refinement principles give specific, actionable guidance (e.g., avoid nested ternaries, prefer explicit returns). However, the refinement process steps are somewhat generic ('Identify', 'Analyze', 'Apply') without concrete commands or tool usage, and the project standards reference CLAUDE.md without providing fallback specifics.

4 / 5

Workflow Clarity

The 6-step refinement process provides a sequence but lacks validation checkpoints. Steps like 'Verify the refined code is simpler' and 'Ensure all functionality remains unchanged' are stated but have no concrete verification mechanism (e.g., running tests, diffing outputs). For a refactoring skill that could introduce subtle bugs, the absence of explicit validation steps (like running the test suite) is a notable gap.

3 / 5

Progressive Disclosure

For a standalone skill with no bundle files, the content is well-structured with clear sections (Principles, Process, Examples). The length is reasonable and doesn't need to be split into multiple files. The reference to CLAUDE.md for project standards is appropriate one-level-deep disclosure. Minor gap: the examples could be organized under a collapsible or clearly labeled section for quick scanning.

4 / 5

Total

14

/

20

Passed

Description

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

This is a solid skill description with excellent trigger term coverage and completeness, featuring an explicit 'Use when' clause with multiple natural phrases. Its main weaknesses are moderate specificity—the concrete actions described are somewhat abstract rather than enumerating specific refactoring techniques—and some overlap risk with other code review or refactoring skills.

Suggestions

Add more concrete actions to improve specificity, e.g., 'extracts helper functions, removes duplication, simplifies conditionals, improves naming conventions'.

Differentiate from related skills (e.g., general code review, linting, performance optimization) by explicitly stating what this skill does NOT do or how it differs.

DimensionReasoningScore

Specificity

Names the domain (code simplification/refactoring) and describes actions like 'simplifies', 'refines', and 'preserving functionality', but the actions are somewhat abstract rather than listing concrete techniques (e.g., extracting functions, removing duplication, renaming variables). 'Focuses on project-specific best practices' is vague.

3 / 5

Completeness

Clearly answers both 'what' (simplifies and refines code for clarity, consistency, and maintainability while preserving functionality) and 'when' (explicit 'Use when' clause with multiple concrete trigger phrases). Both are well-articulated.

5 / 5

Trigger Term Quality

Includes excellent natural trigger phrases: 'simplify code', 'clean up code', 'refactor for clarity', 'improve readability', and 'review recently modified code for elegance'. These are phrases users would naturally say, with good synonym coverage.

5 / 5

Distinctiveness Conflict Risk

While the trigger terms help distinguish it, 'code simplification' and 'refactoring' could overlap with general code review skills, linting skills, or broader refactoring tools. The description doesn't clearly carve out a unique niche versus other code quality skills.

3 / 5

Total

16

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-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.