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

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/small-change/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a well-engineered instruction-only workflow skill: every step is concrete and executable, validation checkpoints and feedback loops are explicit at each stage, and the writing stays lean. The main weaknesses are minor — a few rationale sentences that could be trimmed, specialist-agent behavior defined externally, and references that sit outside the skill bundle.

DimensionReasoningScore

Conciseness

The body is dense, procedural and assumes Claude's competence (no concept explanations), matching the 'efficient; minor instances of over-explanation' anchor — e.g. "A fabricated external value passes every local check, because tests, types and lint never look outward" and the "This skill has no relay" rationale sentence could be trimmed. Not 5 because the Host notes section and a handful of why-explanations carry tokens a tighter version would cut; not 3 because there is no padding and nothing explains what Claude already knows.

4 / 5

Actionability

Concrete, copy-paste-ready commands appear throughout ("git status --porcelain", "BASELINE_SHA=$(git rev-parse HEAD)", "CHANGED_FILES=$(git diff $BASELINE_SHA..HEAD --name-only)"), Dispatch blocks carry complete prompts with explicit per-host mappings, and commit-convention discovery lists exact file paths (".claude/skills/commit/SKILL.md", "commitlint.config.*") — the 'mostly executable guidance' anchor. Not 5 because the behavior of the three specialist agents (sdd-fact-checker etc.) is defined outside this file, leaving a minor gap in what each pass actually does.

4 / 5

Workflow Clarity

Sections §0–§8 form a clear sequence with explicit validation checkpoints at every stage — the §2 tree check, the §3 verification gate ("If they cannot be made to pass... do not commit"), the §4 dirty-file check before staging, and per-pass result states with ask-the-developer feedback loops — and §8's status lines encode exactly which passes ran. This matches the top anchor: explicit validation, feedback loops, and a checklist-style summary; not 4 because no checkpoint is left implicit.

5 / 5

Progressive Disclosure

The body is well organized into labeled sections and ends with a clearly signaled References section describing what each linked file contains ("upstream workflow guide, including failure paths", "upstream rationale"), both one level deep — the 'good structure; references mostly clear' anchor. Not 5 because the two references live outside the bundle at host-absolute paths (~/.agents/skills/implement-plan/references/...) rather than alongside the skill; not 3 because nothing that belongs in a separate file is inlined and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

58%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 communicates a clear, distinctive what — implement a small change then run three isolated review passes — but reads more like a workflow summary than a trigger. It lacks any "Use when..." guidance and offers few natural user phrases beyond "small change".

Suggestions

Add an explicit trigger clause, e.g. "Use when the developer asks for a small change, quick fix, minor edit, or tweak that does not need a reviewed plan."

Include natural synonyms users would actually say ("quick fix", "minor edit", "one-line change") so the skill surfaces on phrasing beyond just "small change".

Briefly name one or two concrete outcomes (e.g. commits the change, reports verified external facts) to close the specificity gap without padding.

DimensionReasoningScore

Specificity

Names several concrete actions — "Make a small change in the main session" plus the three named review passes ("fact, standards and final") — matching the 'several specific actions; minor gaps' anchor. Not 5 because committing, verification and the summary are unmentioned and "small change" leaves the change type vague; not 3 because it goes beyond 1-2 concrete actions.

4 / 5

Completeness

The 'what' is clear (implement in the main session, then three sequential review passes), but there is no "Use when..." clause or equivalent trigger guidance, so the when is only weakly implied — matching the guideline cap of 3. Not 4 because no explicit usage condition appears anywhere in the description.

3 / 5

Trigger Term Quality

"small change" is a phrase users naturally say, but common variations ("quick fix", "minor edit", "tweak", "one-line change") are absent and "isolated... passes" is internal workflow jargon users would not utter — the 'some relevant keywords but missing common variations' anchor. Not 4 because only one strong natural trigger term exists.

3 / 5

Distinctiveness Conflict Risk

The multi-pass isolated-review framing carves a fairly distinct niche versus generic code-review or planning skills, with only minor overlap risk ("review" could collide with review skills; sibling to a write-plan skill). Not 5 because "small change" plus "review" still overlaps broadly with ordinary review requests.

4 / 5

Total

14

/

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

phatblat/dotfiles

Path

.agents/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.