CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

request-refactor-plan

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

87

3.20x
Quality

89%

Does it follow best practices?

Impact

80%

3.20x

Average score across 3 eval scenarios

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 lean, well-structured instruction-only skill with a clear step sequence and a complete output template. The main gaps are the unspecified issue-creation mechanics and the absence of explicit feedback loops for when repo verification contradicts user claims.

Suggestions

Specify how to file the issue (e.g., `gh issue create` with the template body) and whether to include a title format or labels, making the final step copy-paste executable.

Add a brief instruction for the step-4 interview (e.g., a short list of question categories) and a feedback note for step 2 (what to do when the repo contradicts the user's assertions), closing the workflow's validation loop.

DimensionReasoningScore

Conciseness

The body is lean: eight terse numbered steps and a clearly delimited issue template, with no explanation of concepts Claude already knows — the Martin Fowler quote is the instruction itself, not padding. Every section earns its place, matching anchor 5.

5 / 5

Actionability

Guidance is mostly concrete: an 8-step procedure and a fully specified, copy-paste-ready issue template. It falls short of anchor 5 because the issue-filing mechanism (e.g., `gh issue create`, title format, labels) and the interview questions are left unspecified — minor gaps typical of anchor 4.

4 / 5

Workflow Clarity

The eight steps form a clear, well-ordered interview-to-issue sequence with checkpoints present ("Explore the repo to verify their assertions", checking test coverage). It doesn't reach anchor 5 because there are no explicit feedback loops (e.g., what to do when repo exploration contradicts the user's claims) and no checklist for the detailed interview in step 4.

4 / 5

Progressive Disclosure

This is a single-purpose skill with no external reference needs: the body is well-organized into numbered steps plus one clearly delimited inline template, and there are no nested or buried references. Per the simple-skill guideline, this warrants a 5.

5 / 5

Total

18

/

20

Passed

Description

87%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 clearly and explicitly states both what the skill does and when to use it, with natural trigger phrases and a distinct niche. The only improvement space is slightly broader action coverage and a few more trigger synonyms.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue" — covering interview, plan creation, and issue filing. It stops short of anchor 5's comprehensive coverage because supporting actions (repo verification, test-coverage assessment) are absent, leaving minor gaps.

4 / 5

Completeness

It explicitly answers both questions: the "what" ("Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue") and the "when" ("Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps") with concrete trigger phrases, matching the anchor 5 example structure.

5 / 5

Trigger Term Quality

Natural trigger phrases like "plan a refactor", "create a refactoring RFC", and "break a refactor into safe incremental steps" are phrases users would actually say. A few natural synonyms are missing (e.g., "restructure code", "refactoring plan"), so it fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The refactor-planning-to-GitHub-issue niche with triggers like "refactoring RFC" and "safe incremental steps" is clearly distinct from general coding or review skills, matching anchor 5's clear niche with minimal conflict risk.

5 / 5

Total

18

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

SnowingFox/ai-skills

Path

.cursor/skills/request-refactor-plan/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.