spec-author skillA
spec-author is agent-read markdown (skill) from llopresto87/cypress: Write an executable specification under docs/graph/specs/ that turns a clear goal into testable contracts. Use whenever a feature, endpoint, job, significant function, or AI interaction needs a contract that the tester can encode and the implementer can satisfy. Coordinates product (§3, §9), architect (§4, §6, §7), and tester (§10 testability review) into a single signed-off document. Specs are the source of truth for behavior; do not write code without one..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# spec-author This skill is the discipline of writing a spec that another agent can turn into failing tests and another into passing code. It is invoked from `docs/graph/protocols/specify.md`. A spec is **executable** when every functional contract maps to at least one test in the suite and the test name names the contract. Specs that read like marketing or like implementations are not specs. ## When to apply this skill - `brainstorm` has converged and the next step is to formalize the behavior. - An existing feature's contract is changing. - A bug investigation revealed a contract that was implicit and is now being made explicit. - An ADR introduces a new system behavior that needs a spec. ## How to write each section ### §1 Summary One paragraph. What this spec covers and why. No marketing, no philosophy. Pretend you're explaining to the next agent on the team in two sentences what they're about to implement. ### §2 Scope Two bullet lists: "in scope" and "out of scope". The out-of-scope bullets are equally important. Reading the spec a year later, the out-of-scope list is what tells the next agent "no, we considered that and excluded it deliberately." …
Read the whole file at its exact version.
How to install
mdr add llopresto87/cypress/spec-author@git:20260915.df30567mdr add llopresto87/cypress/spec-author@sha256:83c6c5078ca66305Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_szrtc6hunzmoqzwu)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260915.df30567 latest | 2026-09-15 | df30567 | 8,572 B | A | view · diff |
| git:20260909.7f88943 | 2026-09-09 | 7f88943 | 8,433 B | A | view · diff |
| git:20260906.6fbfe66 | 2026-09-06 | 6fbfe66 | 7,757 B | A | view · diff |
| git:20260901.c8706d7 | 2026-09-01 | c8706d7 | 7,500 B | A | view · diff |
| git:20260831.6dde434 | 2026-08-31 | 6dde434 | 7,311 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 (8572 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
llopresto87/cypress · 43 stars · license MIT · pushed 2026-09-24 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_szrtc6hunzmoqzwu GET https://markdownregistry.com/api/v1/resolve?ref=llopresto87/cypress/spec-author GET https://markdownregistry.com/api/v1/blob/83c6c5078ca6630585e58e3d1ef8e4f1e0d67214cd36150d81b308a451d12a98
Your agent 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.