testing-philosophy SKILL.md skillA

testing-philosophy from flagrare/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add flagrare/agent-skills/testing-philosophy@git:20260611.9c42181

Pins git:20260611.9c42181 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
flagrare/agent-skills
Path
plugins/flagrare/skills/testing-philosophy/SKILL.md
Versions recorded
2
Latest version
git:20260611.9c42181, committed Jun 11, 2026
First version recorded
Jun 11, 2026
Size
7,753 bytes
Repository stars
13
License
none declared

Use when proposing, writing, or reviewing automated tests, defines what a good test is: behavior over implementation details, and the Testing Trophy with a hard floor on end-to-end coverage for user-facing features. Generalized to any language and any layer (frontend, backend, CLI, library), not just JS/React. REQUIRED BACKGROUND for skills that plan or review tests, atdd-plan, implementation-review, tdd-writer, wrap-up. Use when the user asks whether tests are good, what to test, why a test…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Testing philosophy

This is the shared definition of "good test" that every flagrare skill which proposes or reviews tests leans on. It distils Kent Dodds' testing writing and generalizes it past his JS/React context to any language and any layer. (Grounded in [`docs/research/2026-06-11-kent-dodds-testing-philosophy.md`](../../../../docs/research/2026-06-11-kent-dodds-testing-philosophy.md).)

## The one principle

> **The more your tests resemble the way your software is used, the more confidence they can give you.** (Kent C. Dodds)

Every rule below is a corollary. The principle is already language- and layer-agnostic; "the way your software is used" just resolves to a different surface in each context. When a testing decision is unclear, return to this sentence.

## Pillar 1: Behavior over implementation details

An **implementation detail** is anything *"users of your code will not typically use, see, or even know about."* A test bound to one fails in both directions at once:

- **False negative on refactor**: you change internals without changing behavior, and the test breaks anyway. It cries wolf.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add flagrare/agent-skills/testing-philosophy@sha256:9ec90cfee47214b6

The line at the top of this page pins the label git:20260611.9c42181, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vuhc2hazwt6lvzrh.svg)](https://markdownregistry.com/a/art_vuhc2hazwt6lvzrh)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Jun 11, 2026.

versioncommittedcommitsizeaudit
git:20260611.9c42181 latest2026-06-11 9c42181 7,753 BA view · diff
git:20260611.3141b322026-06-11 3141b32 7,812 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7753 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

flagrare/agent-skills · 13 stars · license none declared · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vuhc2hazwt6lvzrh
GET https://markdownregistry.com/api/v1/resolve?ref=flagrare/agent-skills/testing-philosophy
GET https://markdownregistry.com/api/v1/blob/9ec90cfee47214b62f3cae372d15037d659b4ac0d92526dc8a254e2b08c3f4fd

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from flagrare/agent-skills

atdd-plan SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/atdd-plan/SKILL.md · Produce an ATDD-first implementation plan in Claude Code's native plan mode, with named design patterns called out…
git:20261002.8acabf4 · audit A · 13 stars
brag-doc SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/brag-doc/SKILL.md · Generate a comprehensive, impact-framed brag-doc entry for a chosen time window (day, week, biweek, month, or custom)…
git:20261028.5276366 · audit A · 13 stars
bug-bash SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/bug-bash/SKILL.md · Programmatic bug bashing, ingest a prescribed test plan (Notion, markdown, pasted spec), drive a real running system…
git:20261030.337a593 · audit A · 13 stars
career SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/career/SKILL.md · Run the career skills that are due, in one pass, and return one short combined digest plus an updated board. It reads…
git:20261028.5276366 · audit A · 13 stars
codebase-explore SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/codebase-explore/SKILL.md · Explore the codebase to map conventions, reusable utilities, analogous features, and data flows relevant to a planned…
git:20260611.9c42181 · audit A · 13 stars
communication-setup SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/communication-setup/SKILL.md · Set up, change or remove how Claude talks to you: a custom output style with your reply rules, a reminder of those…
git:20261104.0a7bead · audit A · 13 stars
daily-code-review SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/daily-code-review/SKILL.md · Generate a daily code review report showing stale PRs, items needing your attention, and active work for your team. Use…
git:20261008.b2c58b8 · audit A · 13 stars
debug-hunt SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/debug-hunt/SKILL.md · Evidence-first debugging for bugs that are hard to reproduce, intermittent, performance-related, or where previous…
git:20260611.9c42181 · audit A · 13 stars
design-review SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/design-review/SKILL.md · Evaluate and refine UI the way a senior product designer would, visual hierarchy, spacing and rhythm, typographic…
git:20261014.0a5d2b2 · audit A · 13 stars
editorial-pass SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/editorial-pass/SKILL.md · Review a finished or near-finished document the way a human editor reads it, start to finish, building a model of what…
git:20261104.528454a · audit A · 13 stars
figma-matcher SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/figma-matcher/SKILL.md · Enforces pixel-perfect implementation of Figma designs by exhaustively extracting every visual property from Figma…
git:20260731.d6ff316 · audit A · 13 stars
five-lens-review SKILL.md skill
flagrare/agent-skills · plugins/flagrare/skills/five-lens-review/SKILL.md · Evaluate a product-direction question through five expert lenses, Senior PM, Senior Product Engineer, Senior Product…
git:20260611.9c42181 · audit A · 13 stars

Every file in flagrare/agent-skills

Browse by kind, by grade A, or by owner.