skills.rest
jamesogunsan
jamesogunsanCOMMUNITY
Explore all skills by this author →
GitHub

unit-test-design

Guide unit-test planning, review, and refactoring with isolation strategies.

Updated Mar 29, 2026
Search Tags:#refactoring#fixtures#mocking#unit-testing#determinism#test-design#test-coverage
One-click install
npx skills add https://github.com/jamesogunsan/prod-eng-skills --skill unit-test-design-jamesogunsan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unit-test-design
Source: https://github.com/jamesogunsan/prod-eng-skills/tree/main/plugins/unit-testing/skills/unit-test-design
Command: npx skills add https://github.com/jamesogunsan/prod-eng-skills --skill unit-test-design-jamesogunsan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps teams plan, design, and improve unit tests by providing guidance on test case selection, isolation strategies, mocks, fixtures, and coverage tradeoffs to increase maintainability and reliability.

Core Features & Use Cases

  • Guidance on framing public contracts, deciding what to unit test vs. what needs integration, and how to choose isolation strategies.
  • Checklists and best practices for mocks, fixtures, and deterministic tests.
  • Use cases include designing new suites, reviewing brittle tests, and refactoring test code for clarity and robustness.

Quick Start

Draft a concise unit-test plan outlining the target behavior, edge cases, mocks or fixtures, and the minimal high-value tests to cover.

Frequently Asked Questions about unit-test-design

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

FAQPage Schema
How do I design unit tests that are deterministic and reliable?▼

Design deterministic unit tests by clarifying test scope, selecting isolation strategies, and using stable fixtures and mocks to eliminate unpredictable outcomes and reduce test brittleness.

When should I use mocking vs integration tests for my components?▼

Use mocking when isolating public contracts of specific components, and switch to integration tests when verifying interactions across multiple software components to ensure accurate coverage signals.

What is the best way to structure unit-test plans for maintainability?▼

Structure unit-test plans by outlining target behaviors, defining boundary conditions, and selecting minimal high-value test cases to reduce regressions and simplify future test refactoring.

Why are my unit tests brittle and how can I refactor them?▼

Unit tests become brittle from poor isolation and unclear scope; refactor them by redefining test boundaries, updating fixtures, and removing excessive mocks to improve robustness and maintainability.

How do I choose the right test coverage signals for my software components?▼

Choose test coverage signals by focusing on maintenance-focused tradeoffs, ensuring coverage reflects critical boundary conditions and public contracts rather than chasing arbitrary high coverage metrics.

Does this approach to test design work for refactoring existing test suites?▼

Yes, this test design approach applies to refactoring existing suites by reviewing brittle tests, clarifying isolation strategies, and enforcing structured test-case selection to improve overall reliability.

Related Skills

Explore More Software Engineering Skills→
jshsakurajshsakura
22

qa-expert

Define risk-based test scope and acceptance criteria for software releases.

Community
Advanced
rob-broadleyrob-broadley

test-review

Evaluate software test quality against Farley's eight properties and severity model.

Community
Intermediate
capaas2capaas2

testing-patterns

Organize unit, integration, and end-to-end tests with AAA workflows and mocking strategies.

Community
Intermediate
velcraftingvelcrafting
1

frontend-test-additions

Implement frontend unit and end-to-end tests for React and Vue components.

Community
Intermediate