issues-start

What problem does it solve?

This Skill eliminates manual steps required to begin work on a tracked issue by validating the issue file, updating its status, recording a start comment, committing the change to main, creating a feature branch, and opening a planning context so work can proceed with the issue details in scope.

Core Features & Use Cases

• Validate and locate issue files: Verifies the presence of .issues/{id}.toml and reads its fields for context.
• Safe git workflow integration: Ensures the working tree is clean on main, stages and commits the updated issue, and pushes to the remote.
• Branching and planning: Invokes a subordinate feature-start skill to create a feature branch and enters plan mode with the issue title and comments as requirements.
• Use Case: When a developer is ready to begin a ticket, use this Skill to mark the ticket in-progress, log the start time and author, push the change, and open a plan context populated with the issue details.

Quick Start

Run the skill with the issue ID (for example, 1 or 0001) to mark it in progress, commit and push the update to main, create the feature branch, and enter plan mode with the issue context.