specify-solution SKILL.md skillA

specify-solution from rsmdt/the-startup is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add rsmdt/the-startup/specify-solution@git:20261026.9ddf98d

Pins git:20261026.9ddf98d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
rsmdt/the-startup
Path
plugins/start/skills/specify-solution/SKILL.md
Versions recorded
5
Latest version
git:20261026.9ddf98d, committed Oct 26, 2026
First version recorded
Oct 10, 2026
Size
9,775 bytes
Repository stars
577
License
MIT

Create and validate solution design documents (SDD). Use when designing architecture, defining interfaces, documenting technical decisions, analyzing system components, or working on the Solution part of a spec.md in .start/specs/.

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

## Persona

Act as a solution design specialist that creates and validates SDDs focusing on HOW the solution will be built through technical architecture and design decisions.

## Interface

State {
  specDirectory = ""       // the active spec's dir: .start/specs/[NNN]-[name]/
  spec = ""                // path to spec.md in specDirectory: its Requirements part is the PRD, its Solution part the SDD
}

The SDD's output contract — section statuses, the ADR (`ADRStatus`) shape, required fields — lives in
`reference/output-format.md`, which is authoritative. Don't restate those shapes here; a second copy only drifts.

## Constraints

**Always:**
- Write the `## Solution` part of `spec.md` and keep its section structure exactly as the spec template defines it. Add the multi-component section from reference/conditional-sections.md only when the feature spans components.
- Reference the PRD's `NFR-N` quality gates where the design realizes them — never restate them.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add rsmdt/the-startup/specify-solution@sha256:df93572393484f61

The line at the top of this page pins the label git:20261026.9ddf98d, 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_f5lmiqt3xiep2lpc.svg)](https://markdownregistry.com/a/art_f5lmiqt3xiep2lpc)

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

Versions

The registry has recorded 5 versions of this file, between Oct 10, 2026 and Oct 26, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261026.9ddf98d latest2026-10-26 9ddf98d 9,775 BA view · diff
git:20261026.e975c512026-10-26 e975c51 9,758 BA view · diff
git:20261026.8454ce92026-10-26 8454ce9 9,896 BA view · diff
git:20261026.0dbd6b82026-10-26 0dbd6b8 8,976 BA view · diff
git:20261010.441d9d32026-10-10 441d9d3 7,938 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 (9775 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

rsmdt/the-startup · 577 stars · license MIT · pushed 2026-10-26 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_f5lmiqt3xiep2lpc
GET https://markdownregistry.com/api/v1/resolve?ref=rsmdt/the-startup/specify-solution
GET https://markdownregistry.com/api/v1/blob/df93572393484f61bdcdc37abf436076d0530ec10f82be365f9d8401791f19b3

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 rsmdt/the-startup

AGENTS.md AGENTS.md file
rsmdt/the-startup · AGENTS.md
git:20261010.692f647 · audit A · 577 stars
analyze SKILL.md skill
rsmdt/the-startup · plugins/start/skills/analyze/SKILL.md · Deep-research analysis of a codebase, a topic, or both. Clarifies the question, agrees the research angles with you…
git:20261010.8cfe65f · audit A · 577 stars
archive SKILL.md skill
rsmdt/the-startup · plugins/start/skills/archive/SKILL.md · Consolidate a completed specification into a single archived record and remove its working directory. Use as the final…
git:20261026.ab761e5 · audit A · 577 stars
brainstorm SKILL.md skill
rsmdt/the-startup · plugins/start/skills/brainstorm/SKILL.md · Required first step before any creative work — creating features, building components, adding functionality, or…
git:20260930.a14872b · audit A · 577 stars
constitution SKILL.md skill
rsmdt/the-startup · plugins/start/skills/constitution/SKILL.md · Create or update a project constitution with governance rules. Uses discovery-based approach to generate…
git:20260930.a14872b · audit A · 577 stars
debug SKILL.md skill
rsmdt/the-startup · plugins/start/skills/debug/SKILL.md · Systematically diagnose and resolve bugs through conversational investigation and root cause analysis
git:20261011.48bd3ee · audit A · 577 stars
document SKILL.md skill
rsmdt/the-startup · plugins/start/skills/document/SKILL.md · Generate and maintain documentation for code, APIs, and project components
git:20261011.48bd3ee · audit A · 577 stars
implement SKILL.md skill
rsmdt/the-startup · plugins/start/skills/implement/SKILL.md · Implementation entry point. Use to execute a completed specification. Reads the spec's slice and scenario tasks from…
git:20261026.9ddf98d · audit A · 577 stars
improve SKILL.md skill
rsmdt/the-startup · plugins/start/skills/improve/SKILL.md · Find deepening opportunities in a codebase — refactors that turn shallow modules into deep ones for better testability…
git:20260930.f2ff895 · audit A · 577 stars
refactor SKILL.md skill
rsmdt/the-startup · plugins/start/skills/refactor/SKILL.md · Refactor, simplify, or clean up code for improved maintainability without changing business logic
git:20261011.48bd3ee · audit A · 577 stars
reflect SKILL.md skill
rsmdt/the-startup · plugins/start/skills/reflect/SKILL.md · Self-improvement from this project's Claude Code session logs. Mines a date range (default "yesterday") through…
git:20261010.d70c6d3 · audit A · 577 stars
review SKILL.md skill
rsmdt/the-startup · plugins/start/skills/review/SKILL.md · Evidence-based code review. Resolves the review scope (PR, branch, staged changes, paths, or a freeform description)…
git:20261010.9ca5b4d · audit A · 577 stars

Every file in rsmdt/the-startup

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