Agent skill

Bug Fix

by EmeaAppGbb in EmeaAppGbb/spec2cloud

Lightweight entry point for fixing bugs with full traceability.

MITAuto-check passedTesting & QA

Install Bug Fix

skills CLI
$ npx skills add EmeaAppGbb/spec2cloud --skill bug-fix -a claude-code

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

GitHub CLI
$ gh skill install EmeaAppGbb/spec2cloud bug-fix --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/EmeaAppGbb/spec2cloud.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/bug-fix .claude/skills/bug-fix && 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
bug-fix
GitHub stars
100
Token cost
~2k tokens
SKILL.md length
858 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

Lightweight entry point for fixing bugs with full traceability.

  • Works in 8 steps: Identify the Relevant FRD → Create a Failing Test → Human Approval of the Test → …
  • Fixing bugs with test-first methodology and spec2cloud pipeline traceability
  • SKILL.md covers Role, Input, Process and Traceability Chain, plus 4 more sections
  • Calls npm, npx and git

What it does

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.

When your agent uses it

  • Fixing bugs with test-first methodology and spec2cloud pipeline traceability
  • Tasks that involve Debugging
  • Tasks that involve Failing and flaky tests

Example prompts

  • “/bug-fix”

Requirements

  • Node.js

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Identify the Relevant FRD
  2. Create a Failing Test
  3. Human Approval of the Test
  4. Verify the Test Fails
  5. Fix the Code
  6. Run Full Regression
  7. Update State
  8. Commit

What it can do on your machine

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

    • npm
    • npx
    • git

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

  • Network

    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.

  • 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

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.

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

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 EmeaAppGbb/spec2cloud at commit 8e76618, republished under its MIT licence (© EmeaAppGbb). 858 words, ~1,955 tokens.

Download SKILL.mdSave it as .claude/skills/bug-fix/SKILL.md (or your agent's skills folder).
name
bug-fix
description
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.

Bug Fix

Role

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.

Input

A bug report containing:

  • Description — what is broken.
  • Steps to reproduce — exact sequence to trigger the bug.
  • Expected behavior — what should happen (per the FRD).
  • Actual behavior — what actually happens.
  • Environment (optional) — browser, OS, API version, etc.

If the bug report is incomplete, flag the missing information. Do NOT guess reproduction steps.

Process

Step 1 — Identify the Relevant FRD

Every bug is a deviation from specified behavior. Find the FRD that defines the expected behavior:

  1. Search specs/frd-*.md for the feature area the bug affects.
  2. Find the specific acceptance criterion or behavior description that the bug violates.
  3. Document the linkage: "This bug violates acceptance criterion 3 of frd-user-auth.md".

If no FRD covers the broken behavior:

  • The behavior was never specified → this is a feature gap, not a bug. Flag it for the Extension Planner.
  • The FRD exists but the criterion is ambiguous → flag for spec refinement.
Step 2 — Create a Failing Test

Write a test that reproduces the bug:

  • Unit test — if the bug is in a single function or module.
  • Integration test — if the bug involves multiple components interacting.
  • E2e test — if the bug is a user-visible flow issue.

The test must:

  1. Follow the existing test conventions (framework, file location, naming).
  2. Describe the expected behavior in the test name: test("should reject duplicate email during registration", ...)
  3. Assert the EXPECTED behavior (not the buggy behavior).
  4. Reference the FRD: // Validates: frd-user-auth.md, AC-3
Step 3 — Human Approval of the Test

MANDATORY GATE. Present the test to the user for review before proceeding:

  1. Show the test code and explain what it verifies.
  2. Explain which FRD acceptance criterion it maps to.
  3. Ask the user to approve or reject the test.
User ResponseAction
ApproveProceed to Step 4 (verify the test fails).
Reject with feedbackRevise the test based on feedback. Re-present.
DeferLog 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.

Step 4 — Verify the Test Fails

Run the test and confirm it fails with the expected error:

bash
# 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.

Step 5 — Fix the Code

Apply the minimal change to make the failing test pass:

  • Change as few files as possible.
  • Change as few lines as possible.
  • Do NOT refactor surrounding code.
  • Do NOT add features.
  • Do NOT fix other bugs you notice (file them separately).

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.

Show full SKILL.md (338 more words)Show less
Step 6 — Run Full Regression

After the fix, run the complete test suite:

bash
# All unit tests
npm test

# All e2e tests
npx playwright test

# Build verification
npm run build

Every 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.

Step 7 — Update State

Update .spec2cloud/state.json with the micro-increment:

json
{
  "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"
    }
  }
}
Step 8 — Commit

Commit with the standard bug-fix format:

bash
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:

  • Subject: [bugfix] {frd-id}: {brief description}
  • Body: list the test file, fixed files, and FRD reference.

Traceability Chain

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:

  • The bug is linked to a specification (not ad hoc).
  • A regression test prevents the bug from recurring.
  • The fix is auditable and reversible.

Audit Log

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=done

Decision Tree

  • Can identify relevant FRD? → Yes: create failing test. No: flag for Extension Planner.
  • Test reproduces the bug? → Yes: fix the code. No: re-examine reproduction steps.
  • Fix is minimal (< 50 lines)? → Yes: micro-increment. No: escalate to full increment.
  • All tests pass after fix? → Yes: update state and commit. No: revise fix.

Constraints

  • Test-first is mandatory. No fix without a failing test. No exceptions.
  • FRD linkage is mandatory. If no spec exists, it's a feature request.
  • Minimal change only. Refactoring goes in separate increments.
  • No silent fixes. Every fix is committed, logged, and tracked in state.
  • Regression must pass. If the fix breaks other tests, the fix is wrong.

Mandatory Completion Checklist

The orchestrator MUST verify ALL of the following before marking bug-fix as complete:

  • Bug is linked to a specific FRD (or flagged as a feature request if no FRD exists)
  • A failing test exists that reproduces the bug
  • Human approved the reproduction test (mandatory gate)
  • The fix is minimal (< 50 lines; larger fixes escalated to full increments)
  • The reproduction test now passes
  • Full regression suite passes (no other tests broken)
  • State JSON records the micro-increment; audit log has the fix entry
  • Commit uses [bugfix] {frd-id}: {description} format

BLOCKING: 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

Files

Just SKILL.md in .github/skills/bug-fix of EmeaAppGbb/spec2cloud.

Open the folder on GitHubat commit 8e76618

Compare with similar skills

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.

Bug Fix compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bug Fix this skillEmeaAppGbb/spec2cloud100—~2kAutomated safety check: PassMIT
Opsmill Dev Test Driving Bugsopsmill/infrahub529—~4kAutomated safety check: PassApache-2.0
Systematic Debuggingforyourhealth111-pixel/Vibe-Skills3.6k—~2.6kAutomated safety check: PassApache-2.0
Bug To Patch GeneratorArabelaTso/Skills-4-SE253—~4.4kAutomated safety check: PassApache-2.0
Fix The Classjoetawil7/first-pass112—~1.5kAutomated safety check: PassMIT
Fix BugMelbourneDeveloper/dart_node1131 repos~709Automated safety check: NotesNone

Similar skills

  • Writes a single failing test that reproduces a bug after its root-cause analysis is complete, before any fix is written.

    529 GitHub stars~4k tokensUpdated today
    Testing & QAAuto-check passed
  • Systematic Debugging

    foryourhealth111-pixel/Vibe-Skills

    Root-cause route for actual bugs, failing tests, build errors, crashes, stack traces, and unexpected behavior.

    3.6k GitHub stars~2.6k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Bug To Patch Generator

    ArabelaTso/Skills-4-SE

    Generate code fixes and patches from bug reports, failing test cases, error messages, and stack traces.

    253 GitHub stars~4.4k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Fix The Class

    joetawil7/first-pass

    Bug-fix routine that fixes the whole class of bug, not just the reported instance.

    112 GitHub stars~1.5k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Fix Bug

    MelbourneDeveloper/dart_node

    Fix a bug using test-driven development. An agent skill from MelbourneDeveloper/dart_node.

    113 GitHub starsUsed in 1 repo~709 tokens
    Testing & QAAuto-check: notes
  • Red Green Fix

    Comfy-Org/ComfyUI_frontend

    Bug fix workflow that proves test validity with a red-then-green CI sequence.

    2.1k GitHub stars~1.9k tokensUpdated today
    Testing & QAAuto-check passed

More from EmeaAppGbb/spec2cloud

All 39 skills in this repo
  • Azure Deployment

    EmeaAppGbb/spec2cloud

    Provision Azure infrastructure, deploy to Azure Container Apps, and verify via smoke tests.

    100 GitHub stars~1.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Contract Generation

    EmeaAppGbb/spec2cloud

    Generate API contracts, shared TypeScript types, and infrastructure resource definitions from Gherkin scenarios and test files.

    100 GitHub stars~1.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Ddd Modeling

    EmeaAppGbb/spec2cloud

    Create Domain-Driven Design proposals from product specs or brownfield extraction outputs.

    100 GitHub stars~2.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Implementation

    EmeaAppGbb/spec2cloud

    Write application code to make failing tests pass using contract-driven, slice-based architecture.

    100 GitHub stars~2.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Spec Refinement

    EmeaAppGbb/spec2cloud

    Review PRDs and FRDs through product and technical lenses. An agent skill from EmeaAppGbb/spec2cloud.

    100 GitHub stars~2.2k tokensUpdated 5 mo ago
    Auto-check passed
  • State Management

    EmeaAppGbb/spec2cloud

    Read, write, and maintain .spec2cloud/state.json across phases and increments.

    100 GitHub stars~1.5k tokensUpdated 5 mo ago
    Auto-check passed

Questions about Bug Fix

What does Bug Fix do?

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.

When should I use Bug Fix?

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.

How do I install Bug Fix in Claude Code?

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.

How do I install Bug Fix in Codex?

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.

Can I use Bug Fix 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 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.

What does Bug Fix need to run?

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.

Does Bug Fix access the network?

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.

Is Bug Fix 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 Bug Fix use?

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.

How many tokens does Bug Fix use?

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.

What are the alternatives to Bug Fix?

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.

Who maintains Bug Fix?

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.