tiny-spec-plan SKILL.md skillA
tiny-spec-plan from grayma77er/tiny-spec is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add grayma77er/tiny-spec/tiny-spec-plan@git:20261018.7e4496aPins git:20261018.7e4496a in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- grayma77er/tiny-spec
- Path
tiny-spec-plan/SKILL.md- Versions recorded
- 10
- Latest version
- git:20261018.7e4496a, committed Oct 18, 2026
- First version recorded
- Jul 31, 2026
- Size
- 22,383 bytes
- Repository stars
- 3
- License
- MIT
Turn the active ticket's SPEC.md into a technical design and an executable task list — produce PLAN.md (design narrative plus a ## Tasks checklist) and harden the shared constitution.md. The ## Tasks section is a flat, ordered checklist executed sequentially by tiny-spec-build. Can draft in plan mode and write nothing until the user approves (tiny-spec-run asks for this in a supervised run). Re-run in update mode to reconcile it after a SPEC change.
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
# tiny-spec-plan Decides **how** the requirements get built, slices that into the tasks that build it, and — just as important — hardens the **constitution** (`constitution.md`) that every task will be implemented and reviewed against. It writes **one file**, `PLAN.md`: the design narrative, ending in a `## Tasks` section — the flat checklist `tiny-spec-build` executes and ticks. Design and checklist go stale together, so they share one `status:` flag, and this skill is the only one that sets it. `tiny-spec-build` touches nothing in the file but the checkboxes and `updated:`. Artifacts live under `.spec/`: the **shared** constitution at the root (`.spec/constitution.md`), the per-ticket `SPEC.md`/`PLAN.md` under `.spec/<slug>/`. Both skeletons are inline below — write them from there, no file to read. Requires `.spec/<active>/SPEC.md`. **Resolve the active ticket dir**, in order: the `.spec/<slug>/` whose slug matches the current git branch (one branch per ticket); else the sole ticket dir if exactly one exists; else ask. **Ask instead** when more than one dir matches the branch, or when ticket dirs exist while you are on `main`/`master` with no name match — neither has a …
Read the whole file at its exact version.
How to install
mdr add grayma77er/tiny-spec/tiny-spec-plan@sha256:2add10dec017d6a4The line at the top of this page pins the label git:20261018.7e4496a, 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_omsbfgdrpkffmvpi)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 10 versions of this file, between Jul 31, 2026 and Oct 18, 2026, about one every 9 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261018.7e4496a latest | 2026-10-18 | 7e4496a | 22,383 B | A | view · diff |
| git:20261008.b72cfb4 | 2026-10-08 | b72cfb4 | 19,363 B | A | view · diff |
| git:20261002.63ab17f | 2026-10-02 | 63ab17f | 17,813 B | A | view · diff |
| git:20260930.f096ca6 | 2026-09-30 | f096ca6 | 17,666 B | A | view · diff |
| git:20260912.7069f4f | 2026-09-12 | 7069f4f | 17,224 B | A | view · diff |
| git:20260904.f122a08 | 2026-09-04 | f122a08 | 14,077 B | A | view · diff |
| git:20260803.6a6cfe3 | 2026-08-03 | 6a6cfe3 | 7,227 B | A | view · diff |
| git:20260731.4364ba9 | 2026-07-31 | 4364ba9 | 6,880 B | A | view · diff |
| git:20260731.d2dedcf | 2026-07-31 | d2dedcf | 5,566 B | A | view · diff |
| git:20260731.36e9462 | 2026-07-31 | 36e9462 | 5,027 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 (22383 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
grayma77er/tiny-spec · 3 stars · license MIT · pushed 2026-10-22 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_omsbfgdrpkffmvpi GET https://markdownregistry.com/api/v1/resolve?ref=grayma77er/tiny-spec/tiny-spec-plan GET https://markdownregistry.com/api/v1/blob/2add10dec017d6a486b352587a6a5114f0f2dc261bd9f0991f8abe17991d2268
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.