tiny-spec-build SKILL.md skillA

tiny-spec-build from grayma77er/tiny-spec is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add grayma77er/tiny-spec/tiny-spec-build@git:20261020.b407ef9

Pins git:20261020.b407ef9 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-build/SKILL.md
Versions recorded
14
Latest version
git:20261020.b407ef9, committed Oct 20, 2026
First version recorded
Jul 31, 2026
Size
26,866 bytes
Repository stars
3
License
MIT

Build the spec — run the per-task loop plan→implement→review→commit, one task at a time. Implements with a fresh executor, grades with an independent reviewer running the real gate, commits per passed task, keeps a lean memory. Can be handed several lanes (one worktree + slug per independent feature) and runs them concurrently, one task at a time within each. Halts on a blocker, a spent convergence budget, a task's pause: point, or a genuine fork, and names which. Resumes from the checkbox…

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-build

The heart of the flow. Walks the `## Tasks` checklist in the active ticket's `PLAN.md`
top to bottom and runs each task through a tight loop: **plan → implement → review → commit**. The constitution
(`constitution.md`) anchors every step; the thing that writes the code is never the
thing that grades it.

Artifacts live under `.spec/`: the **shared** constitution and memory at the root
(`.spec/constitution.md`, `.spec/memory.md`), the per-ticket `PLAN.md`/`SPEC.md`/
`decisions.md` under `.spec/<ticket-id>/`. The `memory.md` skeleton is inline below —
write it from there, no file to read. The two subagents dispatched below
(`tiny-spec-build-executor`, `tiny-spec-build-reviewer`) are referenced by name — install them
alongside this skill (see the suite README). Installed as the `tiny-spec` **plugin**, they
are namespaced `tiny-spec:tiny-spec-build-executor` and `tiny-spec:tiny-spec-build-reviewer`;
dispatch whichever form your agent list shows. Never substitute a general-purpose agent
for a missing one — say it isn't installed and stop.

## Inputs

A brief to **fold lane lessons** skips everything below and goes straight to
**Folding lane lessons**.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add grayma77er/tiny-spec/tiny-spec-build@sha256:843f955a62cff3e3

The line at the top of this page pins the label git:20261020.b407ef9, 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_otyy7hgzv5xfpjob.svg)](https://markdownregistry.com/a/art_otyy7hgzv5xfpjob)

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

Versions

The registry has recorded 14 versions of this file, between Jul 31, 2026 and Oct 20, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261020.b407ef9 latest2026-10-20 b407ef9 26,866 BA view · diff
git:20261018.8e65e052026-10-18 8e65e05 26,483 BA view · diff
git:20261016.94941292026-10-16 9494129 24,319 BA view · diff
git:20261013.c4105dd2026-10-13 c4105dd 22,551 BA view · diff
git:20261011.ddc88332026-10-11 ddc8833 21,581 BA view · diff
git:20261002.f20c9472026-10-02 f20c947 21,298 BA view · diff
git:20261002.63ab17f2026-10-02 63ab17f 21,279 BA view · diff
git:20260930.39dc17d2026-09-30 39dc17d 21,000 BA view · diff
git:20260912.7069f4f2026-09-12 7069f4f 17,297 BA view · diff
git:20260904.cef72bf2026-09-04 cef72bf 15,120 BA view · diff
git:20260830.b1b44bd2026-08-30 b1b44bd 15,124 BA view · diff
git:20260803.6a6cfe32026-08-03 6a6cfe3 11,015 BA view · diff
git:20260731.4364ba92026-07-31 4364ba9 10,859 BA view · diff
git:20260731.d2dedcf2026-07-31 d2dedcf 10,108 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 (26866 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

grayma77er/tiny-spec · 3 stars · license MIT · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_otyy7hgzv5xfpjob
GET https://markdownregistry.com/api/v1/resolve?ref=grayma77er/tiny-spec/tiny-spec-build
GET https://markdownregistry.com/api/v1/blob/843f955a62cff3e3562578ddaa4791a5e2f5f7817e06c3207e4181aa25597338

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 grayma77er/tiny-spec

AGENTS.md AGENTS.md file
grayma77er/tiny-spec · AGENTS.md
git:20261020.b407ef9 · audit A · 3 stars
CLAUDE.md CLAUDE.md file
grayma77er/tiny-spec · CLAUDE.md
git:20260904.30d2233 · audit A · 3 stars
tiny-spec-adopt SKILL.md skill
grayma77er/tiny-spec · tiny-spec-adopt/SKILL.md · The brownfield on-ramp — onboard an EXISTING codebase by deriving the shared constitution (.spec/constitution.md) from…
git:20261018.7e4496a · audit A · 3 stars
tiny-spec-create SKILL.md skill
grayma77er/tiny-spec · tiny-spec-create/SKILL.md · Start or update a spec — capture intent and requirements into .spec/<slug>/SPEC.md, optionally bound to a ticket (or…
git:20261018.8e65e05 · audit A · 3 stars
tiny-spec-design SKILL.md skill
grayma77er/tiny-spec · tiny-spec-design/SKILL.md · Optional add-on for projects with a visual surface — turn wireframes and mockups into a project-wide token system in…
git:20261002.63ab17f · audit A · 3 stars
tiny-spec-plan SKILL.md skill
grayma77er/tiny-spec · tiny-spec-plan/SKILL.md · Turn the active ticket's SPEC.md into a technical design and an executable task list — produce PLAN.md (design…
git:20261018.7e4496a · audit A · 3 stars
tiny-spec-run SKILL.md skill
grayma77er/tiny-spec · tiny-spec-run/SKILL.md · The one router — read each artifact's status flag to work out where work stands, then invoke the skill that moves it…
git:20261020.b407ef9 · audit A · 3 stars
tiny-spec-scope SKILL.md skill
grayma77er/tiny-spec · tiny-spec-scope/SKILL.md · The greenfield on-ramp — turn a rough idea, or an existing PRD, into BREAKDOWN.md at the project root - a flat list of…
git:20261008.b72cfb4 · audit A · 3 stars

Every file in grayma77er/tiny-spec

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