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.