CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

small-change

Make a small change in the main session, then review it through isolated fact, standards and final passes

Quality

74%

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 ./.claude/skills/small-change/SKILL.md
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.

The body is a deliberately minimal pointer stub that delegates all content to a single shared skill via one clearly signaled, one-level-deep reference with a concrete path. It is fully concise and actionable for its single purpose, with only minor gaps: no overview of the delegated content and no handling for the case where the shared path is unavailable.

DimensionReasoningScore

Conciseness

The body is a maximally lean two-line pointer ('Load and follow the shared skill at `~/.agents/skills/small-change/SKILL.md`') with no explanation of concepts Claude already knows; the only extra line is a one-line provenance comment ('Generated by scripts/agent-harnesses.py; do not edit directly.') that also serves as edit guidance. Every token earns its place.

5 / 5

Actionability

'Load and follow the shared skill at `~/.agents/skills/small-change/SKILL.md`' is a single concrete, executable instruction with an exact path, matching 'mostly executable guidance'. It falls short of a 5 because there is no verification or fallback for the delegation (e.g., what to do if the shared path is absent) and no example beyond the single case, but it is far above 3 since nothing is vague or pseudocode.

4 / 5

Workflow Clarity

For a single-purpose pointer skill the one action is unambiguous, and the simple-skill exception applies, but there is a minor validation gap: no checkpoint confirming the shared skill was actually loaded/followed. It is not 3 because the single step is clear rather than a gapped multi-step sequence, and not 5 because no explicit validation of the delegation exists.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the body contains exactly one clearly signaled, one-level-deep reference ('Load and follow the shared skill at `~/.agents/skills/small-change/SKILL.md`') with no nesting. It misses 5 because the body provides no overview at all of what the delegated skill contains, so nothing can be discovered from this file alone.

4 / 5

Total

17

/

20

Passed

Description

55%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 clear, action-oriented 'what' — make a small change, then run three named review passes — but omits any 'when to use' trigger guidance, capping completeness. Trigger vocabulary is thin ('small change', 'review') without synonyms or natural user phrasings, leaving moderate overlap risk with generic edit/review skills.

Suggestions

Add an explicit 'Use when...' clause (e.g., 'Use when the user asks for a small edit, tweak, or quick fix followed by a structured review') to lift completeness above the cap of 3.

Broaden trigger terms with natural synonyms users actually say — 'small edit', 'quick tweak', 'minor fix' — to improve trigger_term_quality beyond the current 'small change' and 'review'.

Clarify the scope of 'small change' (code change, config edit, etc.) and lean on the distinctive 'fact, standards, final passes' vocabulary to reduce overlap with generic code-review/edit skills.

DimensionReasoningScore

Specificity

It lists several concrete actions — 'Make a small change in the main session' plus three named review passes ('isolated fact, standards and final passes') — with only minor gaps in coverage. It is not 5 because 'small change' is left undefined in scope and the content of each pass is not comprehensively specified, and not 3 because it goes beyond 1-2 actions by enumerating the distinct passes.

4 / 5

Completeness

The 'what' is clearly stated ('Make a small change in the main session, then review it through isolated fact, standards and final passes') but there is no 'Use when...' clause or equivalent trigger guidance anywhere, which caps completeness at 3 per the judging guidelines. It is not 4 because the 'when' is entirely absent rather than merely imprecise, and not 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

'small change', 'review', and 'main session' are relevant keywords a user might plausibly say, but common variations and synonyms ('quick edit', 'minor tweak', 'small fix') are absent. It is not 4 because keyword coverage is thin with several natural terms missing, and not 2 because the terms present are domain-relevant rather than purely generic.

3 / 5

Distinctiveness Conflict Risk

The pass structure ('isolated fact, standards and final passes') is somewhat distinctive, but 'small change' plus 'review' is phrasing that overlaps with generic edit and code-review skills. It is not 4 because the overlap with closely related change/review skills is more than minor, and not 2 because the named multi-pass review vocabulary keeps it from being broadly generic.

3 / 5

Total

13

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.claude/skills/small-change/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.