start-issue

liberioai's avatarfrom liberioai

Set up a GitHub issue for development with branch, worktree, and planning doc. Use when user says "start issue", "work on issue

⭐0stars🔀1forks📁View on GitHub🕐Updated Dec 24, 2025
[Developer Tools]

When & Why to Use This Skill

This Claude skill automates the initialization of GitHub issue development workflows. It streamlines the process of creating issue-specific branches, setting up isolated git worktrees, and generating standardized planning documents, significantly reducing manual setup time and improving developer focus.

Use Cases

  • Feature Initialization: Quickly transition from a GitHub issue to a ready-to-code environment with a single command like 'start issue #123'.
  • Parallel Task Management: Use git worktrees to work on multiple bug fixes or features simultaneously in isolated directories without the overhead of constant stashing or branch switching.
  • Standardized Documentation: Automatically generate a PLANNING.md file for every new task to ensure implementation details and progress are tracked consistently across the team.
namestart-issue
descriptionSet up a GitHub issue for development with branch, worktree, and planning doc.

Start Issue Workflow

When the user wants to start working on a GitHub issue:

Prerequisites

Ensure dossier-tools is installed:

pip install dossier-tools

If not installed, help the user install it first.

Steps

  1. Extract the issue number from their request
  2. Run the setup workflow:
    dossier run imboard-ai/development/git/setup-issue-workflow
  3. When prompted for issue number, provide the extracted number
  4. Confirm successful setup with the user

What This Creates

  • A properly named branch (feature/123-title or bug/123-title)
  • A git worktree for isolated development
  • A PLANNING.md file to track implementation