Skip to content
TakoAPI
Back to skills

agents-skill-tdd-helper

by cerbug45

CLI Utilities
570Downloads reported by clawskills.sh
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Lightweight helper to enforce TDD-style loops for non-deterministic agents.

Description

What This Skill Does

tdd-helper wraps task execution to enforce test-first discipline. It refuses to run production code if tests are absent or failing, and can optionally treat lint warnings as errors. Configuration is via environment variables or a JSON file.

Unlike invoking pytest directly, it enforces the test-first constraint at the process level, so agents cannot bypass the cycle even when code is generated dynamically.

When to Use It

  • Blocking agent-generated code from running before tests pass
  • Enforcing test presence in automated pipelines
  • Running pytest suites before executing generated scripts
  • Treating lint warnings as hard errors in CI workflows
  • Guarding non-deterministic agent outputs with regression checks

Example Workflow

INPUT

User asks: run my_script.py, but only if all tests in tests/ pass

AGENT
  1. 1

    Agent calls tdd.py with --tests tests/ --run 'python my_script.py'

  2. 2

    tdd.py checks that tests/ exists and contains test files

  3. 3

    tdd.py runs pytest on the test suite

  4. 4

    If any test fails or no tests are found, tdd.py exits with an error and blocks execution

  5. 5

    If all tests pass, tdd.py runs my_script.py

OUTPUT

my_script.py executes only after the full test suite passes

Installation

clawhub install cerbug45/agents-skill-tdd-helper

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links