simplify

tessl i github:brianlovin/claude-config --skill simplify

Simplify and refine recently modified code for clarity and consistency. Use after writing code to improve readability without changing functionality.

Review Score

63%

Validation Score

12/16

Implementation Score

50%

Activation Score

67%

SKILL.md

Review

Evals

Generated

13 days ago

Warnings & errors only

Criteria	Score
description_trigger_hint	Description may be missing an explicit 'when to use' trigger hint (e.g., 'Use when...')
metadata_version	'metadata' field is not a dictionary
license_field	'license' field is missing
body_examples	No examples detected (no code fences and no 'Example' wording)

Overall Assessment

This skill provides a reasonable framework for code simplification but relies heavily on abstract principles rather than concrete, executable guidance. It lacks before/after code examples that would make the guidance actionable, and the workflow lacks validation steps to ensure refactoring doesn't break functionality. The content could be more concise by removing self-referential language about expertise.

Suggestions

Add 2-3 concrete before/after code examples demonstrating the simplification principles (e.g., nested ternary → switch statement, arrow function → function keyword)
Include a validation step in the workflow such as 'Run tests after refactoring' or 'Compare outputs before and after changes'
Remove self-referential language like 'Your expertise lies in...' and 'as a result of your years as an expert' - Claude doesn't need this framing
Consider extracting the detailed coding standards list to a separate reference file since they're already in CLAUDE.md

Dimension	Score	Reasoning
Conciseness	2/3	The content includes some unnecessary verbosity like 'Your expertise lies in mastering...' and 'as a result of your years as an expert software engineer' which don't add actionable value. The principles are mostly relevant but could be tightened.
Actionability	2/3	Provides guidelines and principles but lacks concrete code examples showing before/after refactoring. The 'refinement process' is a high-level checklist rather than executable steps with specific commands or code patterns.
Workflow Clarity	2/3	Lists a 6-step refinement process but lacks validation checkpoints or feedback loops. No guidance on how to verify functionality is preserved or what to do if refactoring introduces issues.
Progressive Disclosure	2/3	Content is reasonably organized with numbered sections, but references CLAUDE.md without clear signaling of what's there vs. here. Could benefit from separating detailed coding standards into a reference file.

Overall Assessment

This description has good structure with explicit 'what' and 'when' clauses, earning high marks for completeness. However, it lacks specific concrete actions (what exactly does 'simplify and refine' mean?) and could benefit from more natural trigger terms users would actually say. The scope is somewhat generic and could conflict with other code quality-related skills.

Suggestions

Add specific concrete actions like 'rename variables for clarity, extract repeated logic into functions, simplify conditionals, improve formatting'
Include more natural trigger terms users would say: 'clean up', 'refactor', 'polish', 'tidy up my code', 'make this cleaner'
Clarify what distinguishes this from general refactoring or code review skills - perhaps emphasize it's for cosmetic/readability changes only, not structural refactoring

Dimension	Score	Reasoning
Specificity	2/3	Names the domain (code) and some actions ('simplify', 'refine', 'improve readability'), but lacks specific concrete actions like 'rename variables', 'extract functions', 'remove duplication'. The phrase 'clarity and consistency' is somewhat vague.
Completeness	3/3	Clearly answers both what ('Simplify and refine recently modified code for clarity and consistency') and when ('Use after writing code to improve readability without changing functionality'). The explicit 'Use when...' clause provides clear trigger guidance.
Trigger Term Quality	2/3	Includes some relevant terms like 'code', 'readability', 'clarity', but misses common variations users might say such as 'clean up', 'refactor', 'polish', 'tidy', 'simplify my code', or 'make code cleaner'.
Distinctiveness Conflict Risk	2/3	Could potentially overlap with general code review skills, refactoring skills, or linting skills. The 'recently modified code' qualifier helps somewhat, but 'clarity and consistency' is broad enough to conflict with other code quality skills.

Repository: github.com/brianlovin/claude-config
Last updated: 13 days ago
Created: 13 days ago

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.