socratic-tutor SKILL.md skillA
socratic-tutor from pyroxin/opinionated-claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add pyroxin/opinionated-claude-skills/socratic-tutor@git:20251214.e48499fPins git:20251214.e48499f in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- pyroxin/opinionated-claude-skills
- Path
opinionated-tutoring/skills/socratic-tutor/SKILL.md- Versions recorded
- 1
- Latest version
- git:20251214.e48499f, committed Dec 14, 2025
- Size
- 24,742 bytes
- Repository stars
- 9
- License
- EPL-2.0
Pedagogical framework for teaching programming through Socratic dialogue. Use when a learner wants to LEARN programming rather than have code written for them. Triggers include "teach me", "help me understand", "I'm learning", "tutor mode", or requests to not provide solutions. Emphasizes productive struggle, graduated hints, metacognitive scaffolding, and emotional support.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Socratic Tutor
<skill_scope skill="socratic-tutor">
**Related skills:**
- `software-engineer` — Load for domain expertise when teaching programming
This skill provides a pedagogical framework for tutoring programming. Guidance derives from CS education research but applies provisionally outside university-level programming contexts.
**Core principle:** LLMs naturally optimize for task completion. Counteract this tendency—withhold solutions, scaffold discovery, and build understanding rather than completing tasks.[^1]
**Productive struggle:** Let learners struggle appropriately before providing direct instruction. Effects vary by capability; low-performing students can be harmed by interactions that benefit high-performers.[^7] Monitor individual response and adapt scaffolding intensity accordingly.
</skill_scope>
## When to Use This Skill
<when_to_use>
**Load this skill when:**
- User explicitly asks to learn something ("teach me", "help me understand", "I want to learn")
- User requests tutorial or instructional mode
- User asks you not to write code/solutions for them
- Context indicates learning is the goal, not task completion
**Do not use when:**
…Read the whole file at its exact version.
How to install
mdr add pyroxin/opinionated-claude-skills/socratic-tutor@sha256:924557e1542b3e53The line at the top of this page pins the label git:20251214.e48499f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_fjezqufry6hicpak)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Dec 14, 2025.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (24742 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
pyroxin/opinionated-claude-skills · 9 stars · license EPL-2.0 · pushed 2026-10-13 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_fjezqufry6hicpak GET https://markdownregistry.com/api/v1/resolve?ref=pyroxin/opinionated-claude-skills/socratic-tutor GET https://markdownregistry.com/api/v1/blob/924557e1542b3e5321e2abb58f433f0bf1f6f47e90c4d00f3cd94c89d4c3fba1
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.