How do I install the Eng Test Conventions skill?

Run npx skillmds@latest add compozy/eng-test-conventions in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Eng Test Conventions safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Eng Test Conventions?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Eng Test Conventions free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Eng Test Conventions?

compozy (@compozy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Eng Test Conventions by compozy — Agent Skill

Name: Eng Test Conventions
Author: compozy

Eng Test Conventions

Go test-shape discipline for Compozy. Use when writing or editing *_test.go under cmd or internal after test placement is justified. Do not use for non-Go tests, fixture-only changes, or as a replacement for eng-consolidate-test-suites.

compozy da15dbe 3 files · 10.4 KB Updated Sep 17, 2026

File contents

Compozy Test Conventions

Name the invariant, owning layer, and existing suite before changing coverage; reuse that working note. Use eng-consolidate-test-suites when placement is unclear, including a proposed new file with no obvious owner. No test is needed merely to raise coverage.

Read the nearby canonical suite and relevant sections of references/test-shape-rules.md for subtests, parallelism, errors/assertions, interfaces, tags, integration behavior, mocks, helpers, and race/cgo.

Co-ship affected ACP/E2E fixtures, typed matchers, and generated expectations with runtime-contract changes. Exercise real SQLite or production-like process boundaries where the owning layer requires them.
Repair production regressions without weakening tests. If an assertion itself contradicts the established contract, substantiate that mismatch before changing it.
Keep touched tests in the canonical subtest shape; do not rewrite unrelated suites. Transitive t.Setenv use keeps the enclosing test serial.

For changed Go test files, run the read-only heuristic checker:

python3 .agents/skills/eng/eng-test-conventions/scripts/check-test-conventions.py <file_path>

Fix real findings; document a demonstrated false positive without weakening the convention. Run the affected repository race-enabled suite with CGO_ENABLED=1 and the owning lint lane, reusing current evidence when those inputs are unchanged. Root make gate and PR CI apply once at the enclosing delivery stage; a local test change does not require opening a PR.

Frequently asked questions