fmflurry/socratic-design
skills/socratic-design/SKILL.md
evidence-first decision-gating for planning, design, architecture, and refactor requests with unresolved requirements, scope, constraints, facts, or tradeoffs. use when the next safe step is to ask exactly one dependency-safe question before proposing a plan or implementation, especially when critical decisions are not yet closed.
$ install --global
skillsauthnpx skillsauth add fmflurry/settings-opencode socratic-designInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 29, 2026, 7:09 AM422.1s1 file scanned
SKILL.md
- name:
- socratic-design
- description:
- evidence-first decision-gating for planning, design, architecture, and refactor requests with unresolved requirements, scope, constraints, facts, or tradeoffs. use when the next safe step is to ask exactly one dependency-safe question before proposing a plan or implementation, especially when critical decisions are not yet closed.
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.
Related Skills
fmflurry/angular-clean-architecture
development
VerifiedTrustedCommunity
Scaffolds and extends Angular 18+ standalone features using Clean Architecture with DDD layering (presentation/application/domain/infrastructure), custom signal-based stores, facade pattern, and ports/adapters dependency inversion. Use when creating new Angular features/domains, adding use cases/facades/stores/ports/adapters, refactoring legacy NgModule/NgRx code toward clean architecture, or working with cross-domain communication via context registry.
158SKILL.mdUpdated Apr 19, 2026
fmflurry/merge-cop
development
VerifiedTrustedCommunity
Pre-merge code review for Angular + TypeScript pull requests. Diffs current branch against a target branch, applies Angular-specific checklists (signals, RxJS, clean architecture, flurryx, TS strict), runs lint + tsc, and emits a tiered report (verbose for juniors, terse for seniors). Auto-loads project AGENTS.md rules. Use when user runs /cop-review, says "pre-merge review", "review before merging", "check my PR against <branch>", or invokes the merge-cop agent.
144SKILL.mdUpdated May 14, 2026
fmflurry/git-workflow
testing
VerifiedTrustedCommunity
Use this skill for any git work such as creating branches, staging changes, writing commit messages, pushing branches, or preparing pull requests. Delegates git execution to the git-specialist agent.
144SKILL.mdUpdated Apr 19, 2026
fmflurry/flurryx
development
VerifiedTrustedCommunity
Signal-first reactive state management for Angular. Bridge RxJS streams into cache-aware stores, keyed resources, mirrored state, and replayable history. Use when generating or modifying Angular code that uses flurryx for state management, or when scaffolding new feature modules that follow the flurryx facade pattern.
133SKILL.mdUpdated Apr 19, 2026