system-design SKILL.md skillA
system-design from yarlson/yarstack is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add yarlson/yarstack/system-design@git:20261017.2f2e03bPins git:20261017.2f2e03b in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- yarlson/yarstack
- Path
plugins/yarstack/skills/system-design/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261017.2f2e03b, committed Oct 17, 2026
- First version recorded
- Sep 3, 2026
- Size
- 3,725 bytes
- Repository stars
- 3
- License
- MIT
Design the smallest system or feature architecture that satisfies stated current requirements, for a greenfield product or a new capability in an existing codebase. Use when the user wants a proposed design with components, non-goals, and growth triggers; not for investigating existing behavior, settling one open decision, or planning phases.
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
# System Design Produce the smallest design that satisfies today's stated requirements and name what would justify more. Every component, process, dependency, and abstraction is a cost that must buy a named requirement. ## Fix the constraints 1. Extract the actors, the jobs they need done, and the observable outcomes that define success. 2. Record load, data volume, team size, delivery horizon, deployment target, and hard constraints such as compliance, latency, or an existing platform. When a value is unknown, assume the smallest plausible value, write the assumption down, and design for it. Never design for unknown scale. 3. In an existing codebase, find the owning module, its current contract, conventions, runtime shape, and deployment path before proposing anything. Use `system-investigate` when current behavior is unclear. 4. Write non-goals: capabilities, scales, and actors the design intentionally excludes. ## Design from the baseline 1. Start from the baseline: one deployable process, the datastore already in use or the most boring option, synchronous calls, no new infrastructure. For a feature, the baseline is a change inside the owning module. …
Read the whole file at its exact version.
How to install
mdr add yarlson/yarstack/system-design@sha256:7fcc8d96b4dca919The line at the top of this page pins the label git:20261017.2f2e03b, 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_6vksw75gehjltw6p)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Sep 3, 2026 and Oct 17, 2026, about one every 44 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261017.2f2e03b latest | 2026-10-17 | 2f2e03b | 3,725 B | A | view · diff |
| git:20260903.c5d000e | 2026-09-03 | c5d000e | 3,582 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 (3725 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
yarlson/yarstack · 3 stars · license MIT · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_6vksw75gehjltw6p GET https://markdownregistry.com/api/v1/resolve?ref=yarlson/yarstack/system-design GET https://markdownregistry.com/api/v1/blob/7fcc8d96b4dca919d23c02ee14bcac7f7ca56b22bc91365eb1e71c6c56ff0528
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 yarlson/yarstack
Every file in yarlson/yarstack