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.

74

Quality

91%

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

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, well-structured instruction-only skill: concise, highly actionable behavioral rules, a clearly sequenced conversational workflow with adaptive feedback, and clean section organization with no need for external references.

DimensionReasoningScore

Conciseness

The body is lean behavioral guidance in short bullets with no padding and no explanations of concepts Claude already knows; every line directs behavior. The minor overlap between the inline rules and the 'What NOT to do' recap is the only redundancy and does not rise to verbosity.

3 / 3

Actionability

Guidance is concrete and specific throughout ('Ask ONE question at a time', 'Acknowledge what's reasonable about their thinking', 'give a small hint (not the answer)', 'stuck after 2-3 attempts'), giving executable direction for an instruction-only skill.

3 / 3

Workflow Clarity

The conversational process is clearly sequenced (start → ask → correct → incorrect → partial → progression → end) with adaptive feedback loops (adapt up/down, narrow/reframe, hint after repeated attempts) that serve as validation checkpoints for a non-destructive skill.

3 / 3

Progressive Disclosure

No bundle files exist and none are needed; the single cohesive task is organized into well-labeled sections (Purpose, Instructions subsections, What NOT to do) with clear navigation, so inline organization is appropriate.

3 / 3

Total

12

/

12

Passed

Description

82%

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-constructed description with strong trigger coverage and a clear what/when structure. Its main weakness is overlap between several generic trigger phrases and general explanation skills, plus actions that are more abstract than concrete.

Suggestions

Add at least one or two more distinctive trigger phrases that are unlikely to fire for a plain explanation skill (e.g., 'don't just tell me the answer', 'make me figure it out') to reduce conflict with general tutoring.

Sharpen the 'what' with a slightly more concrete verb set so the capability reads as specific actions rather than a single abstract method.

DimensionReasoningScore

Specificity

Names the domain ('deeply understand something through guided questioning', 'guided discovery') and a couple of actions, but does not list multiple distinct concrete actions the way the strongest anchors do; it stays somewhat abstract for a conversational skill.

2 / 3

Completeness

Explicitly states what the skill does (guided questioning for deep understanding) and when to use it, with a clear 'Use this when...' clause and concrete trigger phrases plus a fallback condition, satisfying both the what and the when.

3 / 3

Trigger Term Quality

Provides broad, natural coverage of phrases users would actually say ('quiz me', 'help me understand', 'teach me', 'test my understanding', 'Socratic'), matching the 'good coverage of natural terms' anchor rather than the partial-coverage anchor.

3 / 3

Distinctiveness Conflict Risk

The Socratic/guided-questioning niche is somewhat distinct, but generic triggers like 'help me understand', 'teach me', and 'walk me through' overlap heavily with ordinary explanation skills, so conflict risk remains.

2 / 3

Total

10

/

12

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