testing-rules

Standardize test writing and review for software changes.

2|1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/timgranlundmarsden/claude-agent-flow --skill testing-rules-timgranlundmarsden
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: testing-rules
Source: https://github.com/timgranlundmarsden/claude-agent-flow/tree/main/skills/testing-rules
Command: npx skills add https://github.com/timgranlundmarsden/claude-agent-flow --skill testing-rules-timgranlundmarsden

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you write, review, and validate tests that prove real behavior instead of locking in brittle wording or unnecessary file checks.

Core Features & Use Cases

  • Behavior-first testing: Focuses assertions on observable outcomes, regressions, and silent-failure risks.
  • Coverage guidance: Tells you how much testing is appropriate for new modules, bug fixes, refactors, and trivial edits.
  • Test suite hygiene: Helps you delete noisy tests, consolidate repetitive checks, and keep only high-value coverage.
  • UI verification: Reminds you to run visual checks after HTML or CSS changes and report the results clearly.

Quick Start

Use the testing-rules skill to review this change and tell me which tests to add, keep, consolidate, or remove based on behavior and risk.

Frequently Asked Questions about testing-rules

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

FAQPage Schema
How do I write tests that catch real failures instead of brittle wording checks?

Behavior-based testing focuses assertions on observable outcomes and regressions rather than exact wording. You write tests that validate actual software behavior, ensuring they catch real failures while remaining resilient to minor refactors.

What is the right amount of test coverage for bug fixes and refactors?

Proportional coverage scales testing depth to risk: new modules need full suites, bug fixes require targeted regression tests, refactors need behavioral assertions, and trivial edits often need no new tests. This prevents both gaps and bloat.

How do I reduce test suite bloat and clean up noisy tests?

Test hygiene involves deleting noisy tests, consolidating repetitive checks, and keeping only high-value coverage that proves real behavior. Review existing tests to identify brittle assertions and unnecessary file checks that lock in implementation details.

Do I need to run visual verification checks after UI or CSS refactors?

Visual verification is required after HTML or CSS changes. You run visual checks to confirm the UI renders correctly post-refactor, then report the results clearly to document that the visual behavior remains unchanged.

How do I review a BATS test suite for behavioral assertions and silent-failure risks?

Reviewing BATS suites requires checking that assertions validate observable behavior rather than implementation details. You identify silent-failure risks by ensuring tests fail loudly when behavior breaks and consolidate repetitive shell checks into high-value coverage.

Why does my test keep passing when the feature is broken?

Tests pass despite broken features when assertions validate wording or file structure instead of behavior. Root-cause diagnosis requires rewriting tests to assert observable outcomes, eliminating silent-failure risks by ensuring the suite fails loudly on actual regressions.