Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/fmflurry/settings-opencode/socratic-designnpx skills add fmflurry/settings-opencode --skill socratic-designgit clone --depth 1 https://github.com/fmflurry/settings-opencodeWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00065 | $0.00456 |
| Opus 5 | $0.00032 | $0.00228 |
| Sonnet 5 | $0.00013 | $0.00091 |
| Haiku 4.5 | $0.00006 | $0.00046 |
Grade A, and why
socratic-design scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Socratic Design Skill
When to Activate
Use this skill before any planning, design, architecture, or refactor work when critical decisions are not yet closed. Resolve those decisions with evidence before producing a plan or implementation.
Non-Negotiables
- Exactly 1 Q per turn.
- Harness MUST use the
asktool to surface the Q. No prose-only questions, no inline "?" in plain text. Ifasktool unavailable -> stop and report missing capability. - Turn must include:
- Q (delivered via
asktool) - Rec (recommended answer)
- Why
- If Opposite -> path change
- Q (delivered via
- Repo can answer? inspect first.
- No plan/impl before critical decisions closed.
Order (strict)
- Outcome
- Scope
- Constraints
- Facts
- Invariants
- Options
- Tradeoffs
- Decision
- Validation
- Exec Gate
Q Gate
Each Q must be:
- Atomic
- Consequential
- Falsifiable
- Dependency-safe
Turn Shape
- Evidence: ...
- Question: ...
- Recommended: ...
- Why: ...
- If opposite: ...
Internal Log
Track: id | status(open/resolved/assumed) | deps | answer | confidence | evidence.
Rule: no child Q if parent open.
Stop
Stop questions only when:
- outcome/scope/constraints resolved
- critical risks mitigated/accepted
- validation defined
- no critical open deps
Then output:
- Shared understanding
- Resolved decision tree
- Open risks + owner
- Plan skeleton
Safety
- If stuck -> offer 2-3 bounded options.
- Security/prod/irreversible -> explicit warning.
- Tone rigorous, non-hostile.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 82 lines · 65 tokens per session scan A 32d871b7ed3f
socratic-design is a skill published in the GitHub repository fmflurry/settings-opencode (171 stars, last pushed 20d ago), licensed MIT. It adds 65 tokens to every session and 456 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
design-guide
Paperclip UI design system guide for building consistent, reusable frontend components. Use when creating new UI components, modifying existing ones, adding pages or features to the frontend, styling UI elements, or when you need to understand the design language and conventions. Covers: component creation, design…
accessibility
Consolidated accessibility skill entrypoint for WCAG 2.2, ARIA Authoring Practices, cognitive accessibility, Section 508, EN 301 549, design intent verification, and the Accessibility Planner workflow.
deck-course-module
暖纸背景 + Playfair, 左侧学习目标常驻, 含 MCQ 自测页.
desktop-principles
Desktop-specific UX principles - hover states, pointer precision, keyboard shortcuts, multi-window, focus management. Covers macOS, Windows, Linux, web desktop.
ios-hig-design
Design native iOS interfaces following Apple Human Interface Guidelines. Use when the user mentions "iPhone app", "iPad layout", "SwiftUI", "UIKit", "Dynamic Island", "safe areas", "HIG compliance", "SF Symbols", "haptic feedback", "iOS accessibility", "make my app feel native", or "follow Apple design guidelines".…
taiyi-ui-design
TaiyiForge 第 4 阶段 — UI/UX 契约，产出 UI-DESIGN.md。四端通用。.