# find-and-run-tests

> Claude/Codex skill by [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.7k stars · Updated 2026-08-31

How to find, build, and run tests in workerd. Covers wd-test, kj\_test target naming, bazel query patterns, and common flags. Also covers parent project integration tests if workerd is used as a submodule. Load this skill when you need to locate or run a test and aren't sure of the exact target name or invocation.

## Install

```sh
git clone https://github.com/cloudflare/workerd /tmp/workerd && ln -s /tmp/workerd/.opencode/skills/find-and-run-tests ~/.claude/skills/find-and-run-tests
```

## From README

Finding and Running Tests workerd Tests Test types | Type | File extension | BUILD macro | Target suffix | | ----------------- | -------------- | ----------- | ------------------------------ | | JS/TS integration | .wd-test | wdtest() | None (target name = rule name) | | C++ unit | -test.c++ | kjtest() | None | Finding targets Running Common flags | Flag | Purpose | | ------------------------ | ------------------------------------------- | | --testoutput=streamed | Stream test output to terminal in real time | | --nocachetestresults | Force re-run, don't use cached results | | --testtimeout=120 | Override default test timeout (seconds) | --- Parent Project Integration Tests If workerd is used as a submodule in a parent project, that project may have its own integration test framework with different conventions. Load the parent-project-skills skill to discover those conventions. General principles that apply to any integration test framework Target naming with variant suffixes.

## Links

- HTML page: https://omgskills.com/skills/cloudflare/workerd/find-and-run-tests/
- GitHub: https://github.com/cloudflare/workerd
- Author: [@cloudflare](https://omgskills.com/library/cloudflare/index.md)

## More from this repo

- [bazel-test-hygiene](https://omgskills.com/skills/cloudflare/workerd/bazel-test-hygiene/index.md) — Mandatory rules for running bazel tests during development.
   - [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.7k stars
- [commit-categories](https://omgskills.com/skills/cloudflare/workerd/commit-categories/index.md) — Commit categorization rules for changelogs and "what's new" summaries.
   - [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.7k stars
- [dad-jokes](https://omgskills.com/skills/cloudflare/workerd/dad-jokes/index.md) — After completing any task that took more than ~5 tool calls, or after long-running builds/tests finish, load this skill...
   - [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.7k stars