← Back to Skills Marketplace
TDD Workflow
by
Deonte Cooper
· GitHub ↗
· v1.0.0
· MIT-0
168
Downloads
0
Stars
4
Active Installs
1
Versions
Install in OpenClaw
/install tdd-workflow
Description
Test-driven development workflow enforcing 80%+ code coverage with unit, integration, and E2E tests. Write tests first, validate RED state, implement minimal...
README (SKILL.md)
Test-Driven Development Workflow
Ensure all code development follows TDD principles with 80%+ code coverage.
When to Activate
- Writing new features or functionality
- Fixing bugs or issues
- Refactoring existing code
- User says "write tests", "add specs", "how should I test this"
Quick Start
- Write user journey in acceptance-test format ("As a [role], I want...")
- Generate test cases (happy path + edge cases + errors)
- Run tests → verify RED state (must fail before implementation)
- Implement minimal code to make tests pass → GREEN state
- Refactor while keeping tests green
- Verify 80%+ coverage achieved
Key Concepts
- Tests before code — Write tests first, then implementation
- RED-GREEN-REFACTOR — Fail → Pass → Improve (no exceptions)
- 80% coverage minimum — Unit, integration, and E2E combined
- Unit-level isolation — Mock dependencies, test behavior not implementation
- Independent tests — No test ordering dependencies; each can run solo
Common Usage
Most frequent patterns:
- Unit tests for functions and components
- Integration tests for API endpoints and database operations
- E2E tests for critical user flows
- Edge case and error path testing
- Fast execution (unit tests \x3C 50ms each)
References
references/workflow-steps.md— Detailed 7-step TDD cycle with git checkpointsreferences/patterns-and-best-practices.md— Test patterns, common mistakes, success metrics
Usage Guidance
This skill appears to be what it says: a TDD workflow checklist and examples. Before you run it on a codebase: 1) review the repository's test files and package.json to see what npm test actually runs (look for scripts that run end-to-end tests or hit real services); 2) ensure tests run in an isolated test environment (use test databases, mock external APIs, or CI feature flags) so you don't leak or modify production data; 3) inspect any integration/E2E tests for hard-coded endpoints or credentials; 4) when running the workflow locally, confirm your git state and branch (the instructions create commits) or run in a disposable branch; 5) if you use CI, ensure secrets are scoped to test accounts. These precautions mitigate the main practical risk (accidentally running tests that talk to production systems), but the skill itself is coherent and non-malicious.
Capability Analysis
Type: OpenClaw Skill
Name: tdd-workflow
Version: 1.0.0
The skill bundle provides a standard Test-Driven Development (TDD) workflow, including documentation on testing patterns and step-by-step instructions for the AI agent. It uses standard development tools like npm and git and provides helpful mocking examples for common services. No malicious code, data exfiltration, or harmful prompt injections were found across SKILL.md or the reference files.
Capability Assessment
Purpose & Capability
Name/description (TDD enforcing 80%+ coverage) aligns with the instructions and referenced patterns. Required binaries (npm, git) are appropriate for running tests and creating git checkpoints. No unexplained credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md gives explicit TDD steps (write tests, run npm test, commit at RED/GREEN, run coverage). It references unit/integration/E2E and includes mock examples for Supabase/Redis/OpenAI; these are illustrative. Caution: integration/E2E tests could be written to contact external services or databases in a real project, so inspect test code before running to avoid accidental production access.
Install Mechanism
No install spec and no code files are provided; the skill is instruction-only so it does not download or write artifacts to disk. This is the lowest-risk install posture.
Credentials
The skill itself does not request environment variables or credentials (none declared), which is proportional. However, real test suites in a repository may require DB/API credentials; the skill does not warn about that. Verify test runner configuration (package.json, test setup) and ensure tests run against isolated test/stub environments.
Persistence & Privilege
The skill is not always-enabled and does not request persistent presence or modify other skills. It instructs creating git commits in the local repo, which is expected behavior for a workflow tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tdd-workflow - After installation, invoke the skill by name or use
/tdd-workflow - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release. TDD workflow enforcing 80%+ coverage with git checkpoints. Adapted from everything-claude-code by @affaan-m (MIT)
Metadata
Frequently Asked Questions
What is TDD Workflow?
Test-driven development workflow enforcing 80%+ code coverage with unit, integration, and E2E tests. Write tests first, validate RED state, implement minimal... It is an AI Agent Skill for Claude Code / OpenClaw, with 168 downloads so far.
How do I install TDD Workflow?
Run "/install tdd-workflow" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is TDD Workflow free?
Yes, TDD Workflow is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does TDD Workflow support?
TDD Workflow is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux, win32).
Who created TDD Workflow?
It is built and maintained by Deonte Cooper (@djc00p); the current version is v1.0.0.
More Skills