CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

why

Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Discovers available MCPs and queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel, then returns a cited read on decisions and tradeoffs. Use how for runtime behavior.

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

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.

A strongly operational skill: executable git/gh commands, precise subagent configuration, a well-sequenced five-step workflow with real validation gates, and a verified, clearly signaled reference bundle. Its main weakness is token efficiency — the epistemic guidance and skip rules are each stated two to three times — plus minor navigation duplication toward the source playbooks.

Suggestions

Merge "Operating Posture" and "Core Epistemics" into one section: 'Hedge on purpose' vs 'Prefer appears to over because', and 'Name the gaps' vs 'Acknowledge gaps' repeat the same guidance nearly verbatim; state each principle once.

State the never-skip-without-searching rule once (in Step 3's 'When to skip an investigator') and have the 'Skipping investigators by anticipation' failure mode reference it in one line instead of restating the rationale.

Trim the inline investigator roster to one or two lines per category (category → the kind of 'why' it uniquely surfaces) and move the fuller 'what to expect back' detail into the corresponding references/sources/<source>.md playbook, which also resolves the navigation duplication between source-playbook.md and SKILL.md's Reference Files section.

DimensionReasoningScore

Conciseness

Mostly efficient — concrete commands, no filler explaining concepts Claude already knows — but guidance is duplicated between "Operating Posture" ("Hedge on purpose", "Name the gaps") and "Core Epistemics" ("Prefer 'appears to' over 'because'", "Acknowledge gaps"), and the default-to-all-seven rule is stated three times (Step 3 intro, "When to skip an investigator", and "Skipping investigators by anticipation"). This is more than minor trimmable over-explanation (not 4), but it is dense and specific rather than padded (not 2).

3 / 5

Actionability

Fully executable guidance throughout: copy-paste commands ("git log --follow -p -- <file>", "gh pr view <number> --json title,body,author,createdAt,mergedAt,labels,closingIssuesReferences,comments,reviews"), exact subagent spawn config (subagent_type, model defaults), a fully specified output format with concrete example "Sources Consulted" lines, and explicit reference files per role. Specific examples cover the common cases.

5 / 5

Workflow Clarity

A clear five-step sequence (Understand → Code Anchor → Spawn Investigators → Synthesize → Present) with explicit validation checkpoints: skipping a category requires an "explicit, written justification" in the final output, inline answers are permitted only "after confirming all seven available category searches would be redundant", null results are documented in a coverage map, and the synthesizer's "quality check spot-verifies citations". Not 4: checkpoints are explicit, not mostly present.

5 / 5

Progressive Disclosure

Good structure: a dedicated "Reference Files" section describes each bundle file's purpose, every referenced path (references/epistemics.md, investigator-prompt.md, synthesizer-prompt.md, source-playbook.md, sources/*.md) exists on disk, and references are one level deep with sources/*.md linked directly from SKILL.md. Not 5: navigation to the category playbooks is duplicated (both the source-playbook.md index and SKILL.md's direct listing), and the ~30-line inline investigator roster substantially overlaps the content that lives in the per-category references/sources/*.md playbooks — minor organization gaps.

4 / 5

Total

17

/

20

Passed

Description

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

An excellent description: third-person, concise, explicit about both what it does (parallel MCP discovery and per-category evidence queries, cited synthesis) and when to use it, with direct quotes of natural user phrasings. The only weakness is that a few natural trigger synonyms (e.g., 'history of X', 'alternatives considered') are missing.

DimensionReasoningScore

Specificity

Quotes: "Discovers available MCPs and queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel, then returns a cited read on decisions and tradeoffs." Multiple specific concrete actions are listed with all seven categories enumerated, matching the comprehensive-coverage anchor; the minor-gaps anchor (4) fits worse since nothing material is missing.

5 / 5

Completeness

Quotes: "Use for 'why does X work this way', ..." (explicit when, with concrete trigger phrases) and "Discovers available MCPs and queries each evidence category ... then returns a cited read on decisions and tradeoffs" (explicit what). Both what and when are clearly and explicitly answered, matching the top anchor; the score-4 anchor's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Quotes: "Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds." Direct user-voice trigger phrases plus several category keywords give good coverage, but a few natural terms users would say are absent (e.g., "history of X", "why was this built", "alternatives considered"), which fits the good-coverage-with-missing-terms anchor (4) rather than comprehensive synonym coverage (5).

4 / 5

Distinctiveness Conflict Risk

Quote: "Use how for runtime behavior." The skill carves a clear niche (design-rationale archaeology across seven evidence systems) and explicitly disambiguates against its closest sibling skill, minimizing wrong-skill triggering; no minor overlap risk beyond that is apparent.

5 / 5

Total

19

/

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

referenced_paths_exist

Referenced path issues: 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

adamsardo/pstack-claude

Path

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