CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

principle-build-the-lever

Apply to any non-trivial work, not just bulk work: edits, migrations, analyses, checks. Build the tool that does it or proves it (codemod, script, generator, or a skill your subagents follow) instead of working by hand. The tool is the artifact a reviewer can rerun.

65

Quality

82%

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

86%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-organized instruction-only principle skill: lean prose, concrete decision rules (triviality bar, deterministic lever beats fan-out, commit when work outlives the session), and an explicit prove-it-by-rerun validation step. The only real gap is that the core workflow and the delegate-skill contract are described in prose bullets rather than as an explicit ordered sequence or shown artifact.

DimensionReasoningScore

Conciseness

The body is lean and every line carries instruction — "Do the first unit by hand to learn the recipe, then build the tool. Prove it by rerunning it on that unit and diffing against your hand-done version" — with no padding and no explanation of concepts Claude already knows. It matches anchor 5: every token earns its place.

5 / 5

Actionability

Concrete, executable guidance throughout: a prove-it loop (rerun and diff against the hand-done unit), a task-to-tool mapping ("Codemod or script for edits, generator for repetitive files, a dump-to-sqlite query for analysis, a rerunnable check for verification"), and a triviality escape hatch. It is below anchor 5 only because some guidance stays at the heuristic level (e.g., the delegate skill's 'verification contract' and 'do-not-touch fences' are named but not shown).

4 / 5

Workflow Clarity

A clear sequence is present — do the first unit by hand, build the lever, prove it by rerunning and diffing, apply, commit when the work outlives the session — and it includes an explicit validation checkpoint ("Prove it by rerunning it on that unit and diffing against your hand-done version"). It sits at 4 rather than 5 because the sequence is spread across bullets rather than laid out as an ordered workflow, making the step order implicit.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references and is organized into clearly labeled sections (Why, Pattern, Balance), which per the short-skill exception qualifies for 5. Cross-links to sibling principles ([Laziness Protocol], [Encode Lessons in Structure], [Prove It Works]) are clearly signaled and one level deep.

5 / 5

Total

18

/

20

Passed

Description

71%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 specific, complete description that clearly states what the skill does and when to apply it, with a good set of natural trigger terms (codemod, script, generator, migrations, checks). Its main weakness is breadth: 'any non-trivial work' scopes it across nearly all work, raising overlap risk with other skills, and the 'when' depends on the subjective judgment of 'non-trivial'.

Suggestions

Tighten the 'when' clause with more concrete, checkable trigger phrases (e.g., 'Use when the task involves many similar edits, a migration, a repeatable analysis, or bulk checks') instead of the judgment-dependent 'any non-trivial work'.

Add common synonyms users actually say — 'refactor', 'automate', 'bulk rename' — to the trigger enumeration to improve trigger term coverage and distinguish it from general work skills.

State what the skill excludes (one-off trivial edits are already mentioned; make that boundary more explicit) to reduce conflict with skills that handle routine single edits.

DimensionReasoningScore

Specificity

The description lists several concrete artifacts and actions — "Build the tool that does it or proves it (codemod, script, generator, or a skill your subagents follow)" — and names target domains ("edits, migrations, analyses, checks"). It falls short of anchor 5 because coverage has gaps (e.g., no mention of refactors, bulk renames, or scaffolding), but exceeds anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Both parts are present: 'what' is explicit ("Build the tool that does it or proves it... instead of working by hand") and 'when' is given as equivalent trigger guidance ("Apply to any non-trivial work, not just bulk work: edits, migrations, analyses, checks"), so the 3-cap for missing trigger guidance does not apply. It stays at 4 rather than 5 because 'when' rests on the judgment-dependent phrase "non-trivial work" rather than fully concrete trigger phrases.

4 / 5

Trigger Term Quality

It includes natural terms users would plausibly say — "edits", "migrations", "analyses", "checks", "codemod", "script", "generator" — giving good keyword coverage. A few natural variations are missing ("refactor", "automate", "bulk rename"), keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The build-a-lever action itself is a clear niche ("Build the tool that does it or proves it"), but the trigger scope "any non-trivial work, not just bulk work" is broad enough to overlap many work-oriented skills. It is more specific than anchor 2's generic breadth but does not reach anchor 4's 'mostly distinct'.

3 / 5

Total

15

/

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

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository

adamsardo/pstack-claude

Path

plugins/pstack/skills/principle-build-the-lever/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.