Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

testing

The how of testing: pyramid, AAA, isolation, risk coverage, determinism. Guarantees the DoD's "tests are green". test-expert-csk applies it. Use when writing or changing tests, or when a suite is flaky, slow or green for the wrong reason.

byerlikaya · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add byerlikaya/claude-starter-kit --skill testing

About this skill


name: testing description: | The how of testing: pyramid, AAA, isolation, risk coverage, determinism. Guarantees the DoD's "tests are green". test-expert-csk applies it. Use when writing or changing tests, or when a suite is flaky, slow or green for the wrong reason.

Testing Discipline

Trigger phrases: "write a test", "run the tests", "coverage", "are the tests green", "unit test", "integration test", "tests pass locally", "flaky test", "test is flaky"

Goal: behavior correctness — test real behavior without breaking product code just to make a test pass.

Principles

  • Pyramid: many unit, fewer integration, few end-to-end (e2e). Limit e2e to critical flows.
  • AAA: Arrange-Act-Assert; one test = one behavior.
  • Isolation & determinism: external dependencies are mocked/faked; time and randomness are fixed; test order is independent.
  • Risk-coverage: risk, not metrics. Critical path + boundary + negative + authorization (IDOR/404) scenarios.
  • Naming: what_it_tests_under_which_condition_what_it_expects — on failure it is clear what broke.
  • Red-green: first a failing test, then the implementation.

Watch out

  • Flaky = bug: an occasionally failing test is not tolerated; it is fixed at the root.
  • In snapshot/golden-file tests, avoid needless brittleness (assert only the meaningful output).

Tests that cannot fail

Green is evidence only if the test could have gone red. Shapes that check nothing:

  • Assertion restates the code: it recomputes the implementation's own expression, so it moves with every change.
  • Setup guarantees the result: arrange plants the value the assert reads back; it holds even if the act never ran.
  • Expected value derived the way the code derives it: same formula, query or parser — the same wrong assumption on both sides still matches.
  • A double asserted against its own stub: the fake is told to return X and the test asserts X; only the fake runs.
  • No assertion: it passes because nothing threw. If not throwing is the behavior under test, assert that.

Prove it can fail: break what the test covers — invert a condition, return a wrong constant — confirm it goes red, then restore. Still green means the test is documentation, not a gate: fix it or delete it, never count it as coverage.

Flaky triage

An intermittent failure gets exactly one outcome, decided the day it is seen: fix it, quarantine it (out of the gating lane, never out of the suite, with an owner and a date), or escalate it as the product defect it signals. Infrastructure flakes may get a bounded, logged retry; product flakes never do. Classifying them, the retry rule, and what a quarantine entry must carry: references/flaky-triage.md.

DoD (this skill's contribution)

  • The project's own test command is green — read it off the manifest/CI (dotnet test · npm test · pytest · go test ./...), don't assume one; critical paths are covered; no empty/meaningless tests.