bd-test-design

Evaluate software test quality across six design lenses with scoring criteria.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bitsydarel/BDSkills --skill bd-test-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bd-test-design
Source: https://github.com/bitsydarel/BDSkills/tree/main/plugins/bd-test-design/skills/bd-test-design
Command: npx skills add https://github.com/bitsydarel/BDSkills --skill bd-test-design

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of creating effective, maintainable, and reliable software tests by providing a structured framework for test design and review. It helps ensure tests verify behavior, not implementation, and are robust against refactoring.

Core Features & Use Cases

  • Test Design Guidance: Provides 6 lenses and 27 criteria to guide the creation of high-quality tests.
  • Test Review & Scoring: Enables objective assessment of existing test suites against best practices, scoring from 1-5 per criterion.
  • Anti-pattern Detection: Identifies common test design flaws like "Happy Path Only," "Over-Mocking," and "Flaky Tests Ignored."
  • Use Case: A team is struggling with brittle tests that break on every refactor. They use this Skill to review their existing test suite, identify areas of implementation coupling, and refactor tests to focus on behavior, improving maintainability and reducing regression risk.

Quick Start

Use the bd-test-design skill to review the test suite for the 'user-service' module.

Frequently Asked Questions about bd-test-design

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

FAQPage Schema
How do I evaluate software test quality and identify anti-patterns in my test suite?

Evaluate software test quality by applying six lenses covering strategy, structure, isolation, input domain, assertions, and maintainability. This framework scores tests from 1-5 per criterion to identify anti-patterns like over-mocking and flaky tests, guiding objective improvements.

What is the best way to review and score an existing test suite for maintainability?

Review a test suite by scoring 27 criteria across six lenses of test quality, focusing on maintainability and reliability. This objective assessment identifies implementation coupling and refactors tests to verify behavior, reducing regression risk.

How do I detect test design flaws like happy path only and over-mocking?

Detect test design flaws by evaluating tests against structured criteria that identify anti-patterns like happy path only, over-mocking, and ignored flaky tests. The framework provides calibration examples to ensure objective identification of these common issues.

Can I use this test design framework for different programming languages and platforms?

Yes, the test design framework provides objective assessment criteria and calibration examples applicable across various platforms and languages. It evaluates test behavior and structure independent of specific implementation details.

When should I use a structured test review framework instead of standard code review?

Use a structured test review framework when tests are brittle, focus on implementation over behavior, or lack proper isolation. It provides 27 specific criteria to objectively assess test quality beyond general code review practices.