CtrlK
BlogDocsLog inGet started
Tessl Logo

refactoring

Apply caller-aware, behavior-preserving code simplifications such as inlining, branch collapse, and typed access boundaries. Use when cleaning up code or planning focused refactor commits.

64

Quality

81%

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

71%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 dense, high-signal methodology skill with genuinely concrete guidance — decision tables, before/after diffs, and post-refactor verification steps that many similar skills omit. Its weaknesses are structural: everything is packed into one long file with no reference layer, and a couple of examples are fragments (one with malformed syntax) rather than complete code.

Suggestions

Split the long worked examples (asRichText collapse, inline-vs-extract TypeScript/Svelte pair, key-delivery straggler case study) into a references/ file and keep one compact example per principle in SKILL.md, linking as 'See [EXAMPLES.md]'.

Fix the malformed AFTER snippet in 'Collapsing Duplicate Branches' (the block beginning '} else {' with no matching if) and the indented code fence at the start of the asRichText example, which will not render as a proper code block.

Add an explicit ordered procedure near the top (1. audit callers → 2. decide → 3. present diff → 4. commit surgically → 5. straggler sweep → 6. go-to-def check) so the section topics read as a pipeline rather than a catalog.

DimensionReasoningScore

Conciseness

Largely lean and opinionated — a decision table, terse checklists, and no padding explaining basic concepts Claude already knows. Not a 5 because several sections run long for a single point (the 'Prefer Inline' section spends ~70 lines on TypeScript plus Svelte examples; the 'Collapsing Duplicate Branches' section shows two separate before/after pairs for one principle), and the opening 'Related Skills' paragraph is a dense wall of six cross-references.

4 / 5

Actionability

Consistently concrete: before/after TypeScript diffs, a caller-count decision table, a grep-driven straggler checklist, and labeled commit examples ('refactor: inline ValidatedEntry type...'). Not a 5 because a few examples are illustrative fragments rather than complete code — the asRichText snippet elides bodies with '/* push richtext from plaintext */' and the first collapse example's AFTER block opens with a dangling '} else {' — so they instruct rather than execute.

4 / 5

Workflow Clarity

A clear sequence runs audit (count callers) → decide (table) → present diff with tradeoffs → surgical commits ('edit → diagnostics → test → commit') → straggler sweep → Go-to-Definition check, with validation checkpoints between commits. Not a 5 because the entry point is implicit — the phases are presented as topic sections rather than an ordered procedure — and the 'Presenting Changes' validation (wait for reviewer approval) is stated but not looped back into the commit sequence.

4 / 5

Progressive Disclosure

The single ~380-line file is well-sectioned with headers, but everything lives inline — no bundle files exist, and content that would suit a reference (the straggler-sweep case study, the Go-to-Definition mechanics, the full worked examples) is not split out. Cross-skill pointers ('See post-implementation-review', 'See rethink', the ../asymmetric-wins/SKILL.md link) are signaled but point outside this bundle, so navigation to detail depends on skills not shipped here. This matches the score-3 anchor: structure present, but content that should be separate is inline.

3 / 5

Total

15

/

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: third-person voice, concrete named techniques, and an explicit 'Use when...' trigger clause covering both cleanup and commit-planning situations. Only minor gaps in technique coverage and synonym triggers keep it from full marks.

DimensionReasoningScore

Specificity

Names the domain ('behavior-preserving code simplifications') and three concrete techniques — 'inlining, branch collapse, and typed access boundaries' — comparable to the score-4 anchor's 'extracts text, fills forms, converts pages to images'. Not a 5 because coverage stops at three named actions and omits other capabilities the body teaches (straggler sweep, parameter objects, surgical commits).

4 / 5

Completeness

Explicitly answers both: what ('Apply caller-aware, behavior-preserving code simplifications such as inlining, branch collapse, and typed access boundaries') and when ('Use when cleaning up code or planning focused refactor commits'). This matches the score-5 anchor's what+when pattern with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural phrases users would actually say — 'cleaning up code', 'refactor', 'planning focused refactor commits' — plus technique keywords like 'inlining'. Not a 5 because common synonyms such as 'simplify', 'tidy', 'dead code', or 'deduplicate' are missing.

4 / 5

Distinctiveness Conflict Risk

Distinctive markers ('caller-aware', 'typed access boundaries', 'refactor commits') separate it from generic cleanup, review, or testing skills. Not a 5 because 'cleaning up code' overlaps with broader code-cleanup/linting skills, so a minor collision risk remains.

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
EpicenterHQ/epicenter
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.