Agent skill

Test Conventions

by Inebrio in Inebrio/Routerly

Where tests live in this repository, how to run them, and what a story owes in coverage.

AGPL-3.0Auto-check passedTesting & QA

Install Test Conventions

skills CLI
$ npx skills add Inebrio/Routerly --skill test-conventions -a claude-code

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

GitHub CLI
$ gh skill install Inebrio/Routerly 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/Inebrio/Routerly.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/test-conventions .claude/skills/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
test-conventions
GitHub stars
100
Token cost
~467 tokens
SKILL.md length
247 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Where tests live in this repository, how to run them, and what a story owes in coverage.

  • Testing & QA work in your project
  • SKILL.md covers Layout, What a story owes, How to write them and Browser coverage, plus 1 more section
  • Calls npm

What it does

Test Conventions is an agent skill from Inebrio/Routerly. Where tests live in this repository, how to run them, and what a story owes in coverage. Use when writing or running tests.

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA. The repository describes itself as: Self-hosted LLM gateway that routes requests across AI providers (OpenAI, Anthropic, Gemini, Mistral, Ollama) using intelligent multi-policy scoring — including an LLM-native… The licence is AGPL-3.0.

When your agent uses it

  • Testing & QA work in your project

Example prompts

  • “/test-conventions”

What it can do on your machine

Read from SKILL.md and the folder at commit bcf58f1. 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

    Shell commands in SKILL.md call:

    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    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

Test Conventions loads about 467 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 247 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~467

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Inebrio/Routerly at commit bcf58f1, republished under its AGPL-3.0 licence (© Inebrio). 247 words, ~467 tokens.

Download SKILL.mdSave it as .claude/skills/test-conventions/SKILL.md (or your agent's skills folder).
name
test-conventions
description
Where tests live in this repository, how to run them, and what a story owes in coverage. Use when writing or running tests.

Test conventions

Layout

  • Unit and integration tests: *.test.ts, beside the source they cover.
  • Runner: vitest, through the workspace scripts.
npm test                                  # everything
npm test --workspace=packages/service     # one package

What a story owes

  • One test per acceptance criterion, named so the criterion id is recognisable in the output.
  • One regression test per blocking finding the validator raised. That finding got through once; the test is what stops it coming back.
  • Edge cases from the story: absent, empty, malformed, unauthorised, duplicate.
  • Every management endpoint: fastify.inject() proving allowed → 200 and forbidden → 403.

How to write them

  • Assert on observable behaviour: the response, the exit code, the stored state, what the page shows. Never on internal call order.
  • One reason to fail per test. A test asserting five unrelated things tells you nothing when it goes red.
  • No sleeps. Wait for the condition.
  • Deterministic: no dependency on wall-clock time, on ordering between tests, or on state another test left behind.
  • Never weaken an assertion to make a test pass. A failing test is either a bug in the code or a wrong test, and both need saying out loud.
  • Never touch the developer's own runtime state. Tests run against the story's isolated environment.

Browser coverage

Anything a user sees gets exercised in a real browser: the happy path, one failure path, both themes. A console error is a failure even when the screen looks right.

Boundary

You write tests, not source. If a test cannot pass without changing source, that is a finding to report, not a change to make.

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

Files

Just SKILL.md in .agents/skills/test-conventions of Inebrio/Routerly.

Open the folder on GitHubat commit bcf58f1

Compare with similar skills

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.

Test Conventions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Test Conventions this skillInebrio/Routerly100—~467Automated safety check: PassAGPL-3.0
Web Application Testinganthropics/skills180k51 repos~966Automated safety check: PassApache-2.0
Diagnosing Bugsfossasia/eventyay-interpretation1.6k32 repos~2.1kAutomated safety check: PassApache-2.0
TDDpietheinstrengholt/rssmonster56430 repos~906Automated safety check: PassMIT
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph11211 repos~2.4kAutomated safety check: PassNone
TDDsanity-io/sanity6.4k20 repos~1kAutomated safety check: PassMIT

Similar skills

  • Web Application Testing

    anthropics/skills

    Official

    Tests local web applications with Python Playwright scripts, checking frontend behavior, capturing screenshots and reading browser console logs.

    180k GitHub starsUsed in 51 repos~966 tokens
    Testing & QAAuto-check passed
  • Diagnosing Bugs

    fossasia/eventyay-interpretation

    Diagnosis loop for hard bugs and performance regressions. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 32 repos~2.1k tokens
    Testing & QAAuto-check passed
  • TDD

    pietheinstrengholt/rssmonster

    Test-driven development. An agent skill from pietheinstrengholt/rssmonster.

    564 GitHub starsUsed in 30 repos~906 tokens
    Testing & QAAuto-check passed
  • TDD Workflow

    hellangleZ/burn-in-cceverywhere-ralph

    A skill your agent uses when writing new features, fixing bugs, or refactoring code.

    112 GitHub starsUsed in 11 repos~2.4k tokens
    Testing & QAAuto-check passed
  • TDD

    sanity-io/sanity

    Official

    Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.

    6.4k GitHub starsUsed in 20 repos~1k tokens
    Testing & QAAuto-check passed
  • Context Driven Development

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md…

    380 GitHub starsUsed in 9 repos~2.9k tokens
    Testing & QAAuto-check passed

More from Inebrio/Routerly

All 17 skills in this repo
  • Docs Conventions

    Inebrio/Routerly

    Where documentation lives in this repository, how a page is structured, and what a change owes the docs.

    100 GitHub stars~624 tokensUpdated 2 days ago
    Auto-check passed
  • Feature Lifecycle

    Inebrio/Routerly

    Run a Tier 1 or Tier 2 feature end to end — feature level, story level, parallelism, integration, and retrospective.

    100 GitHub stars~3k tokensUpdated 2 days ago
    Auto-check passed
  • Story Lifecycle

    Inebrio/Routerly

    Run one user story end to end in its own worktree, from claim to merge.

    100 GitHub stars~905 tokensUpdated 2 days ago
    Auto-check passed
  • Validation Protocol

    Inebrio/Routerly

    How to validate a story against its criteria and write the report, including what counts as evidence and what counts as blocking.

    100 GitHub stars~628 tokensUpdated 2 days ago
    Auto-check passed
  • Analysis Format

    Inebrio/Routerly

    Shape of a feature analysis document (00-analysis.md). An agent skill from Inebrio/Routerly.

    100 GitHub stars~472 tokensUpdated 2 days ago
    Auto-check passed
  • Blueprint Format

    Inebrio/Routerly

    Shape of a story blueprint, the technical plan an orchestrator executes.

    100 GitHub stars~581 tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Test Conventions

What does Test Conventions do?

Where tests live in this repository, how to run them, and what a story owes in coverage. Test Conventions is an agent skill from Inebrio/Routerly. Where tests live in this repository, how to run them, and what a story owes in coverage.

When should I use Test Conventions?

Test Conventions fits situations like: testing & QA work in your project.

How do I install Test Conventions in Claude Code?

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

How do I install Test Conventions in Codex?

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

Can I use 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 Inebrio/Routerly --skill 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/test-conventions, .gemini/skills/test-conventions, .github/skills/test-conventions and .opencode/skills/test-conventions in your project.

What does Test Conventions need to run?

Going by SKILL.md and its folder, Test Conventions needs the command-line tools its instructions call (npm).

Does Test Conventions access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is 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. Review the folder before installing.

What licence does Test Conventions use?

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

How many tokens does 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.

What are the alternatives to Test Conventions?

Skills that share tags, products or a category with Test Conventions: Web Application Testing (anthropics/skills, 180k stars), Diagnosing Bugs (fossasia/eventyay-interpretation, 1.6k stars), TDD (pietheinstrengholt/rssmonster, 564 stars) and TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Test Conventions?

Inebrio (a GitHub organization) maintains it in Inebrio/Routerly, which has 100 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

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