CtrlK
BlogDocsLog inGet started
Tessl Logo

refactor-pass

Perform a refactor pass focused on simplicity after recent changes. Use when the user asks for a refactor/cleanup pass, simplification, or dead-code removal and expects build/tests to verify behavior.

88

1.00x
Quality

Does it follow best practices?

Impact

97%

1.00x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is exceptionally lean and well-sequenced with a verification checkpoint, appropriate for a small single-purpose skill. It would benefit from more concrete refactor techniques and an explicit failure-handling loop after the build/test step.

Suggestions

Add concrete, actionable detail to the abstract steps — e.g. under 'Straighten logic flows' give a specific heuristic like 'flatten nested conditionals by guarding early returns' rather than leaving the action open-ended.

Turn step 3 into a feedback loop: 'Run build/tests; if they fail, revert or fix the offending refactor and re-run until green before suggesting abstractions.'

Optionally include one short before/after example of a simplification so the expected outcome is unambiguous.

DimensionReasoningScore

Conciseness

The body is lean with no padding or re-explanation of concepts Claude already knows (e.g. it assumes familiarity with 'dead code', 'premature optimization'); every line is directive, matching the score-3 anchor.

3 / 3

Actionability

It names concrete refactor categories ('Remove dead code', 'Remove excessive parameters') but guidance like 'Straighten logic flows' and 'identify simplification opportunities' stays abstract, with no concrete techniques or examples, fitting the score-2 'some concrete guidance but incomplete' anchor.

2 / 3

Workflow Clarity

Steps are clearly sequenced and include an explicit verification step (3. Run build/tests), but it lacks a fix→re-validate feedback loop for code-modifying work, so it sits at the score-2 'checkpoints present but feedback gaps' level rather than score 3.

2 / 3

Progressive Disclosure

The skill is under 50 lines, needs no external references (none present), and is organized into a clear Workflow section, so per the simple-skills scoring note it qualifies for score 3 on well-organized sections alone.

3 / 3

Total

10

/

12

Passed

Description

92%

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, action-oriented, and includes an explicit 'Use when' trigger clause with natural user terms, covering what and when well. Its main weakness is moderate overlap risk with generic refactoring/cleanup assistance.

Suggestions

Tighten the trigger to distinguish this from general coding help, e.g. emphasize the post-change timing and scope: 'Use after a feature/change lands when the user wants a focused simplification pass, not a behavior change or new feature.'

Add a brief exclusion cue (e.g. 'Not for architectural rewrites or adding features') to reduce conflict with adjacent skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ('refactor/cleanup pass', 'simplification', 'dead-code removal', and build/tests verification), matching the score-3 anchor of several specific concrete actions rather than a single domain mention.

3 / 3

Completeness

It explicitly states what the skill does ('Perform a refactor pass focused on simplicity after recent changes') and when to use it via an explicit 'Use when the user asks for…' clause, clearly answering both what and when.

3 / 3

Trigger Term Quality

It surfaces natural user-facing terms ('refactor', 'cleanup pass', 'simplification', 'dead-code removal', 'build/tests') with good coverage of common variations, satisfying the score-3 anchor.

3 / 3

Distinctiveness Conflict Risk

Although narrowed by 'after recent changes' and a build/tests expectation, the core triggers ('refactor', 'cleanup', 'simplification') are broad enough to overlap with general coding/cleanup skills, so it is not a clearly un-conflicting niche.

2 / 3

Total

11

/

12

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
pgplex/pgconsole
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.