CtrlK
BlogDocsLog inGet started
Tessl Logo

socratic-quiz

Use this when the user wants to deeply understand something through guided questioning. Trigger phrases include: "quiz me", "help me understand", "Socratic", "teach me", "walk me through with questions", "test my understanding", or when the user asks for an explanation and would benefit more from guided discovery than a direct answer.

62

Quality

78%

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 ./plugins/workflow/skills/socratic-quiz/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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, actionable instruction set for a conversational skill: concrete question phrasings, explicit branching rules for correct/incorrect/partial answers, a real escalation feedback loop, and a clean section organization with no external-file needs. Remaining improvements are minor: trim the redundant 'What NOT to do' restatements and add a short worked example of one adaptive exchange.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout ("Acknowledge what's reasonable about their thinking", "Briefly confirm (one sentence max)") and never explains concepts Claude already knows, such as what the Socratic method is. Not 5 because the "What NOT to do" section duplicates rules already stated ("Do NOT ask multiple questions" repeats "Ask ONE question at a time"; "Do NOT give a direct explanation" repeats "Do NOT reveal the correct answer"); not 3 because there is no unnecessary explanation or padding.

4 / 5

Actionability

Concrete, executable guidance for a conversational skill: sample question phrasings ("what do you think would happen if..."), specific thresholds ("after 2-3 attempts", "2-3 sentence summary"), and concrete tactics (offer a counterexample, ask a narrower question). Not 5 because there is no worked example of an adaptive exchange demonstrating the reframing tactics in practice; not 3 because the guidance is specific and complete enough to execute, not pseudocode-level.

4 / 5

Workflow Clarity

The multi-step flow is clearly sequenced (start -> gauge level -> ask one question -> branch on correct/incorrect/partial -> progress -> end) with a genuine feedback loop (incorrect -> narrow/reframe -> counterexample -> hint after 2-3 attempts) and a defined ending protocol. Not 5 because the initial level-gauging instruction ("not too easy, not too hard") leaves the adaptation checkpoint implicit rather than giving an explicit decision rule.

4 / 5

Progressive Disclosure

A self-contained conversational skill with no external references needed: all guidance belongs inline and is organized under a clean header hierarchy (Purpose, Instructions with per-scenario subsections, Tone, Ending, What NOT to do). Per the simple-skill guidance, well-organized sections with no need for external files warrant a 5; nothing here should be split into separate files.

5 / 5

Total

17

/

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-formed description with an explicit trigger clause and a strong, natural set of trigger phrases. Its weaknesses are a thin 'what' that names the mechanism without concrete behaviors, and broad tutoring/explanation triggers that create moderate overlap risk with general teaching skills.

Suggestions

Expand the 'what' with 2-3 concrete behaviors from the body (e.g., 'asks one question at a time, adapts difficulty to the user's answers, and escalates from concrete to synthesis questions without grading') to raise specificity and completeness.

Add missing natural trigger variants such as "drill me", "ask me questions", or "check my knowledge" to broaden keyword coverage.

Tighten the catch-all trigger ("asks for an explanation and would benefit more from guided discovery than a direct answer") to reduce conflict risk with general explanation/tutoring skills, e.g., by requiring an explicit learning-understanding intent.

DimensionReasoningScore

Specificity

The description names the domain and mechanism ("deeply understand something through guided questioning", "guided discovery") but stops at 1-2 abstract actions; it never conveys the skill's actual behaviors such as adaptive leveling, one-question-at-a-time progression, or the no-grading ending. Not 4 because it does not list several specific concrete actions; not 2 because the mechanism is named rather than purely generic.

3 / 5

Completeness

Both parts are present: a clear what ("deeply understand something through guided questioning") and an explicit "Use this when..." clause with concrete trigger phrases, matching the anchor-4 example's shape. Not 5 because the 'what' is a single thin clause compared to the anchor-5 example's multi-action coverage; not 3 because the 'when' is explicit, not weakly implied.

4 / 5

Trigger Term Quality

Six quoted natural trigger phrases ("quiz me", "help me understand", "Socratic", "teach me", "walk me through with questions", "test my understanding") give good keyword coverage a user would plausibly say. Not 5 because common variants like "drill me", "ask me questions", or "check my knowledge" are missing.

4 / 5

Distinctiveness Conflict Risk

"quiz me" and "Socratic" are distinct triggers, but "teach me", "help me understand", and "when the user asks for an explanation and would benefit more from guided discovery" overlap broadly with any general tutoring or explanation skill and rely on judgment. Anchor 3 (somewhat specific but could overlap with similar skills) is the best fit; the overlap with closely related explanation skills is more than minor, ruling out 4.

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pchalasani/claude-code-tools
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.