specmint-tdd SKILL.md skillA
specmint-tdd from ngvoicu/kluris is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add ngvoicu/kluris/specmint-tdd@v3.0.1Pins v3.0.1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- ngvoicu/kluris
- Path
vendored/specmint-tdd/SKILL.md- Versions recorded
- 1
- Latest version
- v3.0.1, committed Oct 25, 2026
- Size
- 34,836 bytes
- Repository stars
- 7
- License
- MIT
TDD-first spec management for AI coding workflows. Use this skill when the user explicitly mentions specs, forging, or structured planning: says "forge", "forge a spec", "write a spec for X", "create a spec", "plan X as a spec", "resume", "what was I working on", "spec list/status/pause/switch/activate", "implement the spec", "implement phase N", "implement all phases", "red green refactor", "run the tests", "generate openapi". Also trigger when a `.specs/` directory exists at session start.…
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
# Spec Mint TDD
Turn ephemeral plans into structured, persistent specs built through deep
research and iterative interviews — with strict test-driven development at
every step. Every task starts with a failing test, production code exists
only to make tests pass, and refactoring happens under green. Tests use
testcontainers for real services, mock only at boundaries, and make no
external network calls. Specs have phases, tasks, acceptance criteria, a
registry, resume context, a decision log, a TDD log, and a deviations
log. They live in `.specs/` at the project root and work with any AI
coding tool that can read markdown.
Whether `.specs/` is committed is repository policy. Respect `.gitignore`
and the user's preference for tracked vs local-only spec state.
## Critical Invariants
1. **Single-file policy**: Keep this workflow in one `SKILL.md` file.
2. **Canonical paths**:
- Registry: `.specs/registry.md`
- Per-spec files: `.specs/<id>/SPEC.md`, `.specs/<id>/research-*.md`,
`.specs/<id>/interview-*.md`
3. **Authority rule**: `SPEC.md` frontmatter is authoritative. Registry is a
denormalized index for quick lookup.
…Read the whole file at its exact version.
How to install
mdr add ngvoicu/kluris/specmint-tdd@sha256:fc7434fa56160fbeThe line at the top of this page pins the label v3.0.1, 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_sa7whgwoz2skxpaq)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 25, 2026.
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 (34836 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
ngvoicu/kluris · 7 stars · license MIT · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_sa7whgwoz2skxpaq GET https://markdownregistry.com/api/v1/resolve?ref=ngvoicu/kluris/specmint-tdd GET https://markdownregistry.com/api/v1/blob/fc7434fa56160fbeab1be76ec0b8062bfc1fcc9ea3a67854fc125bcd14538486
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.