What is the Spec-TDD workflow?

Spec-TDD stands for Specification-Test-Driven Development. It is a process where you write a detailed specification first, then write tests based on that spec, and only then write the implementation code to pass those tests.

When should I choose an acceptance test over a unit test?

According to the STDD workflow, if a test requires mocking repositories, external services, or complex dependencies, it should be an acceptance test. Unit tests are reserved for isolated logic.

How does this skill handle requirement tracking?

The skill uses specific markers (like [U][X]) within the specification file to track whether a requirement has a corresponding test and whether the implementation code has been completed.

Why does the skill require running pre-commit hooks?

Pre-commit hooks are enforced to ensure that code is not only functionally correct but also adheres to project linting, formatting, and static analysis standards before completion.

Spec-Test-Driven Development

Name: Spec-Test-Driven Development
Author: craigtkhill

bycraigtkhill

0•

安全与测试

Enforces a rigorous specification-first workflow that ensures every feature is documented, tested, and verified before final implementation.

The Spec-Test-Driven Development (STDD) skill provides a disciplined framework for building software features by prioritizing documentation and verification. It guides Claude through a strict five-step cycle: drafting formal specifications with user stories and requirements, writing unit or acceptance tests before implementation, developing minimal code to pass those tests, and finally verifying the output through automated test suites and pre-commit hooks. This skill is essential for developers who require high-quality, bug-resistant code and want to maintain clear traceability between business requirements and technical implementation.

主要功能

01Smart differentiation between unit tests and integration-heavy acceptance tests

02Specification-first requirement drafting using Gherkin-style scenarios

03Enforced verification through automated test runners and pre-commit hooks

04Automated tracking of requirement completion via inline status markers

050 GitHub stars

06Mandatory test-before-code workflow to ensure comprehensive coverage

使用场景

01Standardizing development workflows across a team to improve code auditability

02Building mission-critical features where functional accuracy is non-negotiable

03Scaling complex codebases while maintaining a robust regression test suite

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add craigtkhill/stdd-agents spec-test-driven-development

For use in Claude.ai and ChatGPT

Download Skill