CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

golang-refactoring

Golang refactoring — safe, at-scale restructuring of existing Go code: a coverage-adaptive safety net, behavior-preserving transforms (gopls Rename/Extract, `gofmt -r`, `gopatch`), the Fowler catalog mapped to Go, breaking import cycles, and small stacked PRs. Apply when a function or type has grown too large, a code smell blocks a feature, or the user asks to refactor Go code — also for renaming at scale, extracting functions or interfaces, moving code between packages, or planning a multi-step refactor. Target styles owned elsewhere → See `samber/cc-skills-golang@golang-naming` (renames), `samber/cc-skills-golang@golang-project-layout` (splits), `samber/cc-skills-golang@golang-modernize` (idioms), `samber/cc-skills-golang@golang-code-style` (control flow), `samber/cc-skills-golang@golang-design-patterns` (patterns/DI).

71

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 well-structured, actionable refactoring skill with excellent workflow sequencing, validation feedback loops, and clean progressive disclosure into five real reference files. Its main weakness is conciseness — several meta-rationale paragraphs and a basic Fowler definition pad the body without adding skill-specific value.

Suggestions

Trim the 'Questions' meta-paragraph and the 'Thinking mode'/'Orchestration mode' justification prose to their operative rules; the repeated 'ask via the question tool' clauses already do the work.

Remove or shorten the Fowler definition line ('Refactoring (Fowler) is changing code's internal structure...') — Claude already knows what refactoring is; keep only the behavior-preservation emphasis specific to this skill.

Add one or two inline gopls Rename/Extract invocation examples (or a one-line CLI snippet) so the primary actuator is actionable directly from SKILL.md, not only via go-tooling.md.

DimensionReasoningScore

Conciseness

Mostly efficient but includes unnecessary explanation that could be tightened: the meta 'Questions' paragraph rationalizing its own repetition, the 'Thinking mode'/'Orchestration mode' justification paragraphs, and the Fowler definition ('Refactoring (Fowler) is changing code's internal structure...') Claude already knows. Not 4 because the padding is more than minor; not 2 because the bulk is skill-specific reasoning that earns its place.

3 / 5

Actionability

Concrete, executable commands throughout — 'go build ./... && go vet ./... && go test ./...; add -race for concurrency changes and benchstat-backed -bench', 'type A = B', and the escalation 'gofmt -r → eg → gopatch → go/analysis fixer'. Not 5 because exact gopls Rename/Extract invocation is deferred to go-tooling.md rather than shown inline, leaving a minor gap.

4 / 5

Workflow Clarity

Clear numbered Core Loop (Understand → Safety net → Small tool-driven step → Verify → Atomic single-category commit) with an explicit verify step, a revert-on-red feedback loop ('revert rather than debug forward when it goes red'), sign-off gates, and a Diagnose section mapping failure signals to actions — matching the 5 anchor with feedback loops and checkpoints.

5 / 5

Progressive Disclosure

Clear overview with five real, one-level-deep references (workflow.md, catalog.md, go-tooling.md, safety-net.md, structural.md — all present on disk), clearly signaled via inline links and a dedicated 'Detailed References' section, with content appropriately split. Matches the 5 anchor for easy navigation.

5 / 5

Total

17

/

20

Passed

Description

100%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.

An exemplary description: concrete capabilities, explicit what/when triggers with natural phrasing, and deliberate disambiguation from sibling skills via cross-references. Its only weakness is length — the sibling-skill routing inflates the field, though it serves distinctiveness.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — 'coverage-adaptive safety net, behavior-preserving transforms (gopls Rename/Extract, `gofmt -r`, `gopatch`), the Fowler catalog mapped to Go, breaking import cycles, and small stacked PRs' — for comprehensive coverage matching the 5 anchor; no significant gaps to drop it to 4.

5 / 5

Completeness

Explicitly answers both what ('safe, at-scale restructuring of existing Go code: ...') and when ('Apply when a function or type has grown too large, a code smell blocks a feature, or the user asks to refactor Go code') with concrete trigger phrases, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

Comprehensive natural trigger terms with synonyms: 'refactor Go code', 'renaming at scale', 'extracting functions or interfaces', 'moving code between packages', 'planning a multi-step refactor' — the kind of phrasing a user would actually say; not 4 because coverage is thorough rather than missing only 'a few' terms.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Go refactoring mechanics) with explicit carve-outs to sibling skills — 'Target styles owned elsewhere → See golang-naming, golang-project-layout, golang-modernize, golang-code-style, golang-design-patterns' — minimizing conflict risk; matches the 5 anchor.

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

samber/cc-skills-golang

Path

skills/golang-refactoring/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.