How does it help with mock objects?

The skill identifies 'over-mocking' where tests become too coupled to implementation details, and suggests using real objects or test builders for more realistic behavior verification.

What is the AAA pattern in PHP testing?

AAA stands for Arrange, Act, and Assert. It is a pattern that organizes tests into three distinct sections to ensure they are easy to read and focus on a single behavior.

Does it support frameworks other than PHPUnit?

While the examples are PHPUnit-centric, the quality patterns like naming, isolation, and structural logic apply to any PHP testing framework, including Pest.

Can this skill identify why my PHP tests are flaky?

Yes, it specifically scans for shared state between tests, such as static variables or improper use of setUpBeforeClass, which are common causes of test flakiness.

PHP Test Quality Checker

Name: PHP Test Quality Checker
Author: dykyi-roman

bydykyi-roman

•

Security & Testing

Audits PHP test suites for structural integrity, naming conventions, assertion strength, and test isolation best practices.

The PHP Test Quality Checker is a specialized tool for developers using Claude Code to ensure their PHPUnit or Pest test suites meet high professional standards. It automatically identifies common testing anti-patterns such as mixed Arrange-Act-Assert (AAA) structures, fragile shared states, and vague naming conventions. By analyzing patterns like over-mocking and weak assertions, this skill provides actionable feedback and suggested refactorings to turn brittle tests into a robust, maintainable safety net for your PHP applications.

Key Features

01Audits assertion quality to ensure tests are meaningful and rigorous

02Enforces the Arrange-Act-Assert (AAA) pattern for improved test readability

0345 GitHub stars

04Validates descriptive naming conventions to clarify test intent

05Detects shared state and isolation issues that lead to flaky tests

06Identifies over-mocking and suggests the use of test builders and real objects

Use Cases

01Performing automated code reviews on new test submissions to ensure quality standards

02Refactoring legacy PHP test suites to improve reliability and maintainability

03Standardizing testing patterns across a distributed PHP development team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dykyi-roman/awesome-claude-code check-test-quality

For use in Claude.ai and ChatGPT

Download Skill