New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Eng Test Conventions

by compozy in compozy/compozy

Go test-shape discipline for Compozy. An agent skill from compozy/compozy.

MITAuto-check passedTesting & QA

Install Eng Test Conventions

skills CLI
$ npx skills add compozy/compozy --skill eng-test-conventions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install compozy/compozy eng-test-conventions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/compozy/compozy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/eng/eng-test-conventions .claude/skills/eng-test-conventions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
eng-test-conventions
GitHub stars
2.8k
Token cost
~467 tokens
SKILL.md length
195 words
Files
3 (incl. scripts, references)
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

Go test-shape discipline for Compozy. An agent skill from compozy/compozy.

  • Editing test.go under cmd
  • Runs Python scripts from its folder; calls python3 and make
  • Internal after test placement is justified
  • Fixture-only changes

What it does

Eng Test Conventions is an agent skill from compozy/compozy. 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.

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/test-shape-rules.md` and `scripts/check-test-conventions.py`).

It sits in Testing & QA, covering Test generation. The repository describes itself as: An operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each… The licence is MIT.

When your agent uses it

  • Editing test.go under cmd
  • Internal after test placement is justified
  • Fixture-only changes
  • As a replacement for eng-consolidate-test-suites

Example prompts

  • “/eng-test-conventions”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit eec2ed1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • make

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Eng Test Conventions loads about 467 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 64 tokens; SKILL.md has 195 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~467
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from compozy/compozy at commit eec2ed1, republished under its MIT licence (© compozy). 195 words, ~467 tokens.

Download SKILL.mdSave it as .claude/skills/eng-test-conventions/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
eng-test-conventions
description
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.
trigger
implicit

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:

bash
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.

© compozy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts, references) in .agents/skills/eng/eng-test-conventions of compozy/compozy.

  • SKILL.md
  • references/test-shape-rules.md
  • scripts/check-test-conventions.py

Open the folder on GitHubat commit eec2ed1

Compare with similar skills

Eng Test Conventions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Eng Test Conventions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Eng Test Conventions this skillcompozy/compozy2.8k—~467Automated safety check: PassMIT
Emcaklofas/kicad-happy1.4k1 repos~2.8kAutomated safety check: PassMIT
Swig Testswig/swig6.3k—~2.3kAutomated safety check: PassCustom licence
Generate Test Cases342164796/generate-test-cases1191 repos~2.9kAutomated safety check: PassNone
Verify Cc Safety Netkenryu42/cc-safety-net1.6k—~2kAutomated safety check: PassMIT
Wioworkersio/skills190—~5.8kAutomated safety check: PassMIT

Similar skills

  • Emc

    aklofas/kicad-happy

    EMC pre-compliance risk analysis for KiCad PCB designs — 18 check categories, 44 rule IDs covering ground planes, decoupling, I/O filtering, switching harmonics, clock routing, differential pair…

    1.4k GitHub starsUsed in 1 repo~2.8k tokens
    Testing & QAAuto-check passed

  • Swig Test

    swig/swig

    Run SWIG test suite for specific languages. An agent skill from swig/swig.

    6.3k GitHub stars~2.3k tokensUpdated yesterday
    Testing & QAAuto-check passed

  • Generate Test Cases

    342164796/generate-test-cases

    自主学习型测试文档生成器。从需求文档（Markdown）生成测试用例 XMind 文件，支持持久化记忆和持续学习。当用户提到"生成测试用例"、"根据需求生成测试"时触发。

    119 GitHub starsUsed in 1 repo~2.9k tokens
    Testing & QAAuto-check passed

  • Verify Cc Safety Net

    kenryu42/cc-safety-net

    Launch and drive the real cc-safety-net CLI — the hook decision path, explain, status/doctor, logs, and the local policy GUI — against an isolated home, capturing evidence.

    1.6k GitHub stars~2k tokensUpdated today
    Testing & QAAuto-check passed

  • Wio

    workersio/skills

    Testing workflow skill for finding high-value test candidates, writing focused tests, generating realistic workloads, reviewing test value, and diagnosing test-suite health.

    190 GitHub stars~5.8k tokensUpdated 2 mo ago
    Testing & QAAuto-check passed

  • File Server

    microsoft/WindowsProtocolTestSuites

    Official

    ALWAYS LOAD THIS SKILL when working with FileServer, SMB, SMB2, SMB3, CIFS, file sharing, MS-SMB2, MS-FSCC, MS-FSA, MS-DFSC, MS-FSRVP, MS-RSVD, MS-SQOS, or any file server protocol test…

    567 GitHub stars~4.1k tokensUpdated 22 days ago
    Testing & QAAuto-check passed

More from compozy/compozy

All 47 skills in this repo

  • Eng Real Scenario QA

    compozy/compozy

    Dogfoods Compozy through an autonomous startup scenario with live providers, cross-surface observation, and strict evidence audit.

    2.8k GitHub stars~3.4k tokensUpdated today
    Auto-check passed

  • Assistant UI

    compozy/compozy

    Guide for assistant-ui library - AI chat UI components. An agent skill from compozy/compozy.

    2.8k GitHub stars~958 tokensUpdated today
    Auto-check passed

  • Assistant UI Primitives

    compozy/compozy

    Guide for assistant-ui UI primitives - ThreadPrimitive, ComposerPrimitive, MessagePrimitive.

    2.8k GitHub stars~999 tokensUpdated today
    Auto-check passed

  • Assistant UI Runtime

    compozy/compozy

    Guide for assistant-ui runtime system and state management. An agent skill from compozy/compozy.

    2.8k GitHub stars~856 tokensUpdated today
    Auto-check passed

  • Assistant UI Streaming

    compozy/compozy

    Guide for assistant-stream package and streaming protocols. An agent skill from compozy/compozy.

    2.8k GitHub stars~813 tokensUpdated today
    Auto-check passed

  • Assistant UI Tools

    compozy/compozy

    Guide for tool registration and tool UI in assistant-ui. An agent skill from compozy/compozy.

    2.8k GitHub stars~868 tokensUpdated today
    Auto-check passed

Categories

Questions about Eng Test Conventions

What does Eng Test Conventions do?

Go test-shape discipline for Compozy. An agent skill from compozy/compozy. Eng Test Conventions is an agent skill from compozy/compozy. Go test-shape discipline for Compozy.

When should I use Eng Test Conventions?

Eng Test Conventions fits situations like: editing test.go under cmd; internal after test placement is justified; fixture-only changes; as a replacement for eng-consolidate-test-suites.

How do I install Eng Test Conventions in Claude Code?

Run `npx skills add compozy/compozy --skill eng-test-conventions -a claude-code`. Or copy the skill folder (.agents/skills/eng/eng-test-conventions in compozy/compozy) into .claude/skills/eng-test-conventions in your project. Claude Code loads it when a task matches its description.

How do I install Eng Test Conventions in Codex?

Run `npx skills add compozy/compozy --skill eng-test-conventions -a codex`. Or copy the skill folder (.agents/skills/eng/eng-test-conventions in compozy/compozy) into .agents/skills/eng-test-conventions in your project. Codex loads it when a task matches its description.

Can I use Eng Test Conventions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add compozy/compozy --skill eng-test-conventions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/eng-test-conventions, .gemini/skills/eng-test-conventions, .github/skills/eng-test-conventions and .opencode/skills/eng-test-conventions in your project.

What does Eng Test Conventions need to run?

Going by SKILL.md and its folder, Eng Test Conventions needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and make). Our summary lists: Python 3.

Does Eng Test Conventions access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Eng Test Conventions safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Eng Test Conventions use?

Eng Test Conventions is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Eng Test Conventions use?

About 467 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Eng Test Conventions?

Skills that share tags, products or a category with Eng Test Conventions: Emc (aklofas/kicad-happy, 1.4k stars), Swig Test (swig/swig, 6.3k stars), Generate Test Cases (342164796/generate-test-cases, 119 stars) and Verify Cc Safety Net (kenryu42/cc-safety-net, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Eng Test Conventions?

compozy (a GitHub organization) maintains it in compozy/compozy, which has 2,792 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 8, 2026.

Source: compozy/compozy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.