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. DO NOT use for explaining current runtime behavior (use how instead), or for proving a change is safe to ship (use blast-radius instead). Triggers: why does X work this way, why did we pick Y over Z, what motivated this, why does this still exist, history of X.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 highly actionable, well-orchestrated skill body: every step is executable with concrete commands, validation checkpoints are explicit, and the multi-file bundle is cleanly structured and easy to navigate. The one real weakness is token efficiency — the epistemic posture is repeated across three body sections that also duplicate guidance from the opening blockquote and references/epistemics.md.

Suggestions

Collapse "Mindset", "Operating Posture", and "Core Epistemics" into a single short epistemics section (one summary plus the pointer to references/epistemics.md) — principles like "evidence before narrative", hedging, and "name the gaps" are currently stated three times in the body.

Trim the opening ported-from blockquote to provenance only; its tokensave-first and MCP-mapping guidance is repeated nearly verbatim in Step 2 and the Discovery subsection — state each point once where it's operationally used.

Consider moving the per-category roster detail (what each of the 7 investigators physically contains and surfaces) into references/source-playbook.md or the per-source playbooks, keeping only the spawn/skip decision rules in the body.

DimensionReasoningScore

Conciseness

Mostly efficient operational content, but the same epistemic principles (evidence before narrative, hedging, naming gaps, no intent from code shape) are stated three times across "Mindset", "Operating Posture", and "Core Epistemics" before the pointer to references/epistemics.md, and the opening blockquote's tokensave/MCP-mapping guidance is repeated in Step 2 and the Discovery subsection. Not anchor 2 because the majority of the 378 lines — tool commands, roster, skip rules, output format, failure modes — is dense non-redundant guidance, not padding.

3 / 5

Actionability

Fully executable, copy-paste-ready guidance: exact tokensave tool signatures (tokensave_blame/log/diff/changelog with parameters), concrete git fallbacks (git blame -L <start>,<end>, git log --follow -p), the full gh pr view --json field list, subagent config (subagent_type, model guidance), and a worked example of the Sources Consulted output lines.

5 / 5

Workflow Clarity

Steps 1–5 (Understand → Code Anchor → Spawn Investigators → Synthesize → Present) are clearly sequenced, with an explicit validation checkpoint in the Verification section ("spot-check at least one citation... Run this the same way you'd run a test before shipping") and feedback loops via the Troubleshooting and Common Failure Modes sections covering contradiction handling, empty results, and misapplied skips.

5 / 5

Progressive Disclosure

The body holds orchestration while details are split one level deep into verified, well-signaled files: epistemics.md (confidence framework), investigator-prompt.md and synthesizer-prompt.md (templates), and a per-category playbook index (source-playbook.md → sources/*.md, which SKILL.md also references directly), with a Reference Files section mapping each file to its purpose. All referenced paths exist in the bundle.

5 / 5

Total

18

/

20

Passed

Description

100%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 exemplary description: it concretely states the full capability arc (discover MCPs, query seven enumerated evidence categories in parallel, return a cited read), gives explicit positive and negative triggers in natural user phrasing, and actively routes edge cases to the companion skills it could be confused with. Every clause carries information with no padding.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions covering the full pipeline: "Discovers available MCPs", "queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel", and "returns a cited read on decisions and tradeoffs" — the enumerated categories make the capability set comprehensive rather than generic.

5 / 5

Completeness

Both what and when are explicit: the what is "Discovers available MCPs and queries each evidence category... returns a cited read on decisions and tradeoffs", and the when is given twice — "Use for..." and the dedicated "Triggers:" clause with concrete trigger phrases, plus negative triggers for companion skills.

5 / 5

Trigger Term Quality

The trigger list — "why does X work this way, why did we pick Y over Z, what motivated this, why does this still exist, history of X" — plus "design rationale, regressions, postmortems, or data-backed thresholds" comprehensively covers the natural phrases a user would say, including synonyms. No file extensions apply to this skill's domain.

5 / 5

Distinctiveness Conflict Risk

Clear niche (design-rationale archaeology) with minimal conflict risk: the explicit negative triggers — "DO NOT use for explaining current runtime behavior (use how instead), or for proving a change is safe to ship (use blast-radius instead)" — proactively disambiguate it from the two most confusable sibling skills.

5 / 5

Total

20

/

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

pantheon-org/tekhne

Path

skills/software-engineering/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.