tdd-author SKILL.md skillA

tdd-author from cahenesy/throughline is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add cahenesy/throughline/tdd-author@git:20261015.9250c5b

Pins git:20261015.9250c5b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
cahenesy/throughline
Path
skills/tdd-author/SKILL.md
Versions recorded
8
Latest version
git:20261015.9250c5b, committed Oct 15, 2026
First version recorded
Aug 14, 2026
Size
46,401 bytes
Repository stars
3
License
MIT

Reconcile the current PRD against the previous PRD version and the existing TDDs, decide how many Technical Design Docs the change needs and their scope, then author them. Run once per PRD update, in its own session. Invoke with /tdd-author.

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

# TDD authoring

Run once after a PRD update. YOU decide how many TDDs to write, and their scope,
based on what changed. Persist each to `docs/tdd/NNNN-<slug>.md`.

## Relationship to superpowers (read first)
This skill IS the technical-design step for throughline — the governance-producing
equivalent of `superpowers:writing-plans`. When the user invokes `/tdd-author`, do
NOT also invoke `superpowers:brainstorming` or `writing-plans`; this skill owns the
phase and its output is the TDD/ADR design-of-record (see [[ADR 0001]] in
`docs/adr/`). If a `docs/superpowers/plans/*` (or `specs/*`) file or other prior
design notes exist, READ and fold in their substance rather than redoing the work;
they are transient input, never authoritative, never relocated. The canonical
record is `docs/tdd/` + `docs/adr/`. A throughline TDD is a DESIGN, not a
step-by-step build script — the bite-sized failing-test-first task breakdown is
`/build-tdds`'s job, so do not reproduce it here.

## 0. Resume check
Resolve the plugin tree from the first set of `CLAUDE_PLUGIN_ROOT` /
`GROK_PLUGIN_ROOT` (env names; fail closed via `tl_plugin_root`), then source
the draft helper:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add cahenesy/throughline/tdd-author@sha256:c31b46178e8b6109

The line at the top of this page pins the label git:20261015.9250c5b, 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_duv5pq6kv5snqttu.svg)](https://markdownregistry.com/a/art_duv5pq6kv5snqttu)

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

Versions

The registry has recorded 8 versions of this file, between Aug 14, 2026 and Oct 15, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261015.9250c5b latest2026-10-15 9250c5b 46,401 BA view · diff
git:20261012.e4434fc2026-10-12 e4434fc 46,286 BA view · diff
git:20261012.82212ef2026-10-12 82212ef 45,481 BA view · diff
git:20261007.3cd66952026-10-07 3cd6695 44,459 BA view · diff
git:20261005.c7ecdfc2026-10-05 c7ecdfc 40,428 BA view · diff
git:20261005.f316a052026-10-05 f316a05 39,559 BA view · diff
git:20260815.d29fbed2026-08-15 d29fbed 39,510 BA view · diff
git:20260814.6d5ce232026-08-14 6d5ce23 39,530 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 (46401 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

cahenesy/throughline · 3 stars · license MIT · pushed 2026-10-15 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_duv5pq6kv5snqttu
GET https://markdownregistry.com/api/v1/resolve?ref=cahenesy/throughline/tdd-author
GET https://markdownregistry.com/api/v1/blob/c31b46178e8b61090d6f7a3c3d5bd12e55248ad382c67c0b4b2d7b30be8d5e55

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 cahenesy/throughline

adr-new SKILL.md skill
cahenesy/throughline · skills/adr-new/SKILL.md · Create a new Architecture Decision Record with append-only, status-gated supersession, and update the ADR index. Invoke…
git:20260526.3e992f6 · audit A · 3 stars
bootstrap-project SKILL.md skill
cahenesy/throughline · skills/bootstrap-project/SKILL.md · Set up a project's toolchain (linter, formatter, test framework) and verify it end-to-end when starting work on a…
git:20261006.323556d · audit A · 3 stars
implement-status SKILL.md skill
cahenesy/throughline · skills/implement-status/SKILL.md · Show progress for the currently-running `/build-tdds` job. Prints a one-shot snapshot (current TDD, stage, an…
git:20260814.6d5ce23 · audit A · 3 stars
build-tdds SKILL.md skill
cahenesy/throughline · skills/implement/SKILL.md · Turn features described in the PRD and designed in TDDs into code and tests. Confirms the queue, then sequences one…
git:20261012.e4434fc · audit A · 3 stars
prd-author SKILL.md skill
cahenesy/throughline · skills/prd-author/SKILL.md · Explore a problem space and produce or update the Product Requirements Document (the "what" and "why"). Persists to…
git:20261015.9250c5b · audit A · 3 stars
ux-author SKILL.md skill
cahenesy/throughline · skills/ux-author/SKILL.md · Mock the screens for UI-bearing requirements after a merged PRD update that adds or changes `[UI]` requirements, before…
git:20261007.ef85e7e · audit A · 3 stars

Every file in cahenesy/throughline

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