writing-tests SKILL.md skillA

writing-tests from amplifthq/openmeld is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add amplifthq/openmeld/writing-tests@git:20260910.c390b58

Pins git:20260910.c390b58 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
amplifthq/openmeld
Path
.agents/skills/writing-tests/SKILL.md
Versions recorded
1
Latest version
git:20260910.c390b58, committed Sep 10, 2026
Size
20,243 bytes
Repository stars
1,397
License
MIT

Gates whether a new test should exist and forces it to be efficient, protecting CI from low-value test bloat. Use before any change to what a pytest, Jest, or Playwright test asserts or sets up, down to one fixture or one assertion added to an existing block. Front-loads the value bar (every test must catch a realistic regression no existing test already catches; extend the nearest existing test before writing a new standalone one; test behavior through the public interface, not implementation…

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

# Writing tests worth keeping

The rationale and the same rules in human-facing form live in the handbook: [Backend coding conventions › Testing](https://posthog.com/handbook/engineering/conventions/backend-coding#testing) (`docs/published/handbook/engineering/conventions/backend-coding.md`).
This skill is the operational gate — run it before writing tests. It carries the decision procedure plus [a catalog of the bug shapes we actually ship](references/mistakes-we-make.md).
The gate covers added coverage, not new test functions. One fixture and one assertion added to an existing block goes through the same two questions, because that is the shape this skill asks you to prefer.

## The gate: two questions

Before writing any test, answer both in one sentence each.

### 1. Does it earn its place?

> **What realistic regression does this test catch that no existing test already catches?**

If you can't answer it concretely — name the bug, the code path, the input that would break — **do not write the test.**
"Increases coverage", "good practice", and "the function exists" are not answers.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add amplifthq/openmeld/writing-tests@sha256:e6005730691ccf0e

The line at the top of this page pins the label git:20260910.c390b58, 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_44hhh467liiigkez.svg)](https://markdownregistry.com/a/art_44hhh467liiigkez)

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

Versions

The registry has recorded 1 version of this file, committed on Sep 10, 2026.

versioncommittedcommitsizeaudit
git:20260910.c390b58 latest2026-09-10 c390b58 20,243 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 (20243 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

amplifthq/openmeld · 1,397 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_44hhh467liiigkez
GET https://markdownregistry.com/api/v1/resolve?ref=amplifthq/openmeld/writing-tests
GET https://markdownregistry.com/api/v1/blob/e6005730691ccf0ee3cdaca54ffca80c64ae9964ef7dde571790d54901bee6bd

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 amplifthq/openmeld

debugging-ci-failures SKILL.md skill
amplifthq/openmeld · .agents/skills/debugging-ci-failures/SKILL.md · Debugs failing GitHub Actions CI runs for PostHog PRs, commits, and branches, and answers broad CI-health questions…
git:20260910.c390b58 · audit A · 1,397 stars
fixing-flaky-tests SKILL.md skill
amplifthq/openmeld · .agents/skills/fixing-flaky-tests/SKILL.md · Guides an agent through reproducing, root-causing, fixing, and validating flaky tests in the PostHog monorepo. Use when…
git:20260910.c390b58 · audit A · 1,397 stars
openmeld-changelog SKILL.md skill
amplifthq/openmeld · .agents/skills/openmeld-changelog/SKILL.md · Maintain the official OpenMeld Changelog from repository evidence. Use when deciding whether a change needs a Changelog…
git:20260817.95a6179 · audit A · 1,397 stars
postgresql-planning SKILL.md skill
amplifthq/openmeld · .agents/skills/postgresql-planning/SKILL.md · Plan and implement OpenMeld PostgreSQL business persistence, schemas and migrations, transactions, Hyperdrive access…
git:20261008.b152329 · audit A · 1,397 stars
react-doctor SKILL.md skill
amplifthq/openmeld · .agents/skills/react-doctor/SKILL.md · Use when the user requests React Doctor or a React code-health audit, or when a concrete React diagnostic question…
v1.0.0 · audit A · 1,397 stars
CLAUDE.md@.claude CLAUDE.md file
amplifthq/openmeld · .claude/CLAUDE.md
git:20260811.1c72e54 · audit A · 1,397 stars
docs-lifecycle-scan SKILL.md skill
amplifthq/openmeld · .claude/skills/docs-lifecycle-scan/SKILL.md · Use when closing out a feature, tidying developing/ documentation, or asked to check docs health — runs the lifecycle…
git:20260811.1c72e54 · audit A · 1,397 stars
openmeld-changelog SKILL.md skill
amplifthq/openmeld · .claude/skills/openmeld-changelog/SKILL.md · Use when deciding whether an OpenMeld change needs a Changelog entry, writing or publishing an entry, preparing release…
git:20260817.95a6179 · audit A · 1,397 stars
release-runbook SKILL.md skill
amplifthq/openmeld · .claude/skills/release-runbook/SKILL.md · Use when asked to deploy, release, publish, or ship OpenMeld to production — workers, Web, CLI, or local components…
git:20261018.d66c6b1 · audit A · 1,397 stars
wake-trace SKILL.md skill
amplifthq/openmeld · .claude/skills/wake-trace/SKILL.md · Use when diagnosing a Wake that failed, stalled, or produced no visible reply — dispatch, setup handoff, or reply-path…
git:20260811.1c72e54 · audit A · 1,397 stars
AGENTS.md AGENTS.md file
amplifthq/openmeld · AGENTS.md
git:20261019.3864a0b · audit A · 1,397 stars
CLAUDE.md CLAUDE.md file
amplifthq/openmeld · CLAUDE.md
git:20260910.7caf11b · audit A · 1,397 stars

Every file in amplifthq/openmeld

Other files named writing-tests

writing-tests SKILL.md skill
zaxbyhub/opencode-swarm · .claude/skills/writing-tests/SKILL.md · Claude Code adapter for opencode-swarm test authoring rules. Use before creating or modifying tests in this repository.
git:20261012.097422c · audit A · 509 stars
writing-tests SKILL.md skill
zaxbyhub/opencode-swarm · .agents/skills/writing-tests/SKILL.md · Codex adapter for opencode-swarm test authoring rules. Use before creating or modifying any test file in this…
git:20261012.097422c · audit A · 509 stars
writing-tests SKILL.md skill
zaxbyhub/opencode-swarm · .opencode/skills/writing-tests/SKILL.md · Guidelines for writing, organizing, and maintaining tests in the opencode-swarm repository. Covers framework rules…
git:20260912.8b7d5a7 · audit A · 509 stars
writing-tests SKILL.md skill
zaxbyhub/opencode-swarm · .opencode/writing-tests/SKILL.md · Compatibility pointer to the canonical opencode-swarm writing-tests skill.
git:20260607.3533f67 · audit A · 509 stars
writing-tests SKILL.md skill
iliaal/ai-skills · skills/writing-tests/SKILL.md · Generic test writing discipline: test quality, real assertions, anti-patterns, and rationalization resistance. Use when…
git:20261019.5dcf8a9 · audit A · 43 stars
writing-tests SKILL.md skill
dayfinggg/openai-codex-agent-skills · codex/skills/writing-tests/SKILL.md · Writes and reviews automated tests test-first, in each language's test framework. Use when writing, changing, or…
git:20261015.18f69f5 · audit A · 8 stars
writing-tests SKILL.md skill
ahgraber/skills · skills/writing-tests/SKILL.md · Use when writing or reviewing tests in any language, or diagnosing a suite that is slow, brittle, or hard to read…
git:20260819.209d97b · audit A · 6 stars
writing-tests SKILL.md skill
cristhianzl/claude-skills-czl · configs/agnostic/skills/writing-tests/SKILL.md · Write unit, integration, and E2E tests that follow the testing pyramid, the Arrange-Act-Assert pattern, the…
git:20260619.c43368b · audit A · 5 stars

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