Agent skill

Test Authoring

by ardalis in ardalis/RiverBooks

Conventions for writing xUnit tests. An agent skill from ardalis/RiverBooks.

No licenceAuto-check passedTesting & QA

Install Test Authoring

skills CLI
$ npx skills add ardalis/RiverBooks --skill test-authoring -a claude-code

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

GitHub CLI
$ gh skill install ardalis/RiverBooks test-authoring --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/ardalis/RiverBooks.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/test-authoring .claude/skills/test-authoring && 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-authoring
GitHub stars
135
Token cost
~1.5k tokens
SKILL.md length
436 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
None found

At a glance

Conventions for writing xUnit tests. An agent skill from ardalis/RiverBooks.

  • Tasks that involve Unit testing
  • SKILL.md covers Stack, Naming, Structure and Assertions (Shouldly), plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Test Authoring is an agent skill from ardalis/RiverBooks. Conventions for writing xUnit tests. Covers naming, assertion style (Shouldly), mocking (NSubstitute), fixture patterns, and the rules that make tests meaningful vs. ornamental. Load this skill before writing or reviewing any test file.

Its SKILL.md is about 1.5k 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, covering Unit testing. The repository describes itself as: Modular Monolith sample for Dometrain.

When your agent uses it

  • Tasks that involve Unit testing

Example prompts

  • “Use the test-authoring skill to convention for writing xUnit tests. An agent skill from ardalis/RiverBooks”
  • “/test-authoring”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are csharp).

    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

Test Authoring loads about 1.5k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 436 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 436 words (~1,511 tokens).

name
test-authoring
invocable
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/test-authoring of ardalis/RiverBooks.

Open the folder on GitHubat commit 94fa32a

Compare with similar skills

Test Authoring 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 Authoring compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Test Authoring this skillardalis/RiverBooks135—~1.5kAutomated safety check: PassNone
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph11211 repos~2.4kAutomated safety check: PassNone
Testing OpenLogi UIAprilNEA/OpenLogi23k—~1.1kAutomated safety check: PassApache-2.0
Go Testingcxuu/golang-skills1721 repos~1.3kAutomated safety check: PassApache-2.0
Contractssamchon/nestia2.2k—~1.3kAutomated safety check: PassMIT
Cohesion Over TestabilityEpicenterHQ/epicenter4.8k—~2kAutomated safety check: PassCustom licence

Similar skills

  • 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
  • Testing OpenLogi UI

    AprilNEA/OpenLogi

    Verifies OpenLogi's native GPUI interface with focused tests, the component gallery and a mock agent, choosing the evidence that fits each change.

    23k GitHub stars~1.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Go Testing

    cxuu/golang-skills

    A skill your agent uses when writing, reviewing, or improving Go test code — including table-driven tests, subtests, parallel tests, test helpers, test doubles, and assertions with cmp.Diff.

    172 GitHub starsUsed in 1 repo~1.3k tokens
    Testing & QAAuto-check passed
  • Contracts

    samchon/nestia

    Defines self-acknowledgments for production declarations and tests.

    2.2k GitHub stars~1.3k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Cohesion Over Testability

    EpicenterHQ/epicenter

    Collapse test-shaped production boundaries while preserving behavior and coverage.

    4.8k GitHub stars~2k tokensUpdated today
    Testing & QAAuto-check passed
  • JS-in-HTML Testing

    liaohch3/claude-tap

    Tests JavaScript embedded in an HTML file in two layers: pytest checks of the logic ported to Python, and Playwright runs in a real browser for the DOM.

    3.3k GitHub stars~924 tokensUpdated 16 days ago
    Testing & QAAuto-check passed

More from ardalis/RiverBooks

  • Crap Analysis

    ardalis/RiverBooks

    Analyze code coverage and CRAP (Change Risk Anti-Patterns) scores to identify high-risk code.

    135 GitHub starsUsed in 2 repos~3.4k tokens
    Auto-check passed
  • Stryker Dotnet

    ardalis/RiverBooks

    Run Stryker.NET mutation testing against a specific .NET source file.

    135 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Categories

Questions about Test Authoring

What does Test Authoring do?

Conventions for writing xUnit tests. An agent skill from ardalis/RiverBooks. Test Authoring is an agent skill from ardalis/RiverBooks. Conventions for writing xUnit tests.

When should I use Test Authoring?

Test Authoring fits situations like: tasks that involve Unit testing.

How do I install Test Authoring in Claude Code?

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

How do I install Test Authoring in Codex?

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

Can I use Test Authoring 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 ardalis/RiverBooks --skill test-authoring -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-authoring, .gemini/skills/test-authoring, .github/skills/test-authoring and .opencode/skills/test-authoring in your project.

What does Test Authoring need to run?

SKILL.md names no scripts, command-line tools or credentials: Test Authoring is instructions for the agent only.

Does Test Authoring 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 Test Authoring 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 Authoring use?

No licence was found for Test Authoring or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Test Authoring use?

About 1.5k tokens (SKILL.md is roughly 6k 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 Authoring?

Skills that share tags, products or a category with Test Authoring: TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars), Testing OpenLogi UI (AprilNEA/OpenLogi, 23k stars), Go Testing (cxuu/golang-skills, 172 stars) and Contracts (samchon/nestia, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Test Authoring?

ardalis (a GitHub user) maintains it in ardalis/RiverBooks, which has 135 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 9, 2026.

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