CtrlK
BlogDocsLog inGet started
Tessl Logo

guided-interview

Conduct a structured, one-question-at-a-time interview to explore a specific topic or decision — each question offers 3-4 concrete, mutually exclusive options plus a free-text path, and later questions adapt to prior answers rather than following a fixed script. Ends with a recap the user confirms before finalizing, and only then produces a synthesized answer or (when the interview clearly feeds downstream work) a written brief. NOT for open-ended ambiguity-surfacing (use socratic-method) or single-fact lookups.

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

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

An unusually well-executed instruction skill: a concrete seven-step protocol with named tools, hard gates, a troubleshooting table, a verification checklist, and real, well-labeled one-level-deep references. The only meaningful cleanup is the pseudo-executable "Quick diagnostic" bash block and minor repetition of the question budget.

Suggestions

Delete or replace the "Quick diagnostic" section — the command `echo "$USER_PROMPT" | head -c 200` does not "Returns 'interview' or 'answer-directly'" as its comment claims, so it reads as filler and is the weakest part of an otherwise fully actionable document.

State the 3-6 question budget once (in "When to use") and let protocol step 5 reference it, rather than repeating the count and the sufficiency check in both places.

DimensionReasoningScore

Conciseness

The body is lean and imperative — no concept explanations of things Claude already knows, and each rule is stated once with a WHY/BAD/GOOD trio. Two spots could be trimmed: the "Quick diagnostic" bash block (echoing "$USER_PROMPT" through head adds no real capability) and the 3-6 question budget, which is stated in "When to use", protocol step 5, and again implicitly in step 5's sufficiency check. This is anchor 4 (efficient, minor instances that could be trimmed), not 5.

4 / 5

Actionability

Fully actionable instruction-only guidance: it names the exact tool ("Use the AskUserQuestion tool for a single question at a time"), fixes exact option counts ("3-4 concrete, mutually exclusive options"), gives a copy-ready opening script, per-situation troubleshooting responses, and concrete BAD/GOOD examples for every rule. Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this specific.

5 / 5

Workflow Clarity

The 7-step protocol is clearly sequenced with explicit validation checkpoints: an adaptive check before each question ("does this answer make a planned question moot?"), a sufficiency gate ("could I write the recap right now without guessing?"), a hard confirm-before-finalize gate, and a closing verification checklist including contradiction-surfacing and file-existence checks. This matches the top anchor's sequence-with-explicit-validation-and-checklists pattern; no destructive or batch operations are involved.

5 / 5

Progressive Disclosure

The body is a clear overview (~200 lines) with two well-signaled, one-level-deep references — [`question-design.md`](references/question-design.md) and [`worked-example.md`](references/worked-example.md) — both verified to exist, each annotated with exactly what it contains, and neither nesting further references. Content is appropriately split: the deep question-design rationale and the full transcript live outside the body.

5 / 5

Total

19

/

20

Passed

Description

83%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, third-person, comprehensive on capabilities, and explicitly differentiated from the adjacent socratic-method skill. Its main weakness is that triggering is defined almost entirely by exclusion — a positive "Use when..." clause with the natural phrases users actually say would lift both completeness and trigger-term quality.

Suggestions

Add a positive trigger clause such as "Use when the user asks to be interviewed, wants to be walked through a decision one question at a time, or says 'help me figure out' a nameable topic" to complement the negative boundary guidance.

Include the natural phrasings users actually say ("interview me", "ask me questions", "walk me through this decision") so trigger matching does not depend on the word "interview" alone.

DimensionReasoningScore

Specificity

The description lists multiple concrete, comprehensive actions — "one-question-at-a-time interview", "3-4 concrete, mutually exclusive options plus a free-text path", "later questions adapt to prior answers", "Ends with a recap the user confirms before finalizing", "produces a synthesized answer or... a written brief" — all in third person. It matches the anchor for multiple specific concrete actions with comprehensive coverage; there is no vague filler to push it down.

5 / 5

Completeness

The "what" is explicit and detailed, and "when" guidance exists but only negatively ("NOT for open-ended ambiguity-surfacing (use socratic-method) or single-fact lookups") plus an implicit purpose clause ("to explore a specific topic or decision") — there is no positive "Use when..." trigger phrase. This fits anchor 4 (both present, 'when' could be more explicit) rather than 5, and the explicit boundary clause keeps it above anchor 3 where 'when' is merely weakly implied.

4 / 5

Trigger Term Quality

Good natural keyword coverage — "interview", "one-question-at-a-time", "decision", "brief", "recap" — but common user phrasings like "ask me questions", "help me decide", or "walk me through" are absent (some appear only in the body, not the description). It sits between "good coverage, a few natural terms missing" (4) and comprehensive synonym coverage (5), and is not noticeably above the 4 anchor.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (structured interview with concrete curated options) and explicitly redirects the nearest competitor: "NOT for open-ended ambiguity-surfacing (use socratic-method)". Distinct triggers and a named differentiation give minimal conflict risk, matching the top anchor.

5 / 5

Total

18

/

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.