start

Create a Git branch and link it to a beads issue.

4|3|Updated Jul 14, 2025

Search Tags:#git #workflow #task management #branching #issue tracking #git branch

Ready to run

npx skills add https://github.com/luan/dot-claude --skill start-luan

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: start
Source: https://github.com/luan/dot-claude/tree/main/skills/start
Command: npx skills add https://github.com/luan/dot-claude --skill start-luan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of starting new work by creating Git branches and optionally linking them to issue tracking items, ensuring a clear connection between code and tasks.

Core Features & Use Cases

Branch Creation: Automatically creates a new Git branch with a specified name.
Issue Linking: Optionally associates the new branch with an existing issue in the 'beads' tracking system.
Issue Creation: If no issue ID is provided, it prompts the user to create a new issue.
Status Updates: Updates the status of linked issues to 'in_progress'.
Use Case: When beginning a new feature, you can use this skill to create a branch named feature/user-auth and link it to bead ID 123, automatically updating the bead's status.

Quick Start

Start a new branch named 'my-new-feature' and link it to bead ID 456.

Frequently Asked Questions about start

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

FAQPage Schema

How do I create a Git branch and link it to an issue tracker ID?▼

This Skill creates a new Git branch and optionally links it to an issue tracker ID. If no issue ID is provided, it prompts you to create a new issue before proceeding with the branch creation.

What happens if I start a new Git branch without an issue ID?▼

If you start a new Git branch without an issue ID, the workflow prompts you to create a new issue. This ensures every branch maintains a clear connection between your code and task management system.

Can I automatically update issue status when creating a Git branch?▼

Yes, you can automatically update issue status when creating a Git branch. Linking a new branch to an existing issue tracker ID automatically updates that issue's status to in_progress.

How do I enforce branch naming conventions when starting new work?▼

To enforce branch naming conventions when starting new work, this Skill handles the naming process automatically during branch creation. This ensures consistent naming across your version control system.

Does this branch creation workflow integrate with the beads tracking system?▼

Yes, this branch creation workflow integrates with the beads tracking system. It optionally associates new Git branches with existing bead issues and updates their status to in_progress.

What is the best way to connect task management items with version control branches?▼

The best way to connect task management items with version control branches is to initiate a branch and link it directly to an issue ID. This streamlines the process by ensuring a clear connection between code and tasks.