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.

78

Quality

97%

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%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 tight, well-structured instruction set that assumes Claude's competence and gives concrete behavioral rules with explicit feedback loops. It is an example of a lean, single-purpose skill that needs no bundle files.

DimensionReasoningScore

Conciseness

Lean and efficient throughout; it never explains pedagogical theory Claude already knows and every section states operational rules that earn their place, matching the score-5 anchor.

5 / 5

Actionability

As an instruction-only skill it provides concrete, specific guidance ("Ask ONE question at a time", "Acknowledge what's reasonable about their thinking", "give a small hint (not the answer)") covering the common cases of correct, incorrect, and partial answers.

5 / 5

Workflow Clarity

Clear multi-phase sequence (start -> ask -> handle responses -> progress -> end) with an explicit feedback loop for incorrect answers (acknowledge -> narrow question -> counterexample -> hint) and a 2-3 attempt checkpoint.

5 / 5

Progressive Disclosure

A single-purpose skill well under 50 lines with no need for external references, organized into clearly labeled sections (Purpose, Instructions, What NOT to do); per the rubric's simple-skill guidance this warrants a 5.

5 / 5

Total

20

/

20

Passed

Description

95%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 is well-crafted: it clearly states the skill's purpose, uses third-person voice, and lists an excellent set of natural trigger phrases. The only minor gap is that it describes one mode of action rather than enumerating multiple concrete operations.

DimensionReasoningScore

Specificity

Names the concrete approach ("guided questioning", "guided discovery") and contrasts it against giving a direct answer, but it is a single mode of action rather than a list of multiple concrete operations like the score-5 anchor.

4 / 5

Completeness

Explicitly answers both what ("deeply understand something through guided questioning") and when ("Use this when..." with concrete trigger phrases), matching the score-5 anchor.

5 / 5

Trigger Term Quality

Comprehensive coverage of natural phrases users would actually say ("quiz me", "help me understand", "Socratic", "teach me", "walk me through with questions", "test my understanding"), including synonyms.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (Socratic guided discovery) with specific trigger phrases that minimize overlap with general explanation skills.

5 / 5

Total

19

/

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