Skip to main content
skill CX Codex

running-tests · zaxbyhub — skill for Claude Code: run tests in opencode-swarm

running-tests — a skill to safely run tests in opencode-swarm from Claude Code, Codex, or OpenCode. Runs focused tests, checks file isolation, validates changes as in CI, and diagnoses errors without stalling the session.

MIT ★ 539 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ZaxbyHub/opencode-swarm --skill running-tests -a claude-code
Open on GitHub

What running-tests does

Use it when the agent runs focused tests on a single file, checks test impact from changes, validates the full set as in CI, or diagnoses truncated output. Inside: a shell adapter for bun --smol test, file loops, and repo scripts. On Windows, if Bun reports EPERM after a forced dependency refresh, rerun the same command with elevated access before treating it as a test failure.

Requires Bun and shell access. One file or explicit test can be targeted narrowly; for multiple files use loops or documented tier commands. The skill reads AGENTS.md and .opencode/skills/running-tests/SKILL.md to find the exact commands.

What it helps with

  • run focused tests on a single file without stalling
  • check which tests broke after your changes
  • isolate tests for one component
  • validate the full test suite as in a CI pipeline
  • diagnose truncated or incomplete test output

Example prompts for the agent

  • Run tests for src/utils.test.ts
  • Check impact of changes on all tests with a file loop
  • Run the full test suite as in CI and capture long output

How to install running-tests

1Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill running-tests -a claude-code

2Manually: put the files in place

~/.claude/skills/running-tests/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/running-tests/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about running-tests

How do I install running-tests in Claude Code?

Run npx skills add ZaxbyHub/opencode-swarm --skill running-tests -a claude-code, then load ~/.claude/skills/running-tests/SKILL.md.

What does running-tests do?

It's an adapter to safely run opencode-swarm tests inside Claude Code, Codex, or OpenCode. Runs focused tests, checks file isolation, validates as in CI, and diagnoses errors without stalling the session.

What do I need for the skill to work?

Bun and shell access. On Windows, if Bun reports EPERM after a dependency refresh, rerun the command with elevated access.

Source text

SKILL.md · MIT
---
name: running-tests
description: Codex adapter for safely executing opencode-swarm tests. Use whenever Codex needs to run focused tests, per-file isolation loops, CI-equivalent validation, test-impact checks, or diagnose failing/truncated test output without stalling the session.
metadata:
  audience: swarm-plugin
---

# Running Tests

Use this adapter when executing tests in `opencode-swarm`. For writing tests, load `$writing-tests` instead.

Read, in order:

1. `AGENTS.md`
2. `.opencode/skills/running-tests/SKILL.md`

Codex-specific execution notes:

- Use the available shell execution tool for `bun --smol test` and PowerShell/bash loops.
- Prefer `rg` and repo scripts to rediscover exact commands from source.
- Capture long output to a temp file when needed and report the important tail or failure lines.
- Do not use broad OpenCode `test_runner` scopes for repo validation.
- On Windows, if Bun reports `EPERM` after a forced dependency refresh, rerun the same focused command with approved/elevated access before treating it as a test failure.

Default rule: one source file or one explicit test file can be targeted narrowly; multiple files or directories should use shell loops or the documented tier commands.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Similar skills

All skills for Testing and QA →

running-tests by other authors comes first.

running-tests ZaxbyHub Sets the rules for running tests in opencode-swarm: when a shell bun call is enough, when to reach for test_runner, and how to keep the session from stalling. CX Codex +1 ★ 539repo stars running-release-tests aws running-release-tests runs UI and API release tests in AWS DevOps Agent from a pre-configured test profile. Useful before a rollout, when you want workflows and regressions checked. CX Codex +1 1,600installs writing-dev-server-tests oven-sh writing-dev-server-tests — a skill for Claude Code and five other platforms that teaches the agent to write hot-reload and dev server tests inside test/bake/. Kicks in when you create or edit bundling, HMR, or DevServer tests. CX Codex +1 1installs fix-tests NeoLabHQ fix-tests — a skill for Claude Code, Codex, Cursor and other platforms that repairs failing tests after business logic changes or refactoring. It spawns parallel agents per failing file and loops until every test goes green. CX Codex +1 1,300installs adding-e2e-tests spencerpauly adding-e2e-tests — a skill that walks your agent through Playwright setup: config, a smoke test, npm scripts and a CI run. CX Codex +1 486installs derive-tests Paweł Huryn The derive-tests Claude Code skill turns documented requirements and code into a test coverage map. Ask what to test, or run check to see whether the map is current. CX Codex +1 ★ 741repo stars rea-ci-tests-audit freyrswift rea-ci-tests-audit is a Claude Code skill that audits CI workflows and test suites for missed checks, false passes, and measured costs. It handles suite-level investigations, not routine feature tests or a lone failure. CX Codex +1 ★ 71repo stars

From the same set121

The whole set →
guardrail-patterns guardrail-patterns guides agents when editing destructive-command guards in opencode-swarm, setting document reading order and adversarial testing rules. CX Codex +1 ★ 539repo stars propagation-test The propagation-test skill sets a test procedure for changes to a shared module: exercise every consumer through the shared seam, without per-consumer overrides. CX Codex +1 ★ 539repo stars ci-failure-batching The ci-failure-batching skill blocks the agent from reporting tests as passing until the whole suite has run with the command the repo actually uses. CX Codex +1 ★ 539repo stars swarm-pr-review swarm-pr-review is a Claude Code skill that connects the canonical .opencode workflow to PR review sessions. CX Codex +1 ★ 539repo stars widen-return-type widen-return-type — a TypeScript skill for widening a function's return type with overloads, so callers keep their narrow types. CX Codex +1 ★ 539repo stars swarm-pr-review The swarm-pr-review skill for Claude Code and Codex is a thin adapter for swarm pull request reviews that delegates execution to the canonical workflow in .opencode. CX Codex +1 ★ 539repo stars spread-real-module-exports-as-base-of-every-mock-module-return-o spread-real-module-exports-as-base-of-every-mock-module-return-o is a Claude Code skill that sets a pattern for objects returned by mock.module. It activates around that pattern and Node’s built-in mocking. CX Codex +1 ★ 539repo stars gate-attribution gate-attribution sets the rule that keeps reviewer and test_engineer checks attributable: one taskId per dispatch, with lanes run in parallel to save overhead. CX Codex +1 ★ 539repo stars

Project sponsors

Companies that keep this analytics open