tdd-red

Writes failing unit tests from Gherkin feature files to anchor the Red phase of TDD.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nikoheikkila/agents --skill tdd-red-nikoheikkila
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-red
Source: https://github.com/nikoheikkila/agents/tree/main/skills/tdd-red
Command: npx skills add https://github.com/nikoheikkila/agents --skill tdd-red-nikoheikkila

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides the Red phase of TDD by enabling you to write failing unit tests directly from Gherkin (BDD) feature files before any implementation exists.

Core Features & Use Cases

  • Reads Gherkin feature files from the features/ directory and interprets scenarios.
  • Translates scenarios into failing unit tests that express required behavior.
  • Ensures tests fail for the right reason and promotes isolated, deterministic test setup.
  • Provides structured guidance for starting a feature with the first test.

Quick Start

Create or open a Gherkin feature file, then invoke the skill to generate the initial failing tests.

Frequently Asked Questions about tdd-red

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write failing unit tests from Gherkin feature files?

To write failing unit tests from Gherkin feature files, the skill reads scenarios from your features directory and translates Given-When-Then steps into isolated, deterministic tests that fail immediately.

What is the Red phase in test-driven development?

The Red phase in test-driven development is the initial step of writing a failing unit test that defines required behavior before any implementation code exists, ensuring immediate failure feedback.

How do I start test-driven development with BDD scenarios?

Start test-driven development with BDD scenarios by placing Gherkin feature files in your features directory and invoking the skill to generate the initial failing unit tests anchoring your workflow.

Do I need existing implementation code to generate unit tests from Gherkin?

No, you do not need existing implementation code to generate unit tests from Gherkin. The skill enforces the test-driven development red-phase workflow by requiring a failing test before implementation begins.

Why should my unit tests fail for the right reason during TDD?

Your unit tests should fail for the right reason during TDD to validate that they accurately express the required behavior translated from Gherkin scenarios and provide clear, immediate failure feedback.

Can I use Gherkin scenarios for test-driven development without a specific testing framework?

Yes, you can use Gherkin scenarios for test-driven development without a specific framework, as the skill focuses on translating Given-When-Then scenarios into structured failing unit tests with clear naming conventions.