resolve-issue

Select, validate, and prepare GitHub issues for development with git worktrees and pull requests.

9|2|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/typemd/typemd --skill resolve-issue-typemd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: resolve-issue
Source: https://github.com/typemd/typemd/tree/main/.claude/skills/resolve-issue
Command: npx skills add https://github.com/typemd/typemd --skill resolve-issue-typemd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Many developers waste time manually selecting, validating, and preparing GitHub issues before beginning work, leading to context switching and duplicated effort. This skill automates the entire lifecycle—from issue discovery and pre‑flight checks to workspace setup, implementation planning, and pull‑request creation—so engineers can focus on coding.

Core Features & Use Cases

  • Issue discovery: Automatically parses version numbers or selects the highest‑priority open issue.
  • Pre‑flight validation: Detects existing OpenSpec changes or branches to avoid conflicts.
  • Workspace setup: Creates isolated git worktrees with proper branch naming conventions.
  • Design & implementation flow: Generates OpenSpec artifacts, orders tasks test‑first, and drives BDD or sub‑agent development.
  • Review & shipping: Runs simplification, documentation updates, verification, and opens a PR that closes the issue.

Use case example: a developer says “resolve issue #42” and the skill creates a branch, sets up tasks, and opens a PR ready for merge.

Quick Start

Resolve issue #42

Frequently Asked Questions about resolve-issue

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

FAQPage Schema
How do I automatically turn GitHub issues into pull requests?

To automatically turn GitHub issues into pull requests, you can use a skill that orchestrates issue selection, pre-flight validation, workspace setup, and PR creation. It parses issue numbers, creates isolated git worktrees, generates OpenSpec artifacts, and opens a PR ready for merge.

How do I set up a git worktree and branch for a specific GitHub issue?

Setting up a git worktree for a specific GitHub issue is handled by automated workspace setup. The process applies pre-flight checks to detect existing branches, establishes proper branch naming conventions, and creates an isolated git worktree for development.

Can I automate BDD task execution from an issue in my devops workflow?

Yes, you can automate BDD task execution from an issue in your devops workflow. The process orders tasks test-first and drives behavior-driven development or sub-agent development directly after generating the initial OpenSpec design artifacts.

What is the best way to validate a GitHub issue before starting development?

The best way to validate a GitHub issue before development is running pre-flight checks. This detects existing OpenSpec changes or branches to avoid conflicts, automatically selecting the highest-priority open issue or parsing version numbers to prepare it.

Does this issue resolution process work with the GitHub CLI?

Yes, the issue resolution process works with the GitHub CLI. It uses git and GitHub CLI tools to automate the entire lifecycle, from issue discovery and workspace setup to running final verification and opening a pull request that closes the targeted issue.

When should I avoid automated issue resolution for pull requests?

You should avoid automated issue resolution for pull requests when existing OpenSpec changes or branches are detected. The built-in pre-flight validation stops the process to prevent conflicts, meaning manual intervention is required to clear or merge existing workspaces first.