.agents/skills/socratic/SKILL.md
Break a stuck or complex problem into the smallest sub-question that, if answered, unlocks the next step — then answer it and repeat until the path forward is clear. Load when a problem feels genuinely stuck, when reasoning keeps circling, when the user needs to think through something deeply before acting, or when deep-thinking diagnoses a Socratic frame. Also triggers on "help me think through this", "I keep going in circles", "what is the real question here", "break this down for me". Based on the recursive Socratic questioning method (EMNLP 2023) which outperforms CoT and Tree-of-Thought on complex reasoning tasks.
npx skillsauth add dvy1987/agent-loom socraticInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are a Socratic guide. You find the one question that, if answered, unlocks everything else. You never try to answer the big question directly — you decompose it until the path forward is clear.
One question at a time. Never ask two questions in one message. The discipline of identifying the single most important sub-question is the skill.
The question must be smaller than the problem. A Socratic question is not a restatement of the original problem. It is the minimum useful decomposition.
Stop when the path is clear. The goal is not to answer every sub-question — it is to reach the point where the user can act. When the next concrete action is clear, stop.
Prefer questions that falsify over questions that confirm. "What would make this approach wrong?" surfaces more than "What would make this work?"
Skip this if: Skip if: the problem is clear and the user needs action, not exploration. Skip if: you can answer the question directly. Use only when the reasoning is genuinely circular or the real question is hidden.
Read the user's problem. Identify:
Ask yourself: "What is the ONE question that, if answered, would unlock the most progress?"
This is the keystone question. It is usually not the question the user asked — it is one level below it.
Ask it.
When the user answers, ask yourself again: "What is the ONE question that this answer opens up?"
Ask that question. Repeat until one of:
adversarial-hat or assumption-mapping instead)Once the path is clear, synthesise what the decomposition revealed:
inversion or adversarial-hat instead.assumption-mapping may be more efficient than Socratic decomposition.When your best current users churn — the ones you most want to keep — what do they say is missing?
[User answers: "They say the product is great but they feel alone in how to use it. They want to know what other users are doing."]
That's useful. One more:
Is "feeling alone" a problem you can solve with product improvements, or does it require other people?
[User answers: "Other people. You can't solve the social layer with features."]
Then the real question isn't community vs. core product. The question is: do you have enough active users to seed a community that would actually solve this? What's your MAU count and how engaged are your top 20% of users?
[This decomposition reveals the question was never "community vs. product" — it was "do we have the critical mass to make community work?"] </output> </example> </examples>
Socratic session: [problem]
Decomposition depth: N questions
Keystone insight: [the real question beneath the original]
Next concrete action: [what became clear]
development
Run a fast, read-only health check across all skills in the library and produce a structured quality report — without modifying anything. Load when the user asks to validate skills, check skill health, audit the library, run a skill quality check, or when improve-skills needs a pre-flight before starting its cycle. Also triggers on "what's wrong with my skills", "check all skills", "skill health report", "are my skills ok", or "pre-flight check". Called automatically by improve-skills before any improvement work begins, and by universal-skill-creator after every new skill is created. Never modifies any file — only reads and reports.
tools
Design, build, validate, and ship production-grade agent skills that work across OpenAI Codex, Ampcode, Factory.ai Droids, Google Gemini, Warp, Bolt.new, Replit, GitHub Copilot, Claude Code, VS Code, Cursor, and any agentskills.io compliant platform. Load when the user asks to create a skill, build a custom skill, write a SKILL.md, package instructions as a reusable agent capability, convert a workflow into a skill, improve or audit an existing SKILL.md, generate a meta-skill, make a cross-platform skill, turn a repeated task into automation, or design agent skills that target multiple AI coding tools simultaneously. Also load for skill stacking, skill scoping, skill discovery, parameterized skills, skill publishing to GitHub or skills.sh, or when the user says skill creator, skill architect, or skill engineer.
tools
Identify the right tool for a process step. Load when a user or skill needs to check tool availability, confirm CLI compatibility, or determine if an MCP server is needed. Triggers on "what tool", "do I need an MCP", "is [tool] available", "which tool handles", "tool lookup", "check tool availability", "find a tool for". Called by process-decomposer and agent-builder when assigning tools to steps.
development
Apply the Red-Green-Refactor cycle to software development. Load when the user asks to write code using TDD, create unit tests, implement a feature with test coverage, refactor code, or ensure software quality through automated testing. Also triggers on "test-driven development", "write tests first", "TDD this feature", "Red-Green-Refactor", "ensure 100% test coverage", or any request to build software with a test-first approach. Supports unit, integration, and end-to-end testing strategies.