brainstorm-socratic SKILL.md skillA

brainstorm-socratic from llopresto87/cypress is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add llopresto87/cypress/brainstorm-socratic@git:20260930.dd7591d

Pins git:20260930.dd7591d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
llopresto87/cypress
Path
skills/brainstorm-socratic/SKILL.md
Versions recorded
4
Latest version
git:20260930.dd7591d, committed Sep 30, 2026
First version recorded
Aug 31, 2026
Size
5,418 bytes
Repository stars
121
License
MIT

The Socratic questioning technique that converges a vague goal — question selection, one-to-three-per-turn pacing, the reflect-every-two-answers cadence, the nine-question hard cap, and the eight-point convergence checklist that defines "converged". This is the user-facing of the brainstorm protocol's two modes — use it when the decision is the owner's to make; when it is the session's own, the mode is skill.brainstorm-internal and there is nobody to question. The protocol owns entry/exit…

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

# brainstorm-socratic

This is the mode with a person in it. It applies when the answer is the
owner's to give: what to build, for whom, what counts as done, which
tradeoff they have to live with. When the decision is the session's own,
use `docs/graph/skills/brainstorm-internal.md`;
`brainstorm.mode-selection` in `docs/graph/protocols/brainstorm.md` owns
the test.

A goal that arrives as "build me a thing" is not yet ready to specify or
plan. This skill ONLY converges the goal from vague to precise: the UI
emerges later from the user flow, and framework and architecture wait
for `architect`, after research. It is applied inside
`docs/graph/protocols/brainstorm.md`, which owns entry conditions, the
grill.md output map, and the explicit-confirmation exit; this file owns
the method.

## How to brainstorm

### Ask the smallest set of questions that change the design the most

Bad: "What colour?", "What should the homepage look like?", "What
framework?"

Good: "Who is this for and what do they do today instead?", "What counts
as success one month in?", "What is explicitly out of scope?"

Limit: one to three questions per turn, and the main flow before its
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add llopresto87/cypress/brainstorm-socratic@sha256:11e328b078be9acc

The line at the top of this page pins the label git:20260930.dd7591d, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7mwlrmhjncje66id.svg)](https://markdownregistry.com/a/art_7mwlrmhjncje66id)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Aug 31, 2026 and Sep 30, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
git:20260930.dd7591d latest2026-09-30 dd7591d 5,418 BA view · diff
git:20260921.0e86c1a2026-09-21 0e86c1a 6,000 BA view · diff
git:20260915.df305672026-09-15 df30567 5,997 BA view · diff
git:20260831.6dde4342026-08-31 6dde434 4,269 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5418 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

GitHub

llopresto87/cypress · 121 stars · license MIT · pushed 2026-10-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7mwlrmhjncje66id
GET https://markdownregistry.com/api/v1/resolve?ref=llopresto87/cypress/brainstorm-socratic
GET https://markdownregistry.com/api/v1/blob/11e328b078be9acceddeea6366a6c58ddbad135d2be19797d962aa5ffb8a434a

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.

More from llopresto87/cypress

CLAUDE.md CLAUDE.md file
llopresto87/cypress · CLAUDE.md
git:20261014.eff8d56 · audit A · 121 stars
AGENTS.md@core AGENTS.md file
llopresto87/cypress · core/AGENTS.md
git:20261009.024beb7 · audit A · 121 stars
adopt-existing SKILL.md skill
llopresto87/cypress · skills/adopt-existing/SKILL.md · Source-first growth of an existing single- or multi-repository project into CYPRESS's unified docs/graph knowledge…
git:20261014.eff8d56 · audit A · 121 stars
adr-writer SKILL.md skill
llopresto87/cypress · skills/adr-writer/SKILL.md · Author an Architecture Decision Record that captures a non-obvious technical choice — its context, the decision, the…
git:20261006.fa6eac5 · audit A · 121 stars
brainstorm-internal SKILL.md skill
llopresto87/cypress · skills/brainstorm-internal/SKILL.md · The divergence technique CYPRESS applies to itself, with no user in the loop — generating genuinely distinct options…
git:20260930.dd7591d · audit A · 121 stars
context-router SKILL.md skill
llopresto87/cypress · skills/context-router/SKILL.md · Resolve the minimum set of knowledge-graph nodes needed for a task before reading any source file. Use at the start of…
git:20261009.25653b8 · audit A · 121 stars
grill-planner SKILL.md skill
llopresto87/cypress · skills/grill-planner/SKILL.md · The authoring discipline for the project's plan-of-record at docs/graph/plans/grill.md — what a worker filling any…
git:20260930.dd7591d · audit A · 121 stars
holistic-editing SKILL.md skill
llopresto87/cypress · skills/holistic-editing/SKILL.md · The discipline for any change, fix, refactor, or review whose unit of work is larger than a trivial one-liner. Use…
git:20261006.fa6eac5 · audit A · 121 stars
humanizer SKILL.md skill
llopresto87/cypress · skills/humanizer/SKILL.md · Draft or revise prose a person will read (documentation, README text, ADR and spec bodies, runbooks, pull-request…
git:20260930.dd7591d · audit A · 121 stars
knowledge-graph SKILL.md skill
llopresto87/cypress · skills/knowledge-graph/SKILL.md · Build and maintain the project's knowledge graph — a tiered set of nodes under docs/graph/ that lets an agent load only…
git:20261014.eff8d56 · audit A · 121 stars
library-wiki SKILL.md skill
llopresto87/cypress · skills/library-wiki/SKILL.md · Maintain a project-local, version-pinned wiki of every external dependency. Use whenever a new library is being added…
git:20261014.eff8d56 · audit A · 121 stars
research-and-ingest SKILL.md skill
llopresto87/cypress · skills/research-and-ingest/SKILL.md · Find authoritative sources on the web (or via documentation MCP servers like Context7/DeepWiki), download or snapshot…
git:20261006.fa6eac5 · audit A · 121 stars

Every file in llopresto87/cypress

Browse by kind, by grade A, or by owner.