CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

patch-edit

Apply one rewrite-plan step at a time as small reviewable file edits, never rewriting whole files when a localised change suffices.

55

Quality

69%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/_official/atoms/patch-edit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

80%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 tight, well-structured instruction-only body that respects the token budget and gives concrete inputs, outputs, and a machine-checkable convergence condition. Its main weakness is the absence of explicit validation/verification checkpoints in a batch file-editing loop, which keeps workflow clarity at the capped midpoint.

Suggestions

Add an explicit validation checkpoint per iteration, e.g. 'After each edit, verify the unified diff applied cleanly and that only files in the step's files[] were touched before writing the receipt.'

Include a short error-recovery feedback loop (validation fails → revert or fix the edit → retry, respecting the iteration cap) alongside the convergence condition.

DimensionReasoningScore

Conciseness

The body is lean throughout: no explanations of concepts Claude already knows, no padding, and every section (Inputs, Output, Convergence, Anti-patterns, Status) carries unique operational information. It matches anchor 5 — every token earns its place; even the rationale paragraph is scoped to a spec citation rather than generic background.

5 / 5

Actionability

Guidance is concrete: named input files ('plan/steps.json', 'code/index.json', 'iterations'), an explicit receipt directory layout with the receipt's fields ('{ files: [...], diffSummary, rationale, completedAt }'), a complete jsonc loop-config block, and four specific forbidden behaviours. It is not 5 because details like the receipt's exact schema, the diffSummary format, and how 'smallest possible localised edit' is judged are left unspecified — minor gaps for an instruction-only skill.

4 / 5

Workflow Clarity

The sequence is inferable (read inputs → apply one step → write receipt → update status → repeat under an explicit convergence condition with a hard iteration cap), and the anti-patterns act as guardrails. However, this is a batch/destructive file-editing workflow with no explicit validation or verification checkpoint (e.g., confirm the diff applies cleanly or re-check step ownership on retry), so per the judging guidelines workflow clarity is capped at 3: sequence present, checkpoints missing or implicit.

3 / 5

Progressive Disclosure

The skill is under 50 lines, self-contained, needs no external reference files (no references/, scripts/, or assets/ exist, and none are required), and is organised into clean, well-labeled sections. Per the rubric's simple-skill guidance this matches the top anchor: a clear overview that is easy to navigate with no inline content that belongs in a separate file.

5 / 5

Total

17

/

20

Passed

Description

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

The description states a crisp, concrete 'what' with an effective contrast (localised edit vs whole-file rewrite), but completely lacks a 'when to use' trigger clause and uses only internal system jargon as keywords. As a routing signal it is halfway functional: distinctive once read, but hard to trigger naturally.

Suggestions

Append an explicit trigger clause, e.g. 'Use when executing steps from plan/steps.json or when the agent is tempted to rewrite a whole file for a localised change.'

Add natural user-facing keywords and synonyms (e.g., 'small diffs', 'surgical edits', 'refactor plan steps') alongside the internal jargon so the description triggers on plain-language requests.

Briefly enumerate one or two more concrete actions (e.g., writing per-step receipts, updating step status) to lift coverage from 1-2 actions toward the 'several specific actions' level.

DimensionReasoningScore

Specificity

The description names its domain ('rewrite-plan step') and two concrete actions — 'Apply one rewrite-plan step at a time as small reviewable file edits' and 'never rewriting whole files when a localised change suffices' — but stops there. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it is below anchor 4 because it lists no further actions (receipts, status updates, iteration handling) and above anchor 2 because the actions it does name are concrete rather than generic.

3 / 5

Completeness

The 'what' is clear (apply plan steps as small, localised, reviewable edits; never rewrite whole files), but 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 2 because the 'what' is concrete, and not 4 because the 'when' is not even weakly implied.

3 / 5

Trigger Term Quality

The only candidate keywords are internal jargon ('rewrite-plan step', 'localised change', 'reviewable file edits') — terms a user would not naturally say when needing this skill, and there are no synonyms or plain-language variations. This fits anchor 2 (keywords present but missing the natural phrases users say); not 1 because the terms are at least domain-relevant rather than entirely generic, and not 3 because no common user-facing variation is covered.

2 / 5

Distinctiveness Conflict Risk

'Apply one rewrite-plan step at a time' carves a clear niche tied to a specific plan-driven workflow, making confusion with general editing skills unlikely. It is not 5 because the description has no explicit triggers, so selection depends entirely on the 'what' statement; it is clearly above 3 because 'rewrite-plan step' is far more specific than the broad overlap examples at that level.

4 / 5

Total

12

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

nexu-io/open-design

Path

plugins/_official/atoms/patch-edit/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.