CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

principle-encode-lessons-in-structure

Apply when you catch yourself writing the same instruction a second time, or notice a recurring correction. Encode the rule as a lint, metadata flag, runtime check, or script instead of more text.

70

Quality

88%

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

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

An exceptionally tight, instruction-only skill body: every section adds judgment-level guidance Claude does not already have, with a concrete decision procedure, an explicit mechanism hierarchy, and a capture/route/close feedback loop. The only uplift available is a worked example showing an actual correction converted into a real lint rule or script.

DimensionReasoningScore

Conciseness

The body is lean with zero padding: no explanation of concepts Claude already knows, and even the rationale lines ('Textual instructions are easy to miss...') and the corollary ('The instruction IS the symptom') each earn their tokens, matching the top anchor.

5 / 5

Actionability

Concrete decision procedure with an explicit branch ('If yes, encode it. Delete the instruction / If no... make the instruction more prominent and add an example of the failure mode'), an ordered mechanism hierarchy ('an unrepresentable state that cannot compile, then a lint or banned API that fails CI, then a canonical helper, then a runtime check'), and a routing table ('One-off -> brain note. Recurring fix -> skill or lint rule. Systemic issue -> principle'). Per the rubric's scoring note, the absence of code is not penalized for an instruction-only skill, but a worked example (e.g., an actual lint config or script snippet) is what separates it from fully copy-paste-ready guidance at the 5 anchor.

4 / 5

Workflow Clarity

The detect -> ask -> encode-or-branch sequence is unambiguous, the feedback loop (capture -> route -> close the loop) is explicit, and no destructive or batch operations exist that would require validation checkpoints, so the simple-skill exception applies at the top anchor.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files and no content that warrants external references; the body is organized into well-labeled sections (Why, Pattern, Corollary, Feedback loop, Anti-patterns), which per the rubric's simple-skill note earns the top score on well-organized sections alone.

5 / 5

Total

19

/

20

Passed

Description

78%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, well-scoped description with an explicit and concrete trigger clause and a clear statement of the mechanism to apply. Its main weaknesses are second-person voice in the trigger phrasing and somewhat thin coverage of natural trigger synonyms.

Suggestions

Rewrite the trigger clause in third person (e.g., 'Apply when the same instruction is being written a second time or a correction recurs') to avoid the second-person voice penalty.

Add natural trigger synonyms users and models would actually say, such as 'repeated feedback', 'keeps making the same correction', or 'encode the lesson as a lint rule'.

State the what more comprehensively by naming where each mechanism lives (e.g., lint rule in CI, metadata flag in config, runtime check in code) to move specificity toward the top anchor.

DimensionReasoningScore

Specificity

The description names concrete mechanisms ("a lint, metadata flag, runtime check, or script") but the 'what' is a single action with variants rather than several distinct actions, and the second-person phrasing ("you catch yourself") incurs the rubric's voice penalty, dropping it from the 4 anchor to 3.

3 / 5

Completeness

Both halves are explicit and concrete: the 'when' is an explicit "Apply when..." clause with specific trigger phrases, and the 'what' states exactly what to do ("Encode the rule as a lint, metadata flag, runtime check, or script instead of more text"), matching the top anchor rather than the merely-adequate 4 anchor.

5 / 5

Trigger Term Quality

"writing the same instruction a second time" and "recurring correction" are natural trigger phrases with good coverage, though common variations like 'repeated feedback' or 'keeps correcting me' are missing, so it falls at the 4 anchor rather than 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (encoding recurring corrections as structural mechanisms) with distinct triggers, with only minor overlap risk against general feedback-recording or memory-keeping skills.

4 / 5

Total

16

/

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-encode-lessons-in-structure/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.