CtrlK
BlogDocsLog inGet started
Tessl Logo

cleanup

Run all code quality skills — effects, memo, callbacks, state, React Query, emcn design review, url-state, comments, and test-audit — analyzing in parallel, then applying fixes sequentially

62

Quality

74%

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

Quality

Content

85%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 tightly written, highly actionable orchestration workflow: concrete pass commands, an explicit dependency-ordered apply loop, and a genuine content-anchored recovery mechanism for stale parallel-analysis proposals. The only trims available are a few justificatory sentences, and the finding-return format could be shown as a template rather than described in prose.

DimensionReasoningScore

Conciseness

The body is dense and operational — pass commands with arguments, an explicit dependency order, and concrete apply rules — with essentially no explanation of concepts Claude already knows. It falls just short of the lean/efficient anchor because a few rationale sentences (e.g., "This is what makes the ordering real: a single merged-per-file patch would collapse all passes into one edit and lose it" and the extended justification for why comments apply late) restate what the directive already conveys and could be trimmed.

4 / 5

Actionability

Guidance is almost fully executable: exact invocations ("/you-might-not-need-an-effect <scope> fix=false"), a specified finding schema (file path, line range, one-line description, exact before/after), a concrete three-step stale-patch recovery procedure, and a closing "bun run lint". The minor gap is that the structured return format is described in prose rather than given as a template the orchestrator can parse verbatim, and no example invocation with a real scope is shown.

4 / 5

Workflow Clarity

The four-step sequence is explicit with validation checkpoints and feedback loops throughout: parallel read-only analysis, a converge step with overlap reconciliation and dependency-ordered label inheritance, an apply step with a content-anchored re-locate / re-derive / drop recovery loop for stale proposals, a skip condition ("If fix=false, skip this step"), a conditional test pass with its own gate, and a final lint. This matches the clear-sequence-with-explicit-validation-and-error-recovery anchor.

5 / 5

Progressive Disclosure

This is a single-file skill with no bundle files (references/, scripts/, assets/ are absent), and the body is short, well-sectioned (Step 1–4 plus Boundary findings), with the one external pointer (.claude/rules/sim-api-contracts.md) at one level deep and clearly signaled. Per the simple-skill guideline, well-organized sections with no need for external references score 5.

5 / 5

Total

18

/

20

Passed

Description

63%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 specific, concise, third-person description that clearly states what the skill does and how it operates, but it omits any "use when" trigger guidance and lacks the natural user phrases (clean up, refactor, review my code) that would let it fire reliably. Adding an explicit trigger clause with synonyms would lift completeness and trigger quality substantially.

Suggestions

Append a trigger clause such as "Use when the user asks to clean up, refactor, or review code quality" to move completeness from 3 toward 5.

Include natural synonyms users actually say — "clean up my code", "refactor", "code review", "tech debt" — alongside the technical pass names.

Replace or gloss internal jargon ("emcn design review", "url-state") so the description reads naturally to a user who doesn't know the sub-skill names.

DimensionReasoningScore

Specificity

The description enumerates nine concrete capabilities ("effects, memo, callbacks, state, React Query, emcn design review, url-state, comments, and test-audit") and specifies the execution mechanism ("analyzing in parallel, then applying fixes sequentially"). This is comprehensive, concrete coverage of what the skill runs and how, matching the multiple-specific-actions-with-comprehensive-coverage anchor; nothing is padded or abstract.

5 / 5

Completeness

The "what" is clear and detailed, but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description — it never states when Claude should invoke it (e.g., "Use when the user asks to clean up or refactor code"). Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords exist ("code quality", "React Query", "effects", "callbacks", "test-audit") but common natural phrases a user would say are missing: no "clean up", "refactor", "code review", "lint", or "tech debt". Terms like "emcn design review" and "url-state" are internal jargon rather than words a user would naturally say, so it sits at the some-relevant-keywords-but-missing-variations anchor, not the good-coverage level above.

3 / 5

Distinctiveness Conflict Risk

The skill is mostly distinct: it explicitly orchestrates a named set of sub-skills with a parallel-then-sequential strategy, which differentiates it from running any single sub-skill. Minor overlap risk remains with a generic "code review" or "refactor" request that might better route to an individual pass, and the skill name "cleanup" is broad enough to occasionally trigger for non-code cleanup requests — so it is not a fully clear niche with minimal conflict risk.

4 / 5

Total

15

/

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
simstudioai/sim
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.