start-issue

Fetch GitHub issue details, assign yourself, create a feature branch, apply kanban label, and comment.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/khwerhahn/okuban.nvim --skill start-issue-khwerhahn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-issue
Source: https://github.com/khwerhahn/okuban.nvim/tree/main/.claude/skills/start-issue
Command: npx skills add https://github.com/khwerhahn/okuban.nvim --skill start-issue-khwerhahn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Start work on a GitHub issue by automatically fetching details, assigning you, creating a feature branch, applying the kanban label, and commenting on the issue to track progress.

Core Features & Use Cases

  • Fetch issue details and verify the open state to ensure visibility.
  • Assign yourself and apply the "okuban:in-progress" kanban label to reflect current work.
  • Create a short-lived feature branch based on the issue title for local development.
  • Comment on the issue to announce the start and provide progress updates.
  • Handle common edge cases like existing PRs or local branches and guide the user through decisions.

Quick Start

Run the start-issue command with the issue number to begin work on that issue.

Frequently Asked Questions about start-issue

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

FAQPage Schema
How do I automate starting work on a GitHub issue?

You can automate starting a GitHub issue by running a command that fetches issue details, assigns you, creates a feature branch, applies a kanban label, and posts a progress comment. This workflow requires Git, GitHub CLI, and network access to GitHub to execute successfully.

What is the best way to create a feature branch from a GitHub issue title?

The best way to create a feature branch from a GitHub issue title is using an automated start command that validates the issue is open, generates a short-lived local branch, and applies a kanban label. It guides you through decisions when existing local branches or PRs are detected.

Do I need GitHub CLI installed to assign myself and apply kanban labels to issues?

Yes, you need GitHub CLI, Git, and network access to GitHub to assign yourself and apply kanban labels. The workflow fetches issue details, verifies the open state, assigns you, applies the label, creates a branch, and comments on the issue.

How does the start workflow handle existing PRs or local branches linked to an issue?

The start workflow handles existing PRs or local branches by implementing guards that detect them and guiding the user through decisions. It checks for existing local branches and PRs before attempting to create a new feature branch or comment on the issue.

Can I use this issue automation workflow if my team coordinates via branches and in-line PR updates?

Yes, this issue automation workflow is designed for teams coordinating via branches, PRs, and in-line updates where GitHub issues act as the unit of work. It fetches details, assigns you, creates a feature branch, applies a kanban label, and comments to track progress.