CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dev-simplify

AI DevKit · Analyze and simplify existing implementations to reduce complexity, improve maintainability, and enhance scalability. Use when users ask to simplify code, reduce complexity, refactor for readability, clean up implementations, improve maintainability, reduce technical debt, or make code easier to understand.

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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-structured instruction-only skill: an analysis-first workflow with hard rules, an anti-rationalization table, validation gates, and correctly externalized detail in a single one-level-deep reference. Scores hold at 4 rather than 5 only for minor gaps: slight rule duplication across sections, no worked before/after example, and no explicit error-recovery loop when validation fails.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with almost no explanation of concepts Claude already knows; every section is actionable rules. Minor duplication exists (the force-fit rule and the parallel-change rule each appear in both Hard Rules and the Red Flags table), which is anchor 4's "minor instances that could be trimmed" rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

It includes an executable command ("npx ai-devkit@latest memory search --query \"<target area>\" --tags \"simplify\""), concrete decision tools (existence check, reader-load test), eight named patterns, and a concrete dev-smoke gate. It stops short of anchor 5 because there is no worked before/after example or copy-paste-ready snippet demonstrating the common case.

4 / 5

Workflow Clarity

The five-step workflow (Gather Context → Analyze → Apply Readability Principles → Propose → Prioritize and Plan) is clearly sequenced, with an approval checkpoint ("Do not modify code until the user approves a simplification plan") and validation steps ("run dev-smoke before and after; results must match"). It misses anchor 5's explicit error-recovery feedback loop for when validation fails or smoke results diverge.

4 / 5

Progressive Disclosure

The body is a well-organized overview whose single deep-dive (readability heuristics) is correctly split into references/readability-guide.md, clearly signaled as "Apply the [readability guide](references/readability-guide.md) and its 'Reading Test'" — a real file, one level deep, with no buried or nested references. This matches anchor 5 exactly.

5 / 5

Total

17

/

20

Passed

Description

86%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: explicit what-and-when structure with an unusually comprehensive set of natural trigger phrases in third-person voice. The only soft spot is that the capability statement stays at the goal/verb level ("analyze and simplify") rather than enumerating concrete simplification operations, which keeps specificity at the midpoint.

Suggestions

Make the capability statement more concrete by naming 1-2 specific operations, e.g. "Analyze implementations for duplication, nesting, and dead code; propose and apply simplifications that reduce complexity and improve maintainability."

Ground the abstract outcome goals ("enhance scalability") in something actionable, such as "identifies scalability blockers like hidden coupling or boundary leakage," so the what-clause does not rely purely on goal language.

DimensionReasoningScore

Specificity

"Analyze and simplify existing implementations" names the domain with two real but generic action verbs; "reduce complexity, improve maintainability, and enhance scalability" are goals rather than concrete operations. This matches the anchor for 1-2 concrete actions without comprehensive coverage, and falls short of anchor 4 whose examples enumerate several specific operations.

3 / 5

Completeness

It explicitly answers "what" ("Analyze and simplify existing implementations to reduce complexity, improve maintainability, and enhance scalability") and "when" ("Use when users ask to simplify code, reduce complexity...") with concrete trigger phrases. This is a direct match for the anchor-5 example structure; anchor 4 would require a less explicit 'when' clause than what is present.

5 / 5

Trigger Term Quality

"simplify code, reduce complexity, refactor for readability, clean up implementations, improve maintainability, reduce technical debt, or make code easier to understand" gives comprehensive coverage of natural user phrasings with multiple synonyms. No file-extension-style terms apply to this domain, so nothing is missing; anchor 5 fits best.

5 / 5

Distinctiveness Conflict Risk

"AI DevKit · Analyze and simplify existing implementations" carves a clear simplification/refactoring niche with distinct trigger terms. It retains minor overlap risk with closely related skills such as general code review or refactoring assistants, matching anchor 4 rather than anchor 5's minimal-conflict profile.

4 / 5

Total

17

/

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

codeaholicguy/ai-devkit

Path

skills/dev-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.