CtrlK
BlogDocsLog inGet started
Tessl Logo

simplify

Manually trigger the cdd-code-simplifier agent to review and simplify code

74

1.52x
Quality

70%

Does it follow best practices?

Impact

67%

1.52x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/simplify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 content is efficient and well-structured with concrete commands and clear sequencing, requiring only a more complete Task tool invocation example and edge-case handling to reach top marks.

Suggestions

Include a concrete copy-paste Task tool invocation block showing subagent_type and prompt construction for the common case.

Add an explicit branch for when the agent makes no changes or errors out, so the post-completion workflow has a clear fallback.

Specify how to pass $ARGUMENTS guidance into the agent prompt concretely rather than only by reference.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence, with no padding or explanation of concepts Claude already knows; every line earns its place.

5 / 5

Actionability

Provides concrete, mostly executable guidance including the exact subagent_type and specific git commands, but stops short of a full copy-paste Task tool invocation example.

4 / 5

Workflow Clarity

Steps are clearly sequenced for both scope determination and post-completion review, with a soft commit confirmation checkpoint, though explicit handling of edge cases (no changes vs. agent errors) is missing.

4 / 5

Progressive Disclosure

A short, single-purpose skill under 50 lines with no need for external references; it is well-organized with clear section headers, satisfying the simple-skill exception.

5 / 5

Total

18

/

20

Passed

Description

53%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.

The description is concise and names a concrete agent plus actions, but it lacks any 'when to use' trigger guidance and has limited keyword coverage, capping completeness and trigger quality.

Suggestions

Add a 'Use when...' clause stating when to invoke this skill (e.g., 'Use when the user wants to clean up, refactor, or simplify code').

Broaden trigger keywords to include natural synonyms like 'refactor', 'clean up', or 'tidy code'.

Consider listing the specific aspects it targets (clarity, consistency, maintainability) directly in the description to raise specificity.

DimensionReasoningScore

Specificity

Names the domain (cdd-code-simplifier agent) and two concrete actions ('review and simplify code'), matching the anchor for naming a domain plus 1-2 concrete actions without comprehensive coverage.

3 / 5

Completeness

Clearly states what the skill does (trigger the agent to review and simplify code) but provides no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3.

3 / 5

Trigger Term Quality

Includes relevant natural keywords like 'code', 'review', and 'simplify', but misses common synonyms users might say such as 'refactor' or 'clean up'.

3 / 5

Distinctiveness Conflict Risk

The named 'cdd-code-simplifier' agent gives it a clear niche and distinct trigger, with only minor overlap risk against general code-review skills.

4 / 5

Total

13

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
aaddrick/claude-desktop-debian
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.