CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

simplify

Review recent code changes for reuse, code quality, and efficiency, then directly apply straightforward cleanup improvements. Use when the user wants a post-implementation cleanup pass, pre-PR polish, or asks to simplify/refine recent changes. Invoke with `/simplify` or `/simplify <focus>`.

Quality

87%

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

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.

A tight, well-structured workflow skill: concrete commands, explicit agent configuration, prioritization guidance, and a verification step. The only meaningful gaps are the absence of a sample review-pass prompt and an explicit fix-and-re-verify recovery loop in Step 5.

Suggestions

Add a one-line example prompt for a review pass (e.g., 'Review this diff for code reuse: read the diff yourself; report only findings with file and line references') so the passes are fully templated.

Extend Step 5 with a feedback loop: if verification fails, fix or revert the offending edit and re-run the targeted check before finishing.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout: bulleted checklists for each review pass, exact git commands, and explicit tool parameters ('Set subagent_type: "general-purpose" and run_in_background: false'). It assumes Claude's competence and never explains concepts Claude already knows. The 'Preferred commands' list is mildly redundant with Steps 2–4 but is concrete and earns its place.

5 / 5

Actionability

Guidance is mostly executable: concrete commands ('git diff HEAD --name-only', 'git ls-files --modified --others --exclude-standard'), tool-level configuration for the agent passes, and specific fix examples ('remove redundant code, but only after a repository-wide search confirms it has no remaining callers'). It falls short of a 5 because no example review-pass prompt is given — the passes are told to be 'short and focused' but not shown a template.

4 / 5

Workflow Clarity

A clear five-step sequence (scope → parallel review passes → aggregate → apply → verify) with verification present in Step 5 ('Run focused tests for the changed area when they exist'), so the destructive-operation cap does not apply. It falls short of 5 because Step 5 lacks an explicit error-recovery feedback loop (what to do when tests or typecheck fail after the edits).

4 / 5

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist and none are needed: the skill is a single cohesive ~110-line workflow, not reference material. Section headers (Steps 1–5, one section per review pass, 'Additional focus') make navigation easy, and no content is inlined that clearly belongs in a separate file.

5 / 5

Total

18

/

20

Passed

Description

83%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 explicitly covers both what the skill does and when to invoke it, with concrete trigger phrasing. The main gaps are a slightly summarized action list and a few missing natural synonyms ('refactor', 'clean up', 'deduplicate').

Suggestions

Enumerate one or two concrete example actions (e.g., 'replace duplicated logic with existing helpers, remove dead code') instead of the summarized 'apply straightforward cleanup improvements'.

Add common user synonyms such as 'refactor', 'clean up', or 'deduplicate' to the 'Use when' clause to improve trigger coverage.

DimensionReasoningScore

Specificity

The description names several concrete capabilities — 'Review recent code changes for reuse, code quality, and efficiency, then directly apply straightforward cleanup improvements' — with specific review dimensions and the apply-changes action. It falls short of a 5 because the actions are summarized ('review', 'apply') rather than enumerated (e.g., deduplicate, tighten loops, remove dead code).

4 / 5

Completeness

Both parts are explicit: what — 'Review recent code changes for reuse, code quality, and efficiency, then directly apply straightforward cleanup improvements' — and when — 'Use when the user wants a post-implementation cleanup pass, pre-PR polish, or asks to simplify/refine recent changes.' These are concrete trigger phrases, matching the anchor-5 example pattern exactly.

5 / 5

Trigger Term Quality

Natural user phrases are present: 'post-implementation cleanup pass', 'pre-PR polish', 'simplify/refine recent changes'. A few natural synonyms users would say are missing (e.g., 'refactor', 'clean up', 'deduplicate'), which keeps it below the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The scope (cleanup/simplification of recent changes, applied directly) carves a clear niche distinct from plain review skills. Minor overlap risk remains with a general code-review skill since both trigger on 'review recent changes', which keeps it below 5.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

QwenLM/qwen-code

Path

packages/core/src/skills/bundled/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.