CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

72

Quality

90%

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

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 highly actionable, well-sequenced orchestration skill with real, well-organized reference files and explicit validation. Its main weakness is repetition: several rules (skip justification, tool-preference mapping, evidence-first posture) are stated in multiple sections, and the body carries detail that could live in the references.

Suggestions

Consolidate the investigator-skip guidance into one place — it currently appears in the header note, 'When to skip an investigator', Troubleshooting, and 'NEVER skip an investigator because you assume its category won't have anything' — and cross-reference it from the others.

Merge the header note's code-graph-vs-raw-git mapping with Step 2's identical (and more complete) mapping, keeping a one-line pointer in the header.

Fold 'Operating Posture' into 'Core Epistemics' (both state 'Evidence before narrative' and hedging rules) and move the investigator-roster detail into a reference file, keeping only the one-line category list in the body.

DimensionReasoningScore

Conciseness

The guidance is operational and never explains concepts Claude already knows, but the same rules are restated several times: investigator-skip justification appears in the header note, 'When to skip an investigator', Troubleshooting, and the NEVER list; the code-graph-vs-raw-git mapping appears in both the header note and Step 2; 'Evidence before narrative' appears in both Operating Posture and Core Epistemics. This matches anchor 3 ('mostly efficient but... could be tightened') rather than 2 — the excess is repetition of skill-specific guidance, not background explanation or fluff.

3 / 5

Actionability

Fully executable throughout: exact git commands ('git blame -L <start>,<end> <file>', 'git log --follow -p -- <file>'), a copy-paste-ready 'gh pr view <number> --json title,body,author,createdAt,mergedAt,labels,closingIssuesReferences,comments,reviews', tokensave tool signatures, explicit subagent config (subagent_type, model), a numbered per-investigator input checklist, and a worked Sources Consulted example. Anchor 5 — specific commands cover the common cases.

5 / 5

Workflow Clarity

Steps 1–5 are clearly sequenced, and a dedicated Verification section supplies an explicit validation checkpoint ('spot-check at least one citation... Run this the same way you'd run a test before shipping'), with error-recovery feedback in Troubleshooting and Common Failure Modes (each with a WHY). Anchor 5: clear sequence, explicit validation, feedback loops.

5 / 5

Progressive Disclosure

All cited references exist and are one level deep, clearly signaled both inline and in the Reference Files section, with references/source-playbook.md indexing references/sources/*.md — good structure matching anchor 4. Not anchor 5: the ~370-line body itself carries substantial detail (the full investigator roster, a summary of the epistemics framework that duplicates references/epistemics.md, and the long porting/precedence header note) that is closer to reference material than overview.

4 / 5

Total

17

/

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: concrete third-person capabilities, a rich natural-language trigger list, explicit what/when with negative triggers, and explicit disambiguation from sibling skills. No padding or over-claims.

DimensionReasoningScore

Specificity

Lists multiple concrete third-person actions — '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' — with comprehensive coverage of the mechanism. Anchor 5 fits better than 4 because no capability area is missing or generic.

5 / 5

Completeness

Explicitly answers both: what it does ('Discovers available MCPs and queries each evidence category... in parallel, then returns a cited read on decisions and tradeoffs') and when to use it ('Use for...' plus a concrete 'Triggers:' list), and even adds explicit negative triggers ('DO NOT use for... use how instead... use blast-radius instead'). Clearly anchor 5, not 4 — the 'when' is as explicit and specific as the 'what'.

5 / 5

Trigger Term Quality

'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' covers the natural phrasings users would actually say, plus synonyms in the opening ('design rationale, regressions, postmortems, or data-backed thresholds'). Comprehensive synonym coverage matches anchor 5; nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (motivation/rationale archaeology) and actively disambiguates from adjacent skills: 'DO NOT use for explaining current runtime behavior (use how instead), or for proving a change is safe to ship (use blast-radius instead)'. Minimal conflict risk — anchor 5, not 4, because the sibling-skill boundaries are stated rather than merely implied.

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.

Validation15 / 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
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.