regimen-test

Execute commands from .regimen/*.md files and validate outputs against prose.

223|15|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/fulcrumresearch/druids --skill regimen-test
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: regimen-test
Source: https://github.com/fulcrumresearch/druids/tree/main/.claude/skills/regimen-test
Command: npx skills add https://github.com/fulcrumresearch/druids --skill regimen-test

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Step through a regimen file and verify that each described step executes correctly and produces the expected outcomes.

Core Features & Use Cases

  • Step through a .regimen/*.md file and execute the commands in each step.
  • Validate actual outputs against the prose descriptions and capture failures for debugging.
  • Respect timeout hints on steps and retry failed steps where possible; report results.

Quick Start

Use the regimen-test skill by placing a regimen file in .regimen/ and invoking the test runner to walk through and verify every step.

Frequently Asked Questions about regimen-test

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

FAQPage Schema
How do I automate verification of instruction-driven workflows in a CI environment?

Automate instruction-driven workflow verification by placing markdown files in a .regimen/ directory and invoking a test runner that executes listed commands, validates outputs against prose, and reports results for CI regression checks.

What is a regimen file and how does step validation work?

A regimen file is a markdown document in the .regimen/ directory containing sequential steps. Step validation works by executing each listed command, comparing actual outputs to prose descriptions, and capturing mismatches as failures for debugging.

Can I set timeout limits for individual commands during automated regression testing?

Yes, you can set timeout limits for individual commands during automated regression testing. The regimen parser reads optional timeout hints from each step in the markdown file and the runner respects them during execution.

How do I run step-by-step command validation locally using markdown instructions?

Run step-by-step command validation locally by placing a regimen file with listed commands and prose expectations in the .regimen/ folder, then invoking the test runner to walk through and verify every step.

Does regimen testing handle error scenarios and retry failed steps automatically?

Yes, regimen testing handles error scenarios and retries failed steps where possible. The runner executes commands from the .regimen/*.md files, captures failures for debugging, and respects timeout hints during the validation process.

When do I need to use a regimen test runner instead of standard test scripts?

Use a regimen test runner instead of standard scripts when you need to validate instruction-driven workflows that require comparing command outputs against prose descriptions across multiple steps, timeouts, and error scenarios.