skills.rest
mrigsby
mrigsbyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

testing-bdd

Create behavior-driven tests in TestBox using describe/it/expect syntax.

Updated Jan 18, 2026
Search Tags:#testing#bdd#testbox#behavior-driven#coldbox
One-click install
npx skills add https://github.com/mrigsby/ITB2026-Under-The-Wire --skill testing-bdd-mrigsby
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: testing-bdd
Source: https://github.com/mrigsby/ITB2026-Under-The-Wire/tree/main/.ai/skills/core/testing-bdd
Command: npx skills add https://github.com/mrigsby/ITB2026-Under-The-Wire --skill testing-bdd-mrigsby

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires testbox, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide to using TestBox's BDD (Behavior-Driven Development) capabilities, ensuring tests are clear, maintainable, and focused on behavior.

Core Features & Use Cases

  • BDD Syntax: Learn and implement TestBox's describe/it/expect syntax for writing human-readable tests.
  • Test Organization: Organize tests with nested suites and lifecycle hooks.
  • Matchers & Expectations: Utilize rich expectation matchers for accurate assertions.
  • Use Case: Develop robust, behavior-focused tests for a ColdBox application, reducing future maintenance and increasing code quality.

Quick Start

Use the testing-bdd skill to generate a BDD test suite for the 'UserService' component.

Frequently Asked Questions about testing-bdd

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

FAQPage Schema
How do I write behavior-driven tests in TestBox for a ColdBox application?▼

Write behavior-driven tests in TestBox using the describe, it, and expect syntax to create human-readable test suites focused on application behavior. This approach ensures tests remain maintainable and clearly document system interactions.

What is the describe/it/expect syntax in TestBox BDD?▼

The describe/it/expect syntax in TestBox BDD structures tests into nested suites and readable expectations. Describe blocks group related behaviors, it blocks define individual cases, and expect makes assertions using rich matchers.

Do I need a ColdBox framework instance to use TestBox behavior-driven testing?▼

Yes, you need both TestBox and a running ColdBox framework instance to execute behavior-driven tests. This Skill guides ColdBox developers in generating suites that interact directly with application components and system behaviors.

How do I organize TestBox test suites with lifecycle hooks and nested suites?▼

Organize TestBox suites by nesting describe blocks to structure related behaviors and applying lifecycle hooks to manage setup and teardown operations. This organization keeps complex ColdBox application tests clean and maintainable.

What matchers and expectations are available in TestBox for BDD assertions?▼

TestBox provides rich expectation matchers for accurate behavior-driven assertions within the expect function. These matchers allow you to validate application states, outputs, and interactions cleanly without verbose custom assertion logic.

Related Skills

Explore More Software Engineering Skills→
mrigsbymrigsby

Unit Testing in TestBox

Guide writing unit tests in ColdBox applications using TestBox.

Community
Intermediate
ColdBoxColdBox

testbox-assertions

Provide xUnit-style assertion helpers for TestBox $assert objects.

Official
Intermediate
ColdBoxColdBox

testbox-expectations

Write fluent TestBox assertions with chained matchers and expectAll().

Official
Advanced
mrigsbymrigsby

Testing with Mocking

Create test doubles and verify interactions using MockBox for ColdBox apps.

Community
Advanced