Opsmill Dev Test Driving Bugs
opsmill/infrahub
Writes a single failing test that reproduces a bug after its root-cause analysis is complete, before any fix is written.
Lightweight entry point for fixing bugs with full traceability.
$ npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install EmeaAppGbb/spec2cloud bug-fix --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/EmeaAppGbb/spec2cloud.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/bug-fix .claude/skills/bug-fix && rm -rf skills-srcUse ~/.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/
Install the "bug-fix" agent skill from https://github.com/EmeaAppGbb/spec2cloud/tree/vNext/.github/skills/bug-fix into .claude/skills/bug-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bug-fix", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/EmeaAppGbb/spec2cloud/tree/vNext/.github/skills/bug-fixType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install EmeaAppGbb/spec2cloud bug-fix --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/EmeaAppGbb/spec2cloud.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/skills/bug-fix .agents/skills/bug-fix && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "bug-fix" agent skill from https://github.com/EmeaAppGbb/spec2cloud/tree/vNext/.github/skills/bug-fix into .agents/skills/bug-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bug-fix", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install EmeaAppGbb/spec2cloud bug-fix --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/EmeaAppGbb/spec2cloud.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/skills/bug-fix .cursor/skills/bug-fix && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "bug-fix" agent skill from https://github.com/EmeaAppGbb/spec2cloud/tree/vNext/.github/skills/bug-fix into .cursor/skills/bug-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bug-fix", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/EmeaAppGbb/spec2cloud.git --path .github/skills/bug-fix--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install EmeaAppGbb/spec2cloud bug-fix --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/EmeaAppGbb/spec2cloud.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/skills/bug-fix .gemini/skills/bug-fix && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "bug-fix" agent skill from https://github.com/EmeaAppGbb/spec2cloud/tree/vNext/.github/skills/bug-fix into .gemini/skills/bug-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bug-fix", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install EmeaAppGbb/spec2cloud bug-fixInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/EmeaAppGbb/spec2cloud.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/skills/bug-fix .github/skills/bug-fix && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "bug-fix" agent skill from https://github.com/EmeaAppGbb/spec2cloud/tree/vNext/.github/skills/bug-fix into .github/skills/bug-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bug-fix", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install EmeaAppGbb/spec2cloud bug-fix --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/EmeaAppGbb/spec2cloud.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/skills/bug-fix .opencode/skills/bug-fix && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "bug-fix" agent skill from https://github.com/EmeaAppGbb/spec2cloud/tree/vNext/.github/skills/bug-fix into .opencode/skills/bug-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bug-fix", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
bug-fixLightweight entry point for fixing bugs with full traceability.
Bug Fix is an agent skill from EmeaAppGbb/spec2cloud. Lightweight entry point for fixing bugs with full traceability. Takes a bug report, links to the relevant FRD, generates a failing test, fixes the code, and ships. Tracked as a micro-increment. Use when fixing bugs with test-first methodology and spec2cloud pipeline traceability.
Its SKILL.md is about 2k 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 Debugging, Failing and flaky tests and QA and bug reports. The licence is MIT.
8 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 8e76618. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
npmnpxgitFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use npm, npx and git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Bug Fix loads about 2k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 858 words of instructions outside code blocks.
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.
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.
The full file from EmeaAppGbb/spec2cloud at commit 8e76618, republished under its MIT licence (© EmeaAppGbb). 858 words, ~1,955 tokens.
.claude/skills/bug-fix/SKILL.md (or your agent's skills folder).You are the Bug Fix Agent. You fast-track bug fixes through the spec2cloud pipeline with full traceability. Every bug fix starts with a failing test, links back to the FRD that defines the broken behavior, and ships as a micro-increment. You do NOT skip steps — test-first is mandatory.
Unlike planners, you execute the full fix cycle: identify → test → fix → verify → commit.
A bug report containing:
If the bug report is incomplete, flag the missing information. Do NOT guess reproduction steps.
Every bug is a deviation from specified behavior. Find the FRD that defines the expected behavior:
specs/frd-*.md for the feature area the bug affects.If no FRD covers the broken behavior:
Write a test that reproduces the bug:
The test must:
test("should reject duplicate email during registration", ...)// Validates: frd-user-auth.md, AC-3MANDATORY GATE. Present the test to the user for review before proceeding:
| User Response | Action |
|---|---|
| Approve | Proceed to Step 4 (verify the test fails). |
| Reject with feedback | Revise the test based on feedback. Re-present. |
| Defer | Log the bug as a known issue in state.json. Resume previous work. |
Do NOT proceed to fix the code until the user approves the test. The test defines what "fixed" means — the user must agree on that definition.
Run the test and confirm it fails with the expected error:
# Unit test
npm test -- --grep "should reject duplicate email"
# E2e test
npx playwright test --grep "duplicate email"If the test passes → the bug is not reproduced. Re-examine the reproduction steps and the test. Do NOT proceed until the test fails.
Apply the minimal change to make the failing test pass:
The fix should be obvious from the diff. If the fix is complex, it may warrant a full increment rather than a bug-fix micro-increment.
After the fix, run the complete test suite:
# All unit tests
npm test
# All e2e tests
npx playwright test
# Build verification
npm run buildEvery test must pass — the bug-fix test AND all pre-existing tests. If any pre-existing test breaks, the fix is too broad or has side effects. Revise.
Update .spec2cloud/state.json with the micro-increment:
{
"increments": {
"bugfix-{nnn}": {
"type": "bugfix",
"frd": "frd-{feature}.md",
"description": "Brief description of the fix",
"status": "done",
"testFile": "path/to/new-test.spec.ts",
"fixedFiles": ["path/to/fixed-file.ts"],
"completedAt": "ISO-timestamp"
}
}
}Commit with the standard bug-fix format:
git add -A
git commit -m "[bugfix] frd-user-auth: reject duplicate email during registration
- Added failing test: src/tests/auth/duplicate-email.test.ts
- Fixed: src/services/auth/register.ts (added unique constraint check)
- Validates: frd-user-auth.md, AC-3
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>"Commit message format:
[bugfix] {frd-id}: {brief description}Every bug fix creates a complete traceability chain:
Bug Report
→ FRD (frd-{feature}.md, acceptance criterion N)
→ Failing Test (proves the bug exists)
→ Human Approval (user agrees the test captures the problem)
→ Fix (minimal code change)
→ Passing Test (proves the bug is fixed)
→ Commit (links all artifacts)
→ State (tracked as micro-increment)This chain ensures:
Append to .spec2cloud/audit.log:
[ISO-timestamp] step=bugfix action=test-created bug=bugfix-{nnn} frd={frd-id} test={test-file} result=failing
[ISO-timestamp] step=bugfix action=test-approved bug=bugfix-{nnn} approver=human result=approved
[ISO-timestamp] step=bugfix action=fix-applied bug=bugfix-{nnn} files={fixed-files} result=done
[ISO-timestamp] step=bugfix action=regression-passed bug=bugfix-{nnn} result=all-green
[ISO-timestamp] step=bugfix action=committed bug=bugfix-{nnn} commit={sha} result=doneThe orchestrator MUST verify ALL of the following before marking bug-fix as complete:
[bugfix] {frd-id}: {description} formatBLOCKING: If any item is unchecked, the skill has NOT completed successfully. The orchestrator must loop back and complete the missing items.
© EmeaAppGbb, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .github/skills/bug-fix of EmeaAppGbb/spec2cloud.
Open the folder on GitHubat commit 8e76618
Bug Fix 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Bug Fix this skillEmeaAppGbb/spec2cloud | 100 | — | ~2k | Automated safety check: Pass | MIT | |
| Opsmill Dev Test Driving Bugsopsmill/infrahub | 529 | — | ~4k | Automated safety check: Pass | Apache-2.0 | |
| Systematic Debuggingforyourhealth111-pixel/Vibe-Skills | 3.6k | — | ~2.6k | Automated safety check: Pass | Apache-2.0 | |
| Bug To Patch GeneratorArabelaTso/Skills-4-SE | 253 | — | ~4.4k | Automated safety check: Pass | Apache-2.0 | |
| Fix The Classjoetawil7/first-pass | 112 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Fix BugMelbourneDeveloper/dart_node | 113 | 1 repos | ~709 | Automated safety check: Notes | None |
opsmill/infrahub
Writes a single failing test that reproduces a bug after its root-cause analysis is complete, before any fix is written.
foryourhealth111-pixel/Vibe-Skills
Root-cause route for actual bugs, failing tests, build errors, crashes, stack traces, and unexpected behavior.
ArabelaTso/Skills-4-SE
Generate code fixes and patches from bug reports, failing test cases, error messages, and stack traces.
joetawil7/first-pass
Bug-fix routine that fixes the whole class of bug, not just the reported instance.
MelbourneDeveloper/dart_node
Fix a bug using test-driven development. An agent skill from MelbourneDeveloper/dart_node.
Comfy-Org/ComfyUI_frontend
Bug fix workflow that proves test validity with a red-then-green CI sequence.
EmeaAppGbb/spec2cloud
Provision Azure infrastructure, deploy to Azure Container Apps, and verify via smoke tests.
EmeaAppGbb/spec2cloud
Generate API contracts, shared TypeScript types, and infrastructure resource definitions from Gherkin scenarios and test files.
EmeaAppGbb/spec2cloud
Create Domain-Driven Design proposals from product specs or brownfield extraction outputs.
EmeaAppGbb/spec2cloud
Write application code to make failing tests pass using contract-driven, slice-based architecture.
EmeaAppGbb/spec2cloud
Review PRDs and FRDs through product and technical lenses. An agent skill from EmeaAppGbb/spec2cloud.
EmeaAppGbb/spec2cloud
Read, write, and maintain .spec2cloud/state.json across phases and increments.
Categories
Lightweight entry point for fixing bugs with full traceability. Bug Fix is an agent skill from EmeaAppGbb/spec2cloud. Lightweight entry point for fixing bugs with full traceability.
Bug Fix fits situations like: fixing bugs with test-first methodology and spec2cloud pipeline traceability; tasks that involve Debugging; tasks that involve Failing and flaky tests.
Run `npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a claude-code`. Or copy the skill folder (.github/skills/bug-fix in EmeaAppGbb/spec2cloud) into .claude/skills/bug-fix in your project. Claude Code loads it when a task matches its description.
Run `npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a codex`. Or copy the skill folder (.github/skills/bug-fix in EmeaAppGbb/spec2cloud) into .agents/skills/bug-fix in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bug-fix, .gemini/skills/bug-fix, .github/skills/bug-fix and .opencode/skills/bug-fix in your project.
Going by SKILL.md and its folder, Bug Fix needs the command-line tools its instructions call (npm, npx and git). Our summary lists: Node.js.
SKILL.md contains no URLs. Its commands use npm, npx and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
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.
Bug Fix is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2k tokens (SKILL.md is roughly 7.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Bug Fix: Opsmill Dev Test Driving Bugs (opsmill/infrahub, 529 stars), Systematic Debugging (foryourhealth111-pixel/Vibe-Skills, 3.6k stars), Bug To Patch Generator (ArabelaTso/Skills-4-SE, 253 stars) and Fix The Class (joetawil7/first-pass, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
EmeaAppGbb (a GitHub organization) maintains it in EmeaAppGbb/spec2cloud, which has 100 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on April 16, 2026.
Source: EmeaAppGbb/spec2cloud on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.