CtrlK
BlogDocsLog inGet started
Tessl Logo

simplify-code

Reduce complexity of over-engineered code. Identify unnecessary abstractions, remove dead code, flatten deep nesting, and simplify logic while preserving behavior.

68

Quality

83%

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

100%

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

The body is a tight, action-oriented reference: executable before/after examples, concrete smell-to-action tables, a sequenced protocol with an explicit test/build verification checkpoint, and clean sectioning with no external-reference clutter.

DimensionReasoningScore

Conciseness

The body is lean and table/code-driven with no explanation of concepts Claude already knows; the only near-padding (the epigraph and 'Core Principle' block) is minimal and every other token earns its place.

3 / 3

Actionability

Provides copy-paste-ready before/after code, concrete smell-to-action tables, and executable verification commands ('npm run test', 'npm run build'), matching the fully-executable score-3 anchor.

3 / 3

Workflow Clarity

The Simplification Protocol is a clearly sequenced four-step process with an explicit validation checkpoint (Step 4: run tests/build before declaring done), giving a feedback loop for a destructive operation.

3 / 3

Progressive Disclosure

This is a single-file skill with no bundle files and well-organized sections (checklist, protocol, when-not-to); per the scoring notes such skills can score 3 on organization alone.

3 / 3

Total

12

/

12

Passed

Description

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific and distinctive about what the skill does, but omits explicit 'when to use' trigger guidance from the description itself (relegating it to when_to_use), capping completeness and leaving trigger terms partially missing.

Suggestions

Add an explicit 'Use when...' clause to the description field (e.g., 'Use when code is over-engineered or when the user asks to simplify, clean up, or reduce complexity') so both what and when are present.

Surface the natural trigger terms ('simplify', 'clean up', 'reduce complexity', 'make this simpler') into the description rather than only in when_to_use.

Add a brief 'NOT for adding new features' boundary directly in the description to further reduce conflict risk with feature-oriented skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Identify unnecessary abstractions, remove dead code, flatten deep nesting, and simplify logic' — matching the score-3 anchor that expects several specific actions rather than vague verbs.

3 / 3

Completeness

The 'what' is explicit and detailed, but the description lacks any 'Use when...' clause or equivalent explicit trigger guidance, which per the guidelines caps completeness at 2.

2 / 3

Trigger Term Quality

Terms like 'over-engineered code', 'dead code', and 'deep nesting' are relevant but skew technical; the natural user phrasings ('simplify', 'clean up', 'reduce complexity') live in when_to_use rather than the description, so common variations are missing here.

2 / 3

Distinctiveness Conflict Risk

The niche — reducing complexity of over-engineered code — is clearly bounded with distinct triggers that distinguish it from general refactoring or feature-building skills.

3 / 3

Total

10

/

12

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
vudovn/ag-kit
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.