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

Quality

89%

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

77%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 well-structured orchestration skill: the two-mode workflow is clearly sequenced with genuine validation checkpoints and error-recovery paths, and details are properly offloaded to real one-level-deep reference files. The main cost is token efficiency — the code-graph fallback rule and the verification spot-check are each repeated several times, and the porting provenance blockquote adds little to executing the skill.

Suggestions

State the code-graph-preferred / Glob-Grep-Read-fallback rule once (e.g., in Prerequisites) and drop the ~5 restatements across the header note, Steps 2a/2b/3/4, Verification, and Mindset.

Merge the standalone Verification section into Step 4 — both describe the same pre-presentation spot-check of a non-obvious claim.

Trim the porting/provenance blockquote to the single operative sentence about preferring code-graph tools, removing the discussion of the original Cursor skill and its adaptations.

DimensionReasoningScore

Conciseness

Mostly efficient and dense with useful orchestration guidance, but the code-graph-vs-Glob/Grep/Read fallback rule is restated roughly six times (header note, Prerequisites, Steps 2a/2b/3/4, Verification, Mindset), the Verification section duplicates Step 4's spot-check, and the porting blockquote is provenance commentary — "some unnecessary explanation or could be tightened" rather than the 4 anchor's "minor instances of over-explanation".

3 / 5

Actionability

As an instruction-only orchestration skill it gives concrete, executable guidance: exact subagent types ("Explore", "general-purpose"), model/effort combinations ("sonnet/high, opus/xhigh"), a 2-4 explorer split with a worked example, and structured output specs. It stops short of the 5 anchor because the actual prompt templates are delegated to reference files rather than being copy-paste ready inline — a minor gap, not the missing-steps pattern of the 3 anchor.

4 / 5

Workflow Clarity

Clear two-mode sequence with conditional branching (Step 2a vs 2b), an explicit validation checkpoint (re-run a query on a non-obvious claim before presenting), and error-recovery feedback loops in Troubleshooting (contradicting explorers → synthesizer re-checks the source; a narrow question that grows → switch to the complex path mid-stream; empty code-graph results → narrower search). This matches the 5 anchor's explicit validation and feedback loops.

5 / 5

Progressive Disclosure

The body is an overview that pushes the four prompt/rubric templates to well-signaled, one-level-deep references (references/explorer-prompt.md, explainer-prompt.md, critic-prompt.md, critique-rubric.md), all of which exist as real files; no nested references and no bulk content inlined that belongs elsewhere.

5 / 5

Total

17

/

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: it states concrete capabilities, gives an explicit trigger list with natural phrasing variants, answers both what and when clearly, and disambiguates against sibling skills. Its only weakness is that the named actions ("explains", "critiques", "onboarding mental models") are a level more abstract than fully concrete capability lists.

DimensionReasoningScore

Specificity

Lists several specific actions — "Explains subsystem architecture, runtime flow, onboarding mental models. Can critique architecture" — but the actions are somewhat abstract compared to the fully concrete action lists in the 5 anchor, fitting "several specific actions; minor gaps in coverage" instead.

4 / 5

Completeness

Explicitly answers both what ("Explains subsystem architecture, runtime flow, onboarding mental models. Can critique architecture") and when ("Use for..." plus a concrete "Triggers:" list and DO-NOT-USE redirects), matching the 5 anchor; the 4 anchor would require a less explicit 'when', which is not the case.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrases including question variants and synonyms: "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" — nothing natural is missing, so the 4 anchor ("a few natural terms missing") does not fit.

5 / 5

Distinctiveness Conflict Risk

Clear niche (mechanistic "how" questions) with explicit sibling-skill disambiguation — "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, beyond the 4 anchor's "minor overlap risk".

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

pantheon-org/tekhne

Path

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