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.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/code-simplifier/SKILL.md

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

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.

The body is well-structured and actionable with concrete before/after code examples and specific project standards, but the refinement workflow lacks a concrete verification checkpoint, leaving functionality-preservation as an assertion rather than a checkable step.

Suggestions

Add a concrete validation step to the Refinement Process — e.g., "Run the existing test suite" or "Diff against the original and confirm outputs match" — so "Ensure functionality remains unchanged" becomes a checkable checkpoint rather than an assertion.

Trim the opening "You are an expert code simplification specialist..." paragraph, which restates the description frontmatter and adds little actionable value.

Tighten the Refinement Process steps by pairing each action with a concrete artifact (e.g., "Identify: list modified files via git diff") so the workflow is executable rather than descriptive.

Dimension	Reasoning	Score
Conciseness	The body is largely lean — direct bulleted principles and executable examples without explaining basic programming concepts Claude already knows — but the opening "You are an expert code simplification specialist..." paragraph restates the description and could be trimmed.	4 / 5
Actionability	Concrete, executable TypeScript before/after examples and specific standards (ES modules, function keyword, explicit return types, avoid nested ternaries) give mostly executable guidance, though the process steps remain somewhat high-level.	4 / 5
Workflow Clarity	The six-step Refinement Process is sequenced, but "Ensure all functionality remains unchanged" and "Verify the refined code is simpler" are abstract with no concrete validation checkpoint (e.g., run tests, review diff), so checkpoints are missing rather than explicit.	3 / 5
Progressive Disclosure	A single, well-organized file with clear section headers (Refinement Principles, Refinement Process, Examples) and no nested references; it is slightly over 50 lines with inlined examples that could optionally be split out, keeping it just short of a 5.	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 strong description that clearly states what the skill does and when to invoke it, using third-person voice and multiple natural trigger synonyms. The only weakness is slight overlap with broader code-review skills in its last trigger clause.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete actions — "Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality" — which lists multiple specific behaviors, but the coverage is not exhaustive enough for a 5.	4 / 5
Completeness	It explicitly answers both what ("Simplifies and refines code... while preserving all functionality") and when ("Use when asked to 'simplify code'...") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Five natural user-facing phrases with synonyms are present — "simplify code", "clean up code", "refactor for clarity", "improve readability", "review recently modified code for elegance" — giving comprehensive coverage of terms a user would actually say.	5 / 5
Distinctiveness Conflict Risk	The niche (code simplification/refinement) is clear with distinct triggers, but "review recently modified code for elegance" overlaps with general code-review skills, leaving minor conflict risk rather than minimal.	4 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 57c135b

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.