cold-reader
A document is done when a reader with no project context can understand it; this skill runs that check as a Vale lint plus a…
Use when the user is clarifying beliefs, assumptions, goals, or framing before committing to decision or plan.
$ npx -y skills add kylesnowschwartz/SimpleClaude --skill sc-socratic --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/sc-socraticContext preview
The summary Claude sees to decide when to auto-load this skill.
Use when the user is clarifying beliefs, assumptions, goals, or framing before committing to decision or plan.
name: sc-socratic description: Use when the user is clarifying beliefs, assumptions, goals, or framing before committing to decision or plan.
Think WITH the user, not FOR them. The goal is to surface what they can't see in their own thinking, challenge assumptions to strengthen positions, and help them think better—not just have answers.
Apply these operations as the situation demands:
<operations> | Operation | Purpose | When to Use | |-----------|---------|-------------| | **Assumptions** | Surface hidden beliefs | Any proposal or plan | | **Evidence** | Probe the basis for claims | Confident assertions | | **Consequences** | Trace implications | Decisions with tradeoffs | | **Opposition** | Steelman the alternative | Strong positions | | **Meta-question** | Find what they should ask | Stuck or circular thinking | | **Exclusion** | Define by what's NOT | Scope creep or vague goals | </operations>
Classify the situation into one of these shapes. Do not pattern-match on user phrasing; read the semantic intent:
| Situation | Approach | |-----------|----------| | **Deciding** — user comparing options or facing a choice | Surface tradeoffs, challenge both sides | | **Blocked** — stalled progress, unclear obstacle | Find the real obstacle, propose smallest next step | | **Evaluating** — user wants a plan or proposal examined | Surface risks and hidden assumptions | | **Learning** — user building understanding of how X works | Draw out existing knowledge first | | **Designing** — user shaping a structure or system | Diverge exploration, then converge to MVP | | **Undifferentiated uncertainty** | Ask what kind of thinking they need |
1. **Gather context** - Use Read, Grep, Glob to understand the actual situation. Don't question in a vacuum.
2. **Apply 2-3 operations** - Pick what fits. Don't spray all techniques at every problem.
3. **Surface the question** - End with what they should be asking next. Often more valuable than an answer.
4. **Propose action** - Concrete next step. Avoid analysis paralysis.
Check yourself for these failure modes:
| Anti-Pattern | Symptom | Fix | |--------------|---------|-----| | **Theater** | Going through motions | Genuine curiosity about their thinking | | **Infinite Loop** | Questions without closure | Set a decision point | | **Answer Extraction** | Giving answers disguised as questions | Actually wait for their response | | **Vacuum Questioning** | Abstract questions without context | Ground in actual code/files first |
For detailed anti-pattern descriptions and recovery strategies, see `references/anti-patterns.md`.
## Context [What you understand about the situation - grounded in actual files/code/evidence] ## Inquiry [2-3 targeted questions from the toolkit, chosen for this specific situation] --- [Continue dialogue based on responses] ## The Question [What they should be asking now - surface this explicitly] ## Next [Concrete action to take]
This skill is for uncertainty, not efficiency. Don't apply Socratic dialogue to tasks that just need execution.
For specific situations requiring deeper techniques:
When a specific technique warrants focused application, suggest these specialized commands:
| Situation | Command | When to Suggest | |-----------|---------|-----------------| | Challenge a conclusion | `/sc-review-and-refactor` (refute-findings route) | After reaching a decision, to have a fresh agent try to disprove it | | Debug a problem | `/sc-review-and-refactor` (hypothesis-rca route) | When tracing root causes in code/systems | | Verify factual claims | `/sc-review-and-refactor` (verify-claims route) | When accuracy of assertions matters | | Specify work for agents | `/sc-context-wizard` | After clarity is reached, before implementation | | Validate completed work | `/sc-review-and-refactor` (requirements-trace route) | After implementation, to verify against requirements |
These commands provide structured protocols for specific situations. Use sc-socratic for open-ended dialogue; use these when the situation calls for a focused technique.
See `examples/` for complete dialogue transcripts:
A practical minimalist AI assistant framework that transforms complex AI interactions into natural conversations. Comes with a set of user-commands, sub-agents, hooks, and utilities designed for real-world software development tasks.
A document is done when a reader with no project context can understand it; this skill runs that check as a Vale lint plus a…
MUST be used for any request to draft, write, compose, or reword text another person will read, including 'draft a message',…
Choose the right kind of diagram for what the user is describing, then write and validate it in mermaid. This skill SHOULD be…
Clean-room reimplementation of a repository, library, API, protocol, or other software artifact. This skill SHOULD be used when…
Lift-and-shift port of a repository, library, API, protocol, or other software artifact to a different language, runtime, or…
Routes review and refactoring work to a named technique. This skill SHOULD be used when the user asks to "refactor safely",…