A robust test-driven development framework that enforces the Red-Green-Refactor cycle and a minimum of 80% code coverage.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tdd-workflow
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tdd-workflow using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is TDD Workflow?
The TDD Workflow is a specialized module for Openclaw Skills designed to instill rigorous engineering discipline into the AI coding process. By mandating a test-first approach, it ensures that features are defined by their requirements before a single line of implementation logic is written. This methodology minimizes technical debt and guarantees that every new piece of functionality is born with a comprehensive safety net.
Built for developers who prioritize stability, this skill integrates unit, integration, and end-to-end (E2E) testing into a seamless loop. It serves as an automated guardian of code quality, preventing regressions and ensuring that edge cases are handled gracefully from day one.
TDD Workflow Use Cases
- Implementing new features where logic must be verified against business requirements.
- Debugging and fixing issues by first reproducing them with a failing test case.
- Large-scale refactoring of legacy codebases where regression testing is critical.
- Standardizing testing culture across a team using Openclaw Skills.
How TDD Workflow Works
- Requirement Mapping: Define the user journey in an acceptance-test format to establish the scope of the work.
- Test Generation: Create comprehensive test cases covering happy paths, edge cases, and potential error states.
- Validation of RED State: Run the newly created tests to confirm they fail, ensuring the test is valid and the feature is truly missing.
- Minimal Implementation: Write the least amount of code necessary to transition the tests to a GREEN state.
- Refactor: Clean up the implementation while utilizing the passing tests as a safety barrier.
- Coverage Audit: Verify that the combined unit, integration, and E2E coverage meets the 80% minimum threshold.
TDD Workflow Setup
To utilize this workflow, ensure your environment has the required binaries installed. You can initialize the TDD environment within your project using the following commands:
# Ensure npm and git are available
npm install
git init
# Trigger the TDD workflow within your agent
clawdbot "implement the user login feature using TDD"
TDD Workflow Data Schema & Taxonomy
The skill organizes its testing lifecycle through specific documentation and metadata structures:
| File Type | Purpose |
|---|---|
workflow-steps.md |
Detailed 7-step TDD cycle including specific git checkpoint instructions. |
patterns-and-best-practices.md |
Catalog of test patterns, common pitfalls, and success metrics. |
metadata |
Configuration for required binaries (npm, git) and supported OS (macOS, Linux, Windows). |
TDD Workflow Advanced Features
- Strict Coverage Enforcement: Automatically blocks workflows that do not meet the 80% coverage requirement.
- Unit-Level Isolation: Built-in logic for mocking dependencies to test behaviors rather than specific implementations.
- Independent Execution Support: Ensures tests are stateless and can be run in any order or in isolation for faster CI/CD pipelines.
- Multi-Level Testing Integration: Orchestrates transitions between unit-level components and full E2E user flows within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Yoga Studio Video
A specialized AI video generation skill designed to capture the unique atmosphere and culture of yoga studios to drive student enrollment and retention.
Codebase Explorer
A professional-grade agent skill designed to systematically analyze unfamiliar repositories and generate structured onboarding documentation.
Media Sync
A specialized media librarian skill for Openclaw Skills that automates downloading and organizing content into Jellyfin directories.
Apple Music Play (Clawtunes)
A macOS skill for controlling Apple Music playback of both library and streaming catalog tracks using command-line tools.
Li Yanhong Perspective v2.0
A sophisticated AI cognitive skill that simulates the strategic decision-making and engineering culture of Baidu founder Robin Li.
Hekkova
Hekkova provides a permanent memory layer for AI agents, allowing them to mint encrypted content directly to the Polygon blockchain and IPFS.
Featured*
