Skip to content
Back to search

wio

MarketplaceWorks with Claude CodeGitHub

@workersio/skills helps coding agents write, review, and diagnose high-value tests instead of coverage padding.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/workersio--skills/badge.svg)](/listings/workersio--skills)

HTML

<a href="/listings/workersio--skills"><img src="/api/listings/workersio--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Direct skill install:

npx skills add workersio/skills

Codex plugin marketplace:

codex plugin marketplace add workersio/skills

Claude Code plugin marketplace:

claude plugin marketplace add workersio/skills
claude plugin install wio@workersio-skills

For local Codex plugin testing from this checkout:

codex plugin marketplace add .

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 24 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "wio",
  3. "owner": {
  4. "name": "workers.io"
  5. },
  6. "description": "@workersio/skills helps coding agents write, review, and diagnose high-value tests instead of coverage padding.",
  7. "plugins": [
  8. {
  9. "name": "wio",
  10. "source": "./plugins/wio",
  11. "description": "Testing workflow skill for high-value test discovery, strategy selection, focused test implementation, realistic workload generation, strict test review, and suite health diagnostics.",
  12. "version": "0.1.0",
  13. "author": {
  14. "name": "workers.io"
  15. },
  16. "category": "Productivity",
  17. "tags": [
  18. "testing",
  19. "quality",
  20. "skills"
  21. ]
  22. }
  23. ]
  24. }
README.md · README · 208 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="public/readme-demo.gif" alt="@workersio/skills running inside a coding agent terminal" width="100%">
  3. </div>
  4. <h1>Skills to find unknown bugs before release!</h1>
  5. <p>
  6. We help your agents test edge cases in your software where rare production bugs hide.
  7. </p>
  8. <p>
  9. <a href="https://github.com/workersio/skills/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/workersio/skills?style=for-the-badge&color=111827"></a>
  10. <a href="https://github.com/workersio/skills/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/workersio/skills?style=for-the-badge&color=111827"></a>
  11. </p>
  12. Most AI-written tests optimize for coverage. They assert implementation details,
  13. mock away the real risk, and pass even when the product breaks.
  14. `@workersio/skills` gives coding agents a testing workflow that asks a stricter
  15. question: will this test catch a real regression that users, operators,
  16. reviewers, or maintainers care about?
  17. `@workersio/skills` is one skill with five command modes:
  18. ```text
  19. $wio scan # Find high-value tests to add next.
  20. $wio test # Run candidate discovery, strategy, implementation, and review.
  21. $wio workload # Generate realistic, replayable workloads with new bug-finding value.
  22. $wio review # Judge whether a test should be kept, redone, or removed.
  23. $wio doctor # Audit suite health, weak assertions, flakes, mocks, and CI blind spots.
  24. ```
  25. ## Works With
  26. <p>
  27. <picture>
  28. <source media="(prefers-color-scheme: dark)" srcset="public/openai-dark.svg">
  29. <img src="public/openai-light.svg" alt="Codex" width="22" align="center">
  30. </picture> &nbsp;&nbsp;
  31. <picture>
  32. <source media="(prefers-color-scheme: dark)" srcset="public/claude-dark.svg">
  33. <img src="public/claude-light.svg" alt="Claude Code" width="22" align="center">
  34. </picture> &nbsp;&nbsp;
  35. <picture>
  36. <source media="(prefers-color-scheme: dark)" srcset="public/cursor-dark.svg">
  37. <img src="public/cursor-light.svg" alt="Cursor" width="22" align="center">
  38. </picture> &nbsp;&nbsp;
  39. <picture>
  40. <source media="(prefers-color-scheme: dark)" srcset="public/copilot-dark.svg">
  41. <img src="public/copilot-light.svg" alt="GitHub Copilot" width="22" align="center">
  42. </picture> &nbsp;&nbsp;
  43. <picture>
  44. <source media="(prefers-color-scheme: dark)" srcset="public/gemini-dark.svg">
  45. <img src="public/gemini-light.svg" alt="Gemini" width="22" align="center">
  46. </picture>
  47. </p>
  48. `@workersio/skills` is packaged for Codex and Claude Code today. The core skill
  49. content is plain Markdown, so the testing workflow can also be adapted by other
  50. coding agents that support project skills, instructions, or reusable prompts.
  51. ## Install
  52. Direct skill install:
  53. ```bash
  54. npx skills add workersio/skills
  55. ```
  56. Codex plugin marketplace:
  57. ```bash
  58. codex plugin marketplace add workersio/skills
  59. ```
  60. Claude Code plugin marketplace:
  61. ```bash
  62. claude plugin marketplace add workersio/skills
  63. claude plugin install wio@workersio-skills
  64. ```
  65. For local Codex plugin testing from this checkout:
  66. ```bash
  67. codex plugin marketplace add .
  68. ```
  69. ## What It Provides
  70. | Area | What the agent gets |
  71. | --- | --- |
  72. | Test discovery | Maps product behavior, recent changes, existing tests, CI, and risk areas before choosing what to test. |
  73. | Strategy selection | Chooses the right level: unit, component, integration, contract, E2E, workload, fuzz, property, mutation, resilience, or monitoring. |
  74. | Test writing | Adds focused tests using the repository's own framework, naming, fixtures, helpers, and runner conventions. |
  75. | Workload generation | Creates realistic, adversarial, seeded, replayable sessions or traffic that add coverage beyond wrappers and parameter sweeps. |
  76. | Test review | Applies a strict value gate: `KEEP`, `REDO`, or `REMOVE`. Coverage alone is not enough. |
  77. | Suite health | Finds weak assertions, over-mocking, broad snapshots, flakes, skipped tests, slow feedback loops, and CI blind spots. |
  78. ## Command Guide
  79. | Command | Use it when | Example |
  80. | --- | --- | --- |
  81. | `$wio scan [target]` | You do not yet know what to test. | `$wio scan checkout` |
  82. | `$wio test [target]` | You want the full write-and-review loop. | `$wio test billing eligibility regression` |
  83. | `$wio workload [target]` | The risk lives in realistic user, API, CLI, job, or load behavior. | `$wio workload onboarding session` |
  84. | `$wio review [target]` | A test exists and you need to decide whether it has real value. | `$wio review tests/billing_eligibility_test.py` |
  85. | `$wio doctor [target]` | The suite is hard to trust or maintain. | `$wio doctor API test suite` |
  86. ## Quality Bar
  87. An approved test should answer:
  88. - What user, operator, customer, or API consumer failure does this prevent?
  89. - What production, release, support, debugging, or review risk does it reduce?
  90. - Would it fail for the regression that matters?
  91. - Which assertion or invariant catches the plausible bug?
  92. - Does the setup preserve the important dependency, state, permission, timing, or data risk?
  93. - Does this belong in local development, PR CI, nightly, release, or production monitoring?
  94. - If this is a workload, what existing workload gap does it fill?
  95. If those answers are weak, the test should be redesigned or removed.
  96. ## Subagents
  97. `@workersio/skills` includes three optional focused subagents:
  98. | Subagent | Role |
  99. | --- | --- |
  100. | `wio-candidate-scout` | Read-only discovery of high-value test candidates before implementation. |
  101. | `wio-strategy-critic` | Read-only challenge of the selected strategy before editing tests. |
  102. | `wio-test-reviewer` | Read-only post-write review that returns `KEEP`, `REDO`, or `REMOVE`. |
  103. The main agent still writes the test and owns the final decision. Subagents
  104. inspect, challenge, and review; they do not duplicate the reference library or
  105. replace the main workflow.
  106. ## Repository Layout
  107. | Path | Purpose |
  108. | --- | --- |
  109. | `plugins/wio/skills/wio/SKILL.md` | Source of truth for the skill workflow. |
  110. | `plugins/wio/skills/wio/references/` | Detailed testing guidance loaded only when relevant. |
  111. | `plugins/wio/agents/` | Claude Code plugin subagents. |
  112. | `.codex/agents/` | Codex custom-agent TOML files for project or user installs. |
  113. | `plugins/wio/hooks/hooks.json` | Shared plugin hook config. |
  114. | `.agents/plugins/marketplace.json` | Codex marketplace entry. |
  115. | `.claude-plugin/marketplace.json` | Claude Code marketplace entry. |
  116. | `public/` | README assets, demo GIF, and agent icons. |
  117. ## Codex Agents And Hooks
  118. Codex plugin installs include the skill and plugin hook config. Codex custom
  119. agents are a separate native surface loaded from `.codex/agents/` in a project
  120. or `~/.codex/agents/` for the user.
  121. Enable the Codex agents globally:
  122. ```bash
  123. mkdir -p ~/.codex/agents
  124. cp .codex/agents/wio-*.toml ~/.codex/agents/
  125. ```
  126. Enable the Codex agents for the current project:
  127. ```bash
  128. mkdir -p .codex/agents
  129. cp /path/to/wio-skills/.codex/agents/wio-*.toml .codex/agents/
  130. ```
  131. Enable the Codex hook config for the current project:
  132. ```bash
  133. mkdir -p .codex
  134. cp /path/to/wio-skills/.codex/hooks.json .codex/hooks.json
  135. ```
  136. ## Claude Code Agents And Hooks
  137. Claude plugin installs include the skill, plugin hooks, and Markdown
  138. subagents from `plugins/wio/agents/`. Project-local Claude Code agents can also
  139. be copied into `.claude/agents/` when a repository is not using the plugin.
  140. ## References
  141. Detailed testing guidance lives only in
  142. `plugins/wio/skills/wio/references/`. Reference topics cover behavior mapping,
  143. risk-based testing, test levels, workload modeling, oracles, fixtures, mocks,
  144. suite health, static analysis, security testing, fuzzing, property-based
  145. testing, mutation testing, performance testing, resilience testing, and
  146. regression selection.
  147. ## Contributing
  148. Keep the public surface area small: one skill, `wio`, with command modes
  149. `scan`, `test`, `workload`, `review`, and `doctor`.
  150. Detailed testing guidance belongs in
  151. `plugins/wio/skills/wio/references/`, not duplicated inside cloud folders,
  152. subagents, hooks, or extra skill trees. When adding a reference topic, add both
  153. `overview.md` and `tools.md`, then link it from
  154. `plugins/wio/skills/wio/references/index.md`.
  155. See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution workflow and release
  156. expectations.
  157. ## License
  158. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.