fix-issue

Automates single-file GitHub bug fixes and generates pull requests with test validation.

12|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/jikig-ai/soleur --skill fix-issue-jikig-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-issue
Source: https://github.com/jikig-ai/soleur/tree/main/plugins/soleur/skills/fix-issue
Command: npx skills add https://github.com/jikig-ai/soleur --skill fix-issue-jikig-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill automates the repetitive and error-prone workflow of applying a small code fix for an open GitHub issue, running tests, and creating a pull request so maintainers can review and merge the change. It reduces manual branching, test baseline collection, and PR creation overhead for fixes that are confined to a single file.

Core Features & Use Cases

  • Single-file automated fixes: Read an issue, create a worktree branch, apply a single-file patch, and open a PR with a clear template.
  • Test-aware workflow: Detects and runs the repository test command when available, compares results to a baseline, and aborts on new failures.
  • Governance and safety: Honors exclude-label flags to skip agent-authored issues, enforces no dependency/schema/infrastructure changes, and never executes commands embedded in issue bodies.
  • Use Case: Automatically patch a small bug reported in an open issue, run the test suite, and surface a ready-for-review PR labeled for either auto-merge eligibility or human review.

Quick Start

Use the command /soleur:fix-issue 123 to attempt an automated single-file fix for issue 123 and open a PR for human review.

Frequently Asked Questions about fix-issue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitHub issue fixes and open a pull request?

Automate GitHub issue fixes by applying a single-file code change to a new git worktree branch, running tests, and pushing a pull request for maintainer review.

Does automated issue triage work with multi-file or dependency changes?

Automated issue triage does not work with multi-file fixes, dependency updates, schema changes, or migrations; it strictly enforces a single-file patch constraint to ensure safety.

How does the automated PR workflow handle testing before submitting code?

The automated PR workflow detects and runs the repository test command, compares results against a baseline, and aborts the pull request if new test failures are introduced.

Do I need gh CLI and write permissions to automate single-file issue fixes?

You need gh CLI access and repository write permissions to automate single-file issue fixes, allowing the tool to create branches and push pull requests directly to GitHub.

Can I exclude specific issues from automated code fixes?

You can exclude specific issues from automated code fixes by applying exclude-label flags, which short-circuit the process to skip agent-authored issues and prevent unwanted PRs.

Why does the automated patch workflow ignore commands embedded in issue bodies?

The automated patch workflow ignores commands embedded in issue bodies as a governance and safety measure, ensuring only deterministic single-file fixes are applied without executing arbitrary code.