CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

64

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/agentic-harness/socratic-method/SKILL.md
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.

The body is an exemplary instruction-only skill: a clearly sequenced five-phase protocol with explicit confirmation checkpoints, copy-paste-ready question templates, and concrete BAD/GOOD example dialogues, all supported by a well-organized one-level-deep reference bundle. The only real trim opportunity is the somewhat padded Mindset section.

DimensionReasoningScore

Conciseness

The protocol and rules sections are lean — each rule is a one-line imperative plus a one-line WHY — but the Mindset section contains philosophical musing ('You may find that the user's original framing was correct. You will more often find...') and re-explains a disposition Claude already grasps. This matches 'efficient; minor instances of over-explanation that could be trimmed' rather than 5, and is well above the padding seen at 3.

4 / 5

Actionability

Every phase ships literal, copy-paste-ready question templates ('What specifically does [term] mean in your context?'), plus a scripted opening message and annotated BAD/GOOD dialogue pairs covering the common failure cases (leading questions, papered-over contradictions, ignored overrides). For an instruction-only skill this fully meets 'specific examples cover the common cases'.

5 / 5

Workflow Clarity

The five phases are explicitly ordered with a stated exit condition ('until all five phases are complete or the user explicitly asks you to stop'), an explicit validation checkpoint ('NEVER skip Phase 5 before acting — always confirm the synthesized understanding'), and override-handling guidance. This matches 'clear sequence with explicit validation steps'.

5 / 5

Progressive Disclosure

The body is a genuine overview and all four detailed materials (question taxonomy, classical foundations, anti-patterns, worked examples) live in references/ — clearly signaled with one-line descriptions, one level deep, and all four referenced files exist on disk with matching content. This matches the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

19

/

20

Passed

Description

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

The description communicates a clear, distinctive capability with concrete named actions, but lacks an explicit 'Use when...' trigger clause, leaving the activation conditions only weakly implied. Natural trigger-term coverage is thin relative to the phrases a user would actually say when needing this skill.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user's request is vague or underspecified ("make it better", "add authentication"), or when they ask "how?" before establishing "what?" and "why?".'

Broaden natural trigger terms to include synonyms users actually say — 'clarify', 'ambiguous', 'refine', 'underspecified', 'requirements' — alongside 'vague' and 'high-stakes'.

Characterize the concrete outcome so the 'what' is comprehensive, e.g. what a refined prompt looks like (a confirmed problem statement, explicit constraints, agreed scope) before implementation begins.

DimensionReasoningScore

Specificity

Lists three concrete, domain-specific actions — 'surfaces hidden assumptions', 'probes reasoning', 'iterates toward clarity' — in the clear domain of prompt refinement, matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because coverage is not comprehensive (the refined output is never characterized) and above 3 because more than 1-2 actions are named concretely.

4 / 5

Completeness

The 'what' is clear (refine prompts via Socratic dialogue), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied through the adjectives 'vague, complex, or high-stakes', which caps completeness at 3 per the judging guidelines. Not 4 because the activation conditions are never made explicit; not 2 because the 'what' is specific, not vague.

3 / 5

Trigger Term Quality

'vague', 'prompts', and 'high-stakes' are terms a user might plausibly say, but common natural variations ('clarify', 'ambiguous', 'refine this request', 'requirements') are missing. It is above 2 because the keywords are not purely generic jargon, but below 4 because synonym coverage is thin.

3 / 5

Distinctiveness Conflict Risk

'Socratic dialogue' and 'prompt refinement' carve a distinct niche that few skills occupy, matching 'mostly distinct; minor overlap risk'. Not 5 because it could still overlap with generic prompting or requirements-clarification skills; not 3 because the triggers are far more specific than the anchor examples.

4 / 5

Total

14

/

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.