CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

how

Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions ("where should this live", "which package owns this", "is this the right layer"). Explains subsystem architecture, runtime flow, onboarding mental models. Use why for motivation.

78

Quality

98%

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

100%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 tightly written orchestration skill: it triages complexity, sequences explorer/explainer subagent spawns with explicit routing and fallback behavior, and delegates prompt content to two well-signaled, one-level-deep reference templates that verifiably exist in the bundle. Every token is operational guidance rather than explanation, and failure modes (missing rule, rejected model slug, ambiguous scope, contradictory findings) each have an explicit recovery path.

DimensionReasoningScore

Conciseness

The ~30-line body contains no concept explanations and no padding — every sentence is operational policy ("Every spawn is a Task subagent with `subagent_type: generalPurpose` and `readonly: true`"). It assumes Claude's competence ("When in doubt, take the simple path.") and even calibrates output depth in one clause ("not so much that it reads like annotated source code").

5 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact subagent configuration, model defaults with explicit fallbacks ("If the Task tool rejects a slug, use the default and say so. If it rejects the default, use the closest valid slug of the same family from its error message"), concrete complexity criteria, and template files with placeholders ("built from `references/explainer-prompt.md` without the explorer-findings section").

5 / 5

Workflow Clarity

The sequence is numbered with unambiguous branching ("Go to step 4" / "go to step 2"), an explicit ambiguity checkpoint ("state your interpretation and explore. The user can redirect"), and error-recovery loops (slug-rejection fallbacks; the explainer template's instruction to "resolve contradictions by checking the code yourself"). The skill is read-only, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

The body is a lean overview that inlines only orchestration policy and points to two real, one-level-deep bundle files (`references/explorer-prompt.md`, `references/explainer-prompt.md`), each referenced from a specific step with its role stated; neither reference file nests further references. The Output format section names the template's sections for navigation.

5 / 5

Total

20

/

20

Passed

Description

95%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 with an explicit 'Use for...' trigger clause containing verbatim user phrasings and synonyms, a concrete third-person capability statement, and explicit routing away from the sibling 'why' skill. The only weakness is modest coverage of the full capability surface — the 'what' lists the core explanation activities but omits concrete deliverables like diagrams and file maps.

DimensionReasoningScore

Specificity

It names the domain (codebase comprehension) and several concrete capabilities — "Explains subsystem architecture, runtime flow, onboarding mental models" plus "code walkthroughs before changing something" — in third person. Not 5 because the capability list has gaps: deliverables the skill actually produces (diagrams, file maps, gotchas) are unstated; not 3 because it goes beyond 1-2 generic actions with specific, distinct objects.

4 / 5

Completeness

Both halves are explicit: the trigger clause opens the description ("Use for 'how does X work', code walkthroughs before changing something, and placement / ownership / layering questions") and the what follows concretely ("Explains subsystem architecture, runtime flow, onboarding mental models"). This mirrors the 5 anchor's structure of concrete trigger phrases plus an explicit capability statement.

5 / 5

Trigger Term Quality

It quotes the verbatim natural phrases users would say — "how does X work", "where should this live", "which package owns this", "is this the right layer" — including synonym variations of the placement question, plus "code walkthroughs". This matches the comprehensive anchor rather than the 4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (comprehension/explanation of existing code) with distinctive quoted triggers, and actively disambiguates from the closest sibling skill ("Use why for motivation"), minimizing wrong-skill triggering. Not 4: the main overlap risk (why vs. how questions) is explicitly addressed rather than merely minor.

5 / 5

Total

19

/

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

cursor/plugins

Path

pstack/skills/how/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.