spec-brainstorm SKILL.md skillA
spec-brainstorm from martinffx/atelier is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add martinffx/atelier/spec-brainstorm@git:20261009.3672e9cPins git:20261009.3672e9c in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- martinffx/atelier
- Path
skills/spec-brainstorm/SKILL.md- Versions recorded
- 7
- Latest version
- git:20261009.3672e9c, committed Oct 9, 2026
- First version recorded
- Jul 28, 2026
- Size
- 15,217 bytes
- Repository stars
- 48
- License
- MIT
Conversational design workshop for substantial work. Interviews the human one question at a time, explores 2-3 approaches with trade-offs, and presents the design section by section for approval before writing only design.md, then stops. Combines requirements discovery with codebase research and architecture design. Use when the user explicitly requests a spec or when atelier-orchestrator selects a Spec-backed Plan. Ambiguous design or discovery requests route through atelier-orchestrator.
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
# Spec Brainstorm Conversational design workshop for substantial work that produces a focused, reviewed spec. One question at a time. Multiple approaches explored. Design approved in sections. Ruthless scope control. No implementation until design is approved. Run this skill only after `atelier-orchestrator` selects a Spec-backed Plan or the human explicitly requests a spec. Bounded work should go directly to `spec-plan` for an Inline Plan. Do not reclassify the planning mode here. ## Artifact ``` docs/specs/YYYY-MM-DD-<feature>/ └── design.md ← This skill's output ``` Requirements are inline — no separate requirements.json needed. ### Exclusive output contract This skill may create or update only the `design.md` shown above. It may inspect the repository and discuss drafts in conversation, but it must not modify any other file, create `plan.json`, create tracker entries, invoke another workflow skill, or write implementation code. This boundary still applies when the human asks to brainstorm, plan, and implement in one request. Finish `design.md`, report it, and stop. --- ## Lessons These principles apply to every spec, every time. ### Specs must earn their cost …
Read the whole file at its exact version.
How to install
mdr add martinffx/atelier/spec-brainstorm@sha256:83e6272376d67447The line at the top of this page pins the label git:20261009.3672e9c, 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.
[](https://markdownregistry.com/a/art_6hoxgzg6elh5qq77)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 7 versions of this file, between Jul 28, 2026 and Oct 9, 2026, about one every 12 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261009.3672e9c latest | 2026-10-09 | 3672e9c | 15,217 B | A | view · diff |
| git:20261009.81af084 | 2026-10-09 | 81af084 | 14,849 B | A | view · diff |
| git:20260809.2626d8c | 2026-08-09 | 2626d8c | 14,660 B | A | view · diff |
| git:20260809.fcf852b | 2026-08-09 | fcf852b | 14,061 B | A | view · diff |
| git:20260801.96f6fe8 | 2026-08-01 | 96f6fe8 | 12,568 B | A | view · diff |
| git:20260728.745f872 | 2026-07-28 | 745f872 | 12,439 B | A | view · diff |
| git:20260728.b1fb1f7 | 2026-07-28 | b1fb1f7 | 12,427 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (15217 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
martinffx/atelier · 48 stars · license MIT · pushed 2026-10-18 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_6hoxgzg6elh5qq77 GET https://markdownregistry.com/api/v1/resolve?ref=martinffx/atelier/spec-brainstorm GET https://markdownregistry.com/api/v1/blob/83e6272376d67447cb398bdef82f94a09780bd49efa79607a63c3c51afd4fdfd
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.