CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

60

Quality

76%

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

88%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 body is a highly actionable orchestration procedure: exact sub-agent commands, a dependency-ordered sequential apply loop, and content-anchored validation that correctly handles the stale-proposal hazard of parallel analysis. Its weaknesses are minor — a few lines of justifying rationale that could be trimmed and slight length past the lean single-file ideal — with the strong workflow validation making it a robust example for an orchestrator skill.

DimensionReasoningScore

Conciseness

The body is dense and operational with no concept explanations Claude already knows — exact pass commands, argument-parsing rules, and apply procedures. Minor instances of over-explanation could be trimmed: the dependency order is stated three times (Step 2, Step 3 intro, Step 3 list) and lines like "This is what makes the ordering real: a single merged-per-file patch would collapse all passes into one edit and lose it" justify rather than instruct. This fits anchor 4 better than 3, since the trimmable material is only a handful of lines out of ~57.

4 / 5

Actionability

Fully executable guidance: copy-paste-ready pass commands (`/you-might-not-need-an-effect <scope> fix=false`), a concrete argument-parsing rule for `fix=true|false`, exact file patterns for the tests pass (`*.test.ts(x)`, `apps/sim/scripts/test-*-e2e.ts`), specific commands (`git diff --name-only`, `bun run lint`), and a fully specified three-branch decision procedure for stale proposals (match → apply; no match → re-derive or drop). As an instruction-only orchestration skill, per the scoring notes the absence of code is not penalized since the guidance is directly actionable.

5 / 5

Workflow Clarity

A clear four-step sequence with explicit validation checkpoints and feedback loops despite the batch-edit nature of the work: overlap detection and reconciliation in Step 2, mandatory re-read and content-match verification before every apply in Step 3 with re-derive-or-drop recovery for stale proposals, and a final `bun run lint` check. This matches anchor 5 and avoids the batch-operations cap because validation is present throughout.

5 / 5

Progressive Disclosure

The bundle contains no reference/script/asset files, and this orchestrator legitimately keeps its logic inline with clean, well-signaled sections (Step 1–4, Boundary findings) and no content that clearly belongs in a separate file. It misses 5 only on minor organization gaps: the body runs ~57 lines — just past the lean-under-50 ideal — with the dense snapshot-relative proposal rules ("Treat every Step 1 proposal as snapshot-relative...") being the one block that could plausibly live in a reference file, and the lone pointer to `.claude/rules/sim-api-contracts.md` targets a repo path outside the bundle.

4 / 5

Total

18

/

20

Passed

Description

55%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 clearly communicates what the skill does — orchestrating nine named code-quality passes with parallel analysis and sequential apply — but omits any "use when" trigger guidance and leans on project-specific jargon rather than natural user phrases. Consequently completeness is capped and trigger terms underperform despite strong specificity. A single "Use when..." clause containing natural phrases like "cleanup" or "run all quality checks" would address both weaknesses.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to clean up, tidy, or run a full code-quality pass over their changes, a PR, a directory, or the whole codebase" — this lifts completeness from 3 to 5 and removes the cap.

Include natural trigger terms users would actually say ("clean up", "tidy up", "run all quality checks") alongside the skill enumeration; treat project jargon like "emcn design review" as secondary to plain-language keywords.

Clarify the boundary between this orchestrator and its sub-skills, e.g. "Use for a full cleanup pass; use the individual skills when the user asks about a single concern (e.g. only React Query)", to reduce conflict risk.

DimensionReasoningScore

Specificity

The description enumerates nine named component skills ("effects, memo, callbacks, state, React Query, emcn design review, url-state, comments, and test-audit") and states the concrete process ("analyzing in parallel, then applying fixes sequentially"). It stops short of comprehensive: the verbs "run/analyze/apply fixes" stay high-level and never say what kinds of fixes are produced.

4 / 5

Completeness

The "what" is clear and detailed (run nine named skills, parallel analysis, sequential apply), but there is no "Use when..." clause or any equivalent explicit trigger guidance, which caps this dimension at 3 per the judging guidelines. This matches anchor 3 exactly: clear "what", "when" missing entirely.

3 / 5

Trigger Term Quality

Some relevant keywords are present ("code quality", "React Query", "effects", "callbacks", "state"), but the natural phrases a user would say for this skill — "cleanup", "clean up the codebase", "tidy", "run all quality checks" — are absent, and "emcn design review", "url-state", and "test-audit" are project-specific jargon users would not naturally say. This sits between anchor 3 (some relevant keywords, missing common variations) and anchor 4, closer to 3 because the primary trigger phrase for the skill's own name is missing.

3 / 5

Distinctiveness Conflict Risk

The skill is identifiable as the aggregate orchestrator because it enumerates its sub-skills, but its description shares trigger terms ("effects", "memo", "callbacks", "state", "React Query", "comments") with each of the nine sub-skills it names, so a query mentioning any one of those terms overlaps with an individual skill. It is somewhat specific but still overlaps with closely related skills, matching anchor 3.

3 / 5

Total

13

/

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

Path

.agents/skills/cleanup/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.