fix-issue
A workflow for developers to fix GitHub issues. It reads the issue, implements a fix, runs tests, and commits with the proper reference.
Install
mkdir -p .claude/skills/fix-issue-bettercallzaal && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12073" && unzip -o skill.zip -d .claude/skills/fix-issue-bettercallzaal && rm skill.zipInstalls to .claude/skills/fix-issue-bettercallzaal
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use when fixing a GitHub issue — reads the issue, implements the fix, writes tests, and commits referencing the issue numberKey capabilities
- →Read GitHub issue details and comments
- →Identify the root cause of an issue
- →Propose a fix approach to the user
- →Implement fixes following ZAO OS conventions
- →Write tests and verify Zod schemas
How it works
The skill reads a GitHub issue, plans a fix, implements it following conventions, runs tests, and creates a commit message referencing the issue number.
Inputs & outputs
When to use fix-issue
- →Fixing reported bugs
- →Implementing small feature requests
- →Patching regressions
About fix-issue
Reads issue details and comments to understand the required fix. Implements changes following strict conventions, runs linting and build checks, and commits with a specific reference to the original issue.
Use when fixing a GitHub issue — reads the issue, implements the fix, writes tests, and commits referencing the issue number
When not to use it
- →When the user wants to push changes directly without review
- →When refactoring surrounding code beyond the immediate fix
- →When the issue is not a GitHub issue
Limitations
- →Requires reading the full issue and comments before starting
- →Always proposes the fix approach before implementing
- →Never pushes changes; the user decides when to push
How it compares
This skill provides a structured, end-to-end workflow for fixing GitHub issues, including planning, implementation, testing, and committing with specific conventions, unlike a generic code modification process.
Compared to similar skills
fix-issue side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| fix-issue (this skill) | 0 | 8mo | Review | Intermediate |
| dependency-upgrade | 26 | 8mo | Review | Intermediate |
| vitest | 41 | 9mo | No flags | Intermediate |
| testing-workflow | 16 | 1y | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
dependency-upgrade
wshobson
Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use when upgrading framework versions, updating major dependencies, or managing breaking changes in libraries.
vitest
antfu
Vitest fast unit testing framework powered by Vite with Jest-compatible API. Use when writing tests, mocking, configuring coverage, or working with test filtering and fixtures.
testing-workflow
amo-tech-ai
Comprehensive testing workflow for E2E, integration, and unit tests. Use when testing applications layer-by-layer, validating user journeys, or running test suites.
run-nx-generator
nrwl
Run Nx generators with prioritization for workspace-plugin generators. Use this when generating code, scaffolding new features, or automating repetitive tasks in the monorepo.
zod-4
prowler-cloud
Zod 4 schema validation patterns. Trigger: When creating or updating Zod v4 schemas for validation/parsing (forms, request payloads, adapters), including v3 -> v4 migration patterns.
write-unit-tests
tldraw
Writing unit and integration tests for the tldraw SDK. Use when creating new tests, adding test coverage, or fixing failing tests in packages/editor or packages/tldraw. Covers Vitest patterns, TestEditor usage, and test file organization.