CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orch-refine-code

Orchestrate a behavior-preserving refactor — confirm tests are green, restructure without changing behavior, keep tests green, review, and gated commit. Use when the structure should improve but behavior must not change.

Quality

85%

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

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

An exemplary thin-wrapper skill: lean, jargon-precise, with explicit gates and a concrete worked example, and it correctly pushes detail down to a shared engine. The main weaknesses are the unverifiable sibling-engine dependency (the referenced file is not present alongside the bundle) and the absence of an error-recovery loop for when the safety-net tests fail mid-restructure.

Suggestions

Add a short failure path for the safety net (e.g., 'if tests go red after a step, revert that step before proceeding') to close the error-recovery gap in workflow clarity.

Verify or vendor the `orch-pipeline` engine reference — the linked ../orch-pipeline/SKILL.md is not present in the evaluated bundle, so a reader cannot resolve the load-bearing detail it points to.

Briefly spell out what phases 0, 2, 4, 5, 6 of the mask mean (or where they are defined) so the settings block is self-contained without the engine skill open.

DimensionReasoningScore

Conciseness

A lean ~36-line thin wrapper: no concept explanations Claude already knows, no padding — every section (settings, first move, gates, example) earns its tokens. It assumes competence throughout ("No new behavior tests are written — the existing suite is the safety net"), matching anchor 5 exactly.

5 / 5

Actionability

Concrete, specific guidance: exact phase mask ("0 → 2 → 4 → 5 → 6"), named gates, a named agent with its tools ("refactor-cleaner ... knip / depcheck / ts-prune"), and a commit-message convention (`refactor:`). The gap keeping it below anchor 5 is that the core execution ("Run the orch-pipeline engine") is delegated to a sibling skill that is not part of this bundle, so the skill alone is not copy-paste executable — above anchor 3's pseudocode level.

4 / 5

Workflow Clarity

Clear sequence with explicit checkpoints: confirm tests green BEFORE touching code, plan [GATE 1], restructure in small steps re-running tests after each, code-review, commit [GATE 2]. Falls short of anchor 5 only in lacking an error-recovery feedback loop (no 'if tests go red, do X' path); it is clearly above anchor 3, which has only implicit checkpoints.

4 / 5

Progressive Disclosure

Well-organized short body (under 50 lines) with clear sections and a clearly signaled one-level-deep reference to the engine ([`orch-pipeline`](../orch-pipeline/SKILL.md)) plus an inline example. Below anchor 5 because the referenced sibling engine file is absent from the evaluated bundle, so navigation to the load-bearing detail cannot be verified; above anchor 3, whose references are vague or whose content is misfiled.

4 / 5

Total

17

/

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: concrete action sequence, explicit 'Use when' clause, and a well-defined behavior-preservation niche that separates it from sibling skills. Trigger coverage and action specificity are very good but could add a few natural synonyms (e.g., 'clean up', 'remove duplication').

Suggestions

Add natural trigger synonyms such as 'clean up code', 'remove duplication', or 'dead code removal' to broaden the phrases users actually say when they want this skill.

Replace family-internal shorthand like 'gated commit' with a plainer concrete action (e.g., 'commit only after explicit approval') so every named capability is self-explanatory.

DimensionReasoningScore

Specificity

Lists several concrete actions — "confirm tests are green", "restructure without changing behavior", "keep tests green", "review, and gated commit" — but coverage has minor gaps: some phrasing is family-internal jargon ("gated commit") rather than plainly concrete actions. It sits clearly above anchor 3 (only 1-2 actions) but does not reach the comprehensive, self-contained coverage of anchor 5.

4 / 5

Completeness

Explicitly answers both: the what ("Orchestrate a behavior-preserving refactor — confirm tests are green, restructure without changing behavior, keep tests green, review, and gated commit") and the when ("Use when the structure should improve but behavior must not change") with a concrete trigger clause. Matches anchor 5; the 'when' is fully explicit, not merely implied as at anchor 4.

5 / 5

Trigger Term Quality

Strong natural terms users would say: "refactor", "behavior-preserving", "structure should improve", "tests are green". Missing common synonyms and variations such as "clean up code", "tidy", "remove duplication", or "dead code", so it falls just short of anchor 5's comprehensive synonym coverage while being noticeably above anchor 3.

4 / 5

Distinctiveness Conflict Risk

The behavior-preservation scope carves a clear niche ("structure should improve but behavior must not change") and even distinguishes siblings (orch-change-feature / orch-fix-defect in the body), so it is mostly distinct. Minor overlap risk remains with generic refactoring/review requests, keeping it below anchor 5's minimal-conflict niche.

4 / 5

Total

17

/

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

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

affaan-m/ECC

Path

skills/orch-refine-code/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.