One-click install
npx skills add https://github.com/I2olanD/dotfiles --skill test-design-i2oland
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-design
Source: https://github.com/I2olanD/dotfiles/tree/main/.config/opencode/skill/test-design
Command: npx skills add https://github.com/I2olanD/dotfiles --skill test-design-i2oland

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a pragmatic blueprint for test design based on the pyramid model, helping teams structure, review, and evolve their test suites.

Core Features & Use Cases

  • Defines a pyramid-based test distribution: Unit 60-70%, Integration 20-30%, E2E 5-10%.
  • Offers framework-agnostic conventions for test naming, file organization, and AAA structure.
  • Guides coverage quality criteria and anti-pattern avoidance for audit and improvement.

Quick Start

Use the guide to audit or design a test suite. Identify your project's testing framework, categorize tests into unit, integration, and E2E, and apply the recommended distributions, naming conventions, and review practices to improve feedback speed and confidence.

Frequently Asked Questions about test-design

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

FAQPage Schema
What is the recommended test distribution for unit, integration, and E2E tests?

The recommended test distribution follows the test pyramid model: 60-70% unit tests, 20-30% integration tests, and 5-10% E2E tests. This distribution enables fast feedback and reliable software delivery by keeping slow, brittle E2E tests to a minimum.

How do I structure test suites using AAA patterns across different frameworks?

To structure test suites using AAA patterns, apply framework-agnostic conventions for test naming, file organization, and the Arrange-Act-Assert structure. This approach works across Jest, Pytest, and other common frameworks to maintain consistent test design.

Does this test design approach work with both Jest and Pytest?

Yes, this test design approach works with Jest, Pytest, and other common testing frameworks. It provides framework-agnostic conventions for naming, file organization, and coverage targets, ensuring broad applicability across different technology stacks.

How do I audit an existing test suite for anti-patterns and coverage quality?

To audit an existing test suite, categorize your tests into unit, integration, and E2E layers. Compare the current distribution against pyramid targets, review AAA structure adherence, and identify anti-patterns to improve coverage quality and feedback speed.

Why should my test suite follow the test pyramid principles?

Your test suite should follow test pyramid principles to enable fast feedback and reliable software delivery. By enforcing a pyramid-based distribution, you minimize slow E2E tests and maximize quick unit tests, reducing execution time and maintenance costs.

What are the limitations of using a strict test pyramid distribution for all projects?

A strict test pyramid distribution may not suit all projects, as complex integration-heavy architectures might require more mid-level tests. The 60-70% unit and 5-10% E2E targets are guidelines, meaning teams should adjust distributions based on specific application needs.