CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

socratic-method

Refine vague, complex, or high-stakes prompts through Socratic dialogue — surfaces hidden assumptions, probes reasoning, and iterates toward clarity before committing to an implementation.

Quality

83%

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 exemplary instruction-only skill body: a clearly sequenced five-phase protocol with explicit confirmation checkpoints, override handling, and concrete question templates, backed by a well-organized one-level-deep reference bundle. The only minor improvement is tightening the discursive Mindset prose.

DimensionReasoningScore

Conciseness

The body is efficient: nearly every section (rules with WHY rationale, BAD/GOOD contrast examples, per-phase question banks) teaches skill-specific behavior rather than concepts Claude already knows. It stops short of 5 because the opening 'Mindset' section is discursive prose ('The Socratic method is a disposition, not a checklist...') that could be trimmed to a couple of lines without losing guidance value.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: copy-paste-ready question templates per phase ('What specifically does [term] mean in your context?'), concrete BAD/GOOD dialogue examples for leading questions, contradiction-acceptance, and override handling, plus a ready-made opening message. It is not a 4 because the examples cover the common cases completely with no gaps.

5 / 5

Workflow Clarity

The five phases are clearly sequenced in order with explicit checkpoints: Phase 5 confirmation is required before acting ('NEVER skip Phase 5 before acting'), contradictions must be surfaced rather than accepted (a feedback loop), and the user-override path ('just do it' → acknowledge, name what was skipped, proceed) is specified. This matches the anchor for clear sequence with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

SKILL.md is a lean overview; all four cited reference files exist in references/ (question-taxonomy.md, classical-foundations.md, anti-patterns.md, worked-examples.md), are one level deep, and each link is labeled with a one-line description of its contents — exactly the well-signaled single-level reference structure the top anchor describes.

5 / 5

Total

19

/

20

Passed

Description

66%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 well-written, specific description that clearly conveys what the skill does and its distinct Socratic identity, but it lacks an explicit 'Use when...' trigger clause, which caps its completeness and leaves some natural trigger synonyms uncovered.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user's request is vague or ambiguous ("make it better", "build a dashboard"), when they say they don't know where to start, or before committing to an implementation on a high-stakes architectural decision.'

Add natural user phrasings as trigger synonyms — 'unclear', 'ambiguous', 'refine my prompt', 'not sure what I need' — to broaden keyword coverage.

State the concrete output of the process (e.g., 'produces a confirmed, well-scoped problem statement before implementation') to sharpen the 'what'.

DimensionReasoningScore

Specificity

The description lists several concrete actions for its domain — 'surfaces hidden assumptions, probes reasoning, and iterates toward clarity' — comparable to 'Extracts text, fills forms, converts pages'. It falls short of 5 because the actions are process-level rather than fully concrete, and it doesn't say what the questioning produces (e.g., a refined problem statement); it is well above 3 since more than 1-2 actions are named.

4 / 5

Completeness

The 'what' is clear ('Refine ... prompts through Socratic dialogue'), but there is no 'Use when...' clause or equivalent explicit trigger guidance — 'before committing to an implementation' describes position in a workflow, not when to activate the skill. Per the judging guideline, a missing 'Use when' clause caps completeness at 3; this is not a 2 because the 'what' is specific and a weak 'when' is implied by 'vague, complex, or high-stakes'.

3 / 5

Trigger Term Quality

Natural trigger phrases like 'vague, complex, or high-stakes prompts', 'hidden assumptions', and 'clarity before committing to an implementation' are terms a user would plausibly use. Not a 5 because common synonyms such as 'ambiguous', 'unclear', 'unclear requirements', or 'refine my prompt' are absent.

4 / 5

Distinctiveness Conflict Risk

'Socratic dialogue' and 'prompt refinement' carve a distinct niche with specific triggers, so it is mostly distinguishable from other skills. It loses a point only for minor overlap risk with general clarification/requirements-gathering skills; it is far from the generic breadth of a 2 or 3 anchor.

4 / 5

Total

15

/

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/agentic-harness/socratic-method/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.