CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

simplify

Simplifies code for clarity without changing behavior. Use for readability, maintainability, and complexity reduction after behavior is understood.

Quality

78%

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 ./src/skills/simplify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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-organized, instruction-only skill body with a clear four-step workflow, concrete signal checklists, and explicit behavior-preservation gates. Its weaknesses are an undefined 'proportionate final-state verification plan' invoked three times without an example, some redundant verification prose, and no reference material despite the body being on the longer side for a single-file skill.

Suggestions

Define or exemplify the 'proportionate final-state verification plan' (e.g. what verification is proportionate to a small vs. large diff) the first time it is invoked, since it gates the key workflow steps.

Consolidate the verification guidance repeated in 'Preserve Behavior Exactly', Step 3, Step 4, and the final section into one place to trim tokens.

Consider moving the signal catalog and repository-specific guidance to a reference file with a clearly signaled link, reducing the single-file length and improving progressive disclosure.

DimensionReasoningScore

Conciseness

The body is largely lean and assumes competence (no explanation of what refactoring or testing is), with well-chosen checklists of signals and questions. Minor trimmable padding remains: the Overview's philosophical framing ('The goal is not fewer lines - it's code that is easier to read...') and repetition of verification guidance across 'Preserve Behavior Exactly', Step 3, Step 4, and the closing 'Final-state verification' section. That matches anchor 4 rather than 5.

4 / 5

Actionability

For an instruction-only skill the guidance is mostly executable: concrete signal lists ('Deep nesting', 'Nested ternaries', 'Boolean flag arguments'), explicit questions to answer, and a one-change-at-a-time procedure. The gap is the repeated instruction to 'use the proportionate final-state verification plan' without defining what such a plan is or giving an example, leaving the verification step itself abstract, which holds it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

A clear four-step sequence (Understand -> Identify opportunities -> Apply incrementally -> Verify) with per-change verification in Step 3, keep-only-when-evidence-supports-it feedback, and a final confirmation checklist. It falls short of anchor 5 because the validation step relies on the undefined 'proportionate final-state verification plan' instead of explicit, concrete checks (e.g. run the test suite) with a defined fix-and-retry loop.

4 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ are absent) and the body references only AGENTS.md, a project conventions file, so everything lives in a single well-sectioned document. Sections are clear and the content is appropriate for a single-file skill, but at ~130 lines with several subsections that could split out (e.g. the signals catalog or the repository-specific guidance), it matches anchor 4 (good structure, minor organization gaps) rather than the one-level-deep reference structure of anchor 5.

4 / 5

Total

16

/

20

Passed

Description

70%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 concise, third-person description that clearly states what the skill does and when to use it, with a strong behavior-preservation qualifier that differentiates it from neighboring skills. Its main weakness is that the trigger clause describes desired qualities rather than concrete phrases a user would naturally say.

Suggestions

Add concrete user trigger phrases to the 'when' clause, e.g. 'Use when the user asks to simplify, clean up, or reduce complexity in working code'.

Replace some goal words with an additional concrete capability, e.g. 'Removes dead code, flattens nesting, and splits long functions while preserving behavior'.

DimensionReasoningScore

Specificity

The description states one concrete action ("Simplifies code for clarity without changing behavior") and then lists goals ("readability, maintainability, and complexity reduction") rather than additional actions, so it names the domain with 1-2 concrete actions but is not comprehensive. It fits anchor 3 better than 4 because the enumerated terms describe qualities, not distinct things the skill does.

3 / 5

Completeness

Both parts are explicit: the what is "Simplifies code for clarity without changing behavior" and the when is "Use for readability, maintainability, and complexity reduction after behavior is understood". The when is stated as task conditions rather than concrete user trigger phrases, so it matches anchor 4 (when could be more explicit or specific) rather than 5.

4 / 5

Trigger Term Quality

Natural terms users would say are present: "Simplifies", "clarity", "readability", "maintainability", "complexity". Common synonyms like "clean up", "refactor", or "make this simpler" are missing, so coverage is good but not comprehensive, matching anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The behavior-preservation framing ("without changing behavior") gives it a clear niche distinct from code-review, refactoring, or rewrite skills, and the guard "after behavior is understood" narrows it further. There is minor overlap risk with closely related skills (e.g., general code review or refactoring), matching anchor 4.

4 / 5

Total

15

/

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

alvinunreal/oh-my-opencode-slim

Path

src/skills/simplify/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.