CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

principle-sequence-verifiable-units

Apply to multi-step work (sweeps, migrations, runs of similar edits) and to how you stack commits and PRs. Break work into small units that each end in a verifiable state, check each before the next, and order delivery so the sequence proves itself to a reviewer.

67

Quality

84%

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

78%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-sectioned principle skill that teaches a clear per-unit verify-then-advance workflow with an explicit delivery ordering, and it respects the reader's intelligence throughout. Its residual gaps are an implicit on-red recovery step, no worked example of the canonical commit stack, and minor rhetorical redundancy in the Why paragraph.

Suggestions

Add an explicit error-recovery step to the Execution section (e.g., 'If a unit's check fails, fix it before starting the next unit') to close the feedback loop for batch operations.

Include a short worked example of the canonical delivery shape — e.g., a 2-commit stack showing the failing test first, then the fix — to make the 'red, then green' pattern concrete.

Tighten the Why paragraph by dropping the redundant 'you have already built further on a broken base' clause, which restates the preceding sentence.

DimensionReasoningScore

Conciseness

The 17-line body is lean, assumes competence, and adds only non-obvious insight (ordering delivery so a reviewer can replay the argument); no padding explaining concepts Claude already knows. Not 5: the Why paragraph's second clause ("you have already built further on a broken base") restates the first, and rhetorical flourishes ("watch it go red, then green") could be trimmed.

4 / 5

Actionability

Concrete, unambiguous directives throughout: "Rebase onto clean trunk first", "Never batch the edits and verify once at the end", "the failing test first, then the fix on top", "a subtraction before the reshape, a baseline capture before the treatment". Not 5: there is no worked example (e.g., a sample commit stack showing red-then-green) to make the canonical shape copy-paste concrete.

4 / 5

Workflow Clarity

The core sequence is explicit with validation checkpoints: "known-good state, one change, run the check, then proceed" and "don't advance until the current one is green" — validation is central, so the batch-operation cap does not apply. Not 5: the on-red recovery loop (what to do when a unit's check fails) is only implied ("cheap to localize") rather than given as an explicit fix-then-proceed step.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (no bundle files exist), and the body is cleanly sectioned into Why, Execution, Delivery, and Pattern with a well-signaled cross-reference to the two sibling principle skills — matching the simple-skill exception for a top score.

5 / 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: it explicitly states what the skill does and when to apply it, with natural trigger terms (sweeps, migrations, commits, PRs) and three concrete capabilities. Its only weaknesses are minor — a few missing synonyms and slight overlap risk with sibling principle skills.

DimensionReasoningScore

Specificity

"Break work into small units that each end in a verifiable state, check each before the next, and order delivery" lists three distinct concrete actions in a specific domain, matching the 'several specific actions; minor gaps' anchor. Not 3 (more than 1-2 concrete actions) and not 5 (not a comprehensive catalog of capabilities, e.g., the on-red recovery behavior is absent).

4 / 5

Completeness

Both 'what' and 'when' are explicitly and concretely answered: the what is "Break work into small units that each end in a verifiable state, check each before the next, and order delivery", and the when is the explicit apply-to clause with concrete trigger phrases. The 'when' could not be meaningfully more explicit, matching the anchor-5 example's structure.

5 / 5

Trigger Term Quality

"multi-step work (sweeps, migrations, runs of similar edits)" and "stack commits and PRs" are natural phrases users would say when needing this skill. A few natural synonyms (e.g., 'refactor', 'bulk edits', 'review the stack') are missing, so it falls just short of the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a distinct niche (sequencing units for verification and ordering commits/PRs as proof), but it is a broadly applicable discipline that could mildly overlap with closely related principle skills (e.g., a 'verify each change' or 'small commits' skill). Mostly distinct with minor overlap risk, matching anchor 4.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

adamsardo/pstack-claude

Path

plugins/pstack/skills/principle-sequence-verifiable-units/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.