Name: explain-like-socrates
Rating: 61.6 (1 reviews)
Author: administrakt0r

explain-like-socrates

Explains concepts using Socratic-style dialogue. Use when the user asks to explain, teach or help understand a concept like socrates.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/explain-like-socrates/SKILL.md

The canonical home for this skill is explain-like-socrates in administrakt0r/AI-Agents-Safe-Coding-Skills

Quality

Content

67%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 content is a well-structured, actionable guide for an instruction-only skill with a clear response workflow and good organization. Its main weakness is conciseness — redundant Socrates framing and trivia about Socrates that Claude already knows.

Suggestions

Remove the redundant 'avoid lecture-style / use Socratic style' restatements in the DO/DO NOT and Tone sections since the opening already establishes this; keep one canonical statement.

Cut trivia Claude already knows, e.g. 'the original street philosopher from ancient Athens' — reference only the dialogue style, not Socrates' biography.

Tighten the intro paragraph which restates the conversational-reasoning goal already conveyed by the structure that follows.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with a clear structure, but includes unnecessary padding Claude already knows ('the original street philosopher from ancient Athens') and redundant restatements of 'avoid lecture-style / use Socratic style' across the intro, DO/DO NOT, and Tone sections.	3 / 5
Actionability	As an instruction-only skill it provides concrete, actionable guidance: a 5-phase response structure, example dialogue sentences ('Suppose a system needed to remember something...'), a worked analogy (vending machine), and exact reflection prompts — only minor gaps keep it from fully copy-paste-ready templates.	4 / 5
Workflow Clarity	A clear sequenced workflow (Curiosity Opening -> Guided Reasoning -> Single Analogy -> Clarification -> Reflection) with failure-handling and termination guidance; no validation checkpoints are needed for this non-destructive conversational skill, and the 'loosely follow' phrasing leaves minor looseness.	4 / 5
Progressive Disclosure	The skill is a single self-contained SKILL.md with well-organized, clearly headed sections and no nested or buried references; it is somewhat long for one file but appropriately sectioned rather than monolithic.	4 / 5
	Total	15 / 20 Passed

Description

78%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 concise, uses third person, and clearly covers both what the skill does and when to trigger it with natural phrasing. It is slightly generic in its action verbs and has minor overlap risk with broader explanation skills.

Dimension	Reasoning	Score
Specificity	Names the domain ('Socratic-style dialogue') with one concrete action ('Explains concepts'), but the verbs (explain/teach/help understand) are fairly generic and not comprehensive — matching the anchor that names a domain plus 1-2 actions.	3 / 5
Completeness	It explicitly answers both what ('Explains concepts using Socratic-style dialogue') and when ('Use when the user asks to explain, teach or help understand a concept like socrates') with concrete trigger phrases, and the required 'Use when' clause is present.	5 / 5
Trigger Term Quality	Natural user phrases like 'explain', 'teach', 'help understand a concept' are present and would be said naturally; a few synonyms (e.g. 'break down', 'walk me through') are missing, so it sits just below the comprehensive anchor.	4 / 5
Distinctiveness Conflict Risk	The Socratic-dialogue framing is a clear niche with a distinct trigger ('like socrates'), but 'explain a concept' is a broad intent that could overlap with general explanation skills, leaving minor conflict risk.	4 / 5
	Total	16 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: plugins/AI-Agents-Safe-Coding-Skills-claude/skills/explain-like-socrates/SKILL.md
Commit: 57c135b

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.