solve-issue

Convert a GitHub issue into a review-ready pull request with a plan-then-implement workflow.

3|1|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/Garsdal/Dojo --skill solve-issue-garsdal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: solve-issue
Source: https://github.com/Garsdal/Dojo/tree/main/.claude/skills/solve-issue
Command: npx skills add https://github.com/Garsdal/Dojo --skill solve-issue-garsdal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you move a GitHub issue from filed status to an open pull request ready for human review by planning changes first and then implementing them on a feature branch.

Core Features & Use Cases

  • Two-phase workflow with review gate: Research and generate a plan, stop for user approval, then implement in a second run.
  • Issue-aware branching and PR setup: Creates a branch following the prescribed <type>/issue-<N>-<slug> pattern and opens a PR that includes the correct “Closes #<N>” line.
  • Codebase research tailored to the issue: Reads referenced files, explores relevant callers/callees, checks related tests, and aligns the approach with the Dojo repo’s documented “Recipes” when applicable.
  • Version bump support (when release docs exist): If docs/RELEASING.md is present, performs the required semver bump and changelog updates including agent prompt notes.

Quick Start

Run the solve-issue skill for a specific GitHub issue number or URL, review the generated plan.md, then run the same skill again to implement and open the PR.

Frequently Asked Questions about solve-issue

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

FAQPage Schema
How do I turn a GitHub issue into a pull request automatically?

You can convert a GitHub issue into a pull request by running an automated workflow that researches the codebase, generates an implementation plan, creates a feature branch, codes the changes, and opens a PR with a Closes #<N> line.

What's the best way to plan codebase changes before opening a PR for an issue?

The best way to plan codebase changes before opening a PR is to use a plan-then-implement flow that reads referenced files, explores callers and callees, checks related tests, and pauses for user approval before writing code on a feature branch.

Can I automatically create a feature branch and link it to a GitHub issue?

Yes, you can automatically create a feature branch and link it to a GitHub issue. The process creates a branch following a specific naming pattern and ensures the resulting pull request includes a load-bearing Closes #<N> line to link the issue.

How does automated issue resolution handle version bumps and changelog updates?

Automated issue resolution handles version bumps by checking for release documentation. If release docs exist, it performs the required semver bump and updates the changelog with agent prompt notes before opening the pull request.

Does the issue-to-PR workflow require manual code review before implementation?

Yes, the issue-to-PR workflow requires manual code review before implementation. It follows a two-phase design that generates a plan to a deterministic path and pauses for user approval before proceeding to implement the actual code changes.