Agent skill

Writing Tests

by bholmesdev in bholmesdev/hubble.md

A skill your agent uses when writing or reviewing tests, or deciding whether a change needs one.

MITAuto-check passedTesting & QA

Install Writing Tests

skills CLI
$ npx skills add bholmesdev/hubble.md --skill writing-tests -a claude-code

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

GitHub CLI
$ gh skill install bholmesdev/hubble.md writing-tests --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/bholmesdev/hubble.md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/writing-tests .claude/skills/writing-tests && 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
writing-tests
GitHub stars
1.5k
Token cost
~609 tokens
SKILL.md length
358 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when writing or reviewing tests, or deciding whether a change needs one.

  • Works in 3 steps: Revert the source change, keeping the… → Read the failure. It should fail on the… → If the change touches several behaviors,…
  • Reviewing tests
  • SKILL.md covers When a test is warranted, Pick the layer and Mock at the seam
  • Calls pnpm

What it does

Writing Tests is an agent skill from bholmesdev/hubble.md. Use when writing or reviewing tests, or deciding whether a change needs one.

Its SKILL.md is about 610 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: The best notepad for you and your agents. The licence is MIT.

When your agent uses it

  • Reviewing tests
  • Deciding whether a change needs one

Example prompts

  • “/writing-tests”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Revert the source change, keeping the test. Run it and confirm it goes red.
  2. Read the failure. It should fail on the behavior in the test's name, not on a changed signature, a missing helper, or a setup error.
  3. If the change touches several behaviors, revert each one separately and confirm a test goes red for each.

What it can do on your machine

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

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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

Writing Tests loads about 609 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 358 words of instructions outside code blocks.

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

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 bholmesdev/hubble.md at commit 571a523, republished under its MIT licence (© bholmesdev). 358 words, ~609 tokens.

Download SKILL.mdSave it as .claude/skills/writing-tests/SKILL.md (or your agent's skills folder).
name
writing-tests
description
Use when writing or reviewing tests, or deciding whether a change needs one.

Writing tests

Shape coverage like Kent C. Dodds' testing trophy: static checks at the base, a thin layer of unit tests, most confidence from integration tests, and the smallest budget for end-to-end tests.

When a test is warranted

A test is warranted when it catches a plausible regression that nothing else would. Prove it before keeping the test:

  1. Revert the source change, keeping the test. Run it and confirm it goes red.
  2. Read the failure. It should fail on the behavior in the test's name, not on a changed signature, a missing helper, or a setup error.
  3. If the change touches several behaviors, revert each one separately and confirm a test goes red for each.

A test that stays green on revert, or goes red for the wrong reason, is coupled to the code's shape instead of its behavior. Rewrite its assertion or delete it.

Good candidates: bug fixes, tricky UI behavior (focus handoff, keyboard flows, races between async work and navigation), and edge cases in pure logic (Markdown parsing and serialization, paths, rename rules). Glue code, prop pass-through, and variations of an already-covered behavior get no test of their own.

Show full SKILL.md (164 more words)Show less

Pick the layer

LayerHereUse for
StaticBiome, tsc, pnpm check:react-compilerAnything a type or lint rule can catch
UnitVitest on pure functionsParsers, serializers, path logic
Integration (default)Vitest + happy-dom, rendering real components against real storesUI behavior, store actions
End-to-endPlaywright driving ElectronA few core flows where a break loses users' work: opening, editing, and saving notes; creating and renaming files

happy-dom has no layout. Verify sticky, scroll, overflow, and positioning by hand with the test-desktop-app skill and put a screenshot in the PR, rather than asserting DOM structure. Most changes get no end-to-end test.

Mock at the seam

Fake only what crosses a process or time boundary: desktopApi/IPC, the filesystem, the network, timers, requestAnimationFrame. Keep stores, components, and the editor real. apps/desktop/src/store/actions.test.ts shows the pattern: a fake desktop API with the real store behind it.

If a test needs to mock internal modules to reach the behavior, move it one layer up so those modules run for real.

© bholmesdev, MIT. 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/writing-tests of bholmesdev/hubble.md.

Open the folder on GitHubat commit 571a523

Compare with similar skills

Writing Tests 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.

Writing Tests compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Tests this skillbholmesdev/hubble.md1.5k—~609Automated safety check: PassMIT
Web Application Testinganthropics/skills180k51 repos~966Automated safety check: PassApache-2.0
Diagnosing Bugsfossasia/eventyay-interpretation1.6k31 repos~2.1kAutomated safety check: PassApache-2.0
TDDfossasia/eventyay-interpretation1.6k28 repos~1.1kAutomated safety check: PassApache-2.0
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 31 repos~2.1k tokens
    Testing & QAAuto-check passed
  • TDD

    fossasia/eventyay-interpretation

    Test-driven development. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 28 repos~1.1k 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 8 repos~2.9k tokens
    Testing & QAAuto-check passed

More from bholmesdev/hubble.md

All 13 skills in this repo
  • Changelog

    bholmesdev/hubble.md

    Add a user-facing entry to CHANGELOG.md for work that just landed.

    1.5k GitHub stars~564 tokensUpdated 5 days ago
    Auto-check passed
  • Review PR

    bholmesdev/hubble.md

    Review a pull request or local branch diff for correctness, security, lifecycle, error handling, tests, and meaningful performance risks.

    1.5k GitHub stars~800 tokensUpdated 5 days ago
    Auto-check passed
  • Triage

    bholmesdev/hubble.md

    Triage an incoming GitHub, Jira, Linear, or other issue-tracker issue against the current codebase and related issues, then return a structured decision with exactly one triage state.

    1.5k GitHub stars~1.5k tokensUpdated 5 days ago
    Auto-check passed
  • Simplify

    bholmesdev/hubble.md

    Use this skill automatically when you feel your code is ready for human review, and whenever writing or reviewing code comments.

    1.5k GitHub stars~886 tokensUpdated 5 days ago
    Auto-check passed
  • Write Product Spec

    bholmesdev/hubble.md

    Write a PRODUCT.md spec for a significant Hubble user-facing feature, focused only on user experience and observable behavior.

    1.5k GitHub stars~966 tokensUpdated 5 days ago
    Auto-check passed
  • Write Tech Spec

    bholmesdev/hubble.md

    Write a TECH.md spec for a significant Hubble feature after researching the monorepo architecture.

    1.5k GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check: notes

Categories

Questions about Writing Tests

What does Writing Tests do?

A skill your agent uses when writing or reviewing tests, or deciding whether a change needs one. md. Use when writing or reviewing tests, or deciding whether a change needs one.

When should I use Writing Tests?

Writing Tests fits situations like: reviewing tests; deciding whether a change needs one.

How do I install Writing Tests in Claude Code?

Run `npx skills add bholmesdev/hubble.md --skill writing-tests -a claude-code`. Or copy the skill folder (.agents/skills/writing-tests in bholmesdev/hubble.md) into .claude/skills/writing-tests in your project. Claude Code loads it when a task matches its description.

How do I install Writing Tests in Codex?

Run `npx skills add bholmesdev/hubble.md --skill writing-tests -a codex`. Or copy the skill folder (.agents/skills/writing-tests in bholmesdev/hubble.md) into .agents/skills/writing-tests in your project. Codex loads it when a task matches its description.

Can I use Writing Tests 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 bholmesdev/hubble.md --skill writing-tests -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-tests, .gemini/skills/writing-tests, .github/skills/writing-tests and .opencode/skills/writing-tests in your project.

What does Writing Tests need to run?

Going by SKILL.md and its folder, Writing Tests needs the command-line tools its instructions call (pnpm).

Does Writing Tests 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 Writing Tests 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 Writing Tests use?

Writing Tests 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 Writing Tests use?

About 609 tokens (SKILL.md is roughly 2.4k 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 Writing Tests?

Skills that share tags, products or a category with Writing Tests: Web Application Testing (anthropics/skills, 180k stars), Diagnosing Bugs (fossasia/eventyay-interpretation, 1.6k stars), TDD (fossasia/eventyay-interpretation, 1.6k 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 Writing Tests?

bholmesdev (a GitHub user) maintains it in bholmesdev/hubble.md, which has 1,483 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 1, 2026.

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