CtrlK
BlogDocsLog inGet started
Tessl Logo

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. Can critique architecture. DO NOT use for design rationale or history (use why instead), or for proving a change is safe to ship (use blast-radius instead). Triggers: how does X work, walk me through X, where should this live, critique this architecture, whats wrong with this design.

72

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

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.

The body is a well-structured, highly actionable orchestration workflow with explicit verification checkpoints, error-recovery loops, and clean externalization of prompt templates to one-level-deep references. Its main weakness is token efficiency: repeated fallback phrasing and meta-commentary about the port could be cut or consolidated.

Suggestions

State the code-graph-first / Glob-Grep-Read-fallback rule once (e.g., in Prerequisites) and stop repeating it in Step 2a, Step 2b, and Step 3 — the repetition appears roughly five times and costs tokens without adding information.

Trim or move the porting blockquote (Cursor adaptation notes, worktree re-indexing caveat) into a reference file; it is meta-commentary about the skill's origin rather than runtime guidance.

Merge the standalone Verification section with the identical verify instruction inside Step 4 — they describe the same spot-check twice.

DimensionReasoningScore

Conciseness

The body is mostly efficient — it teaches nothing Claude already knows — but the code-graph-vs-Glob/Grep/Read fallback is restated roughly five times (blockquote, Prerequisites, Step 2a twice, Step 2b, Step 3), the porting blockquote is runtime-irrelevant meta-commentary, and the Verification section duplicates Step 4's verify instruction. This fits the 3 anchor (could be tightened) rather than 2, since the padding is repetition rather than padded explanatory sections.

3 / 5

Actionability

For an instruction-only orchestration skill the guidance is fully concrete: exact subagent types ("Explore", "general-purpose"), specific model/effort combos for critics ("sonnet/high, opus/xhigh, sonnet/max, fable/high"), a 2-4 explorer range with an example decomposition for a rate-limiter question, a finding categorization scheme (Act on/Consider/Noted/Dismissed), and a defined output format — specific examples cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

Both modes are clearly sequenced (Step 1 complexity assessment → 2a/2b branch → 3 → 4) with an explicit validation checkpoint ("pick at least one non-obvious claim and re-run the code-graph query... to confirm it still says what the explanation says") and error-recovery feedback loops in Troubleshooting (explorers contradict → synthesizer re-checks source; narrow question broadens → switch to the parallel-explorer path mid-stream). This matches the 5 anchor's explicit validation and feedback loops.

5 / 5

Progressive Disclosure

The four prompt templates and rubric are correctly externalized to real, one-level-deep reference files (references/explorer-prompt.md, explainer-prompt.md, critic-prompt.md, critique-rubric.md — all verified present with substantive content), each clearly signaled with its path and purpose at the point of use, while the orchestration logic stays in the body — an appropriate split matching the 5 anchor.

5 / 5

Total

18

/

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.

A strong description: concrete capabilities, an explicit Use-for clause, a dedicated trigger list, and named negative boundaries against sibling skills. The only weakness is limited synonym variation in the trigger phrases.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — "Explains subsystem architecture, runtime flow, onboarding mental models", code walkthroughs, placement/ownership/layering questions, and "Can critique architecture" — with comprehensive coverage of its domain and no evident gaps, matching the anchor for multiple specific concrete actions rather than the minor-gaps anchor at 4.

5 / 5

Completeness

It explicitly answers both what ("Explains subsystem architecture, runtime flow, onboarding mental models... Can critique architecture") and when (an explicit "Use for" clause plus a dedicated "Triggers:" list), with concrete trigger phrases — a clear match for the 5 anchor; the 4 anchor requires a 'when' that could be more explicit, which is not the case here.

5 / 5

Trigger Term Quality

Seven natural quoted phrases users would actually say ("how does X work", "walk me through X", "where should this live", "which package owns this", "is this the right layer", "critique this architecture", "whats wrong with this design") give good coverage, but common variants like "explain how X", "architecture overview", or "how is X structured" are missing, fitting the 4 anchor rather than the comprehensive-synonym-coverage anchor at 5.

4 / 5

Distinctiveness Conflict Risk

The niche (explaining how code works) is distinct, and negative boundaries name sibling skills explicitly — "DO NOT use for design rationale or history (use why instead), or for proving a change is safe to ship (use blast-radius instead)" — giving minimal conflict risk, matching the 5 anchor for a clear niche with distinct triggers.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.