skills.rest
luan
luanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/luan/dot-claude --skill start-luan
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
mikersaysmikersays

issue-init

Initialize a structured issue tracking system in a Git repository.

Community
Intermediate
JoeCP17JoeCP17
8

commit-push

Stage changes, create a conventional commit, and push to the remote branch.

Community
Intermediate
wiggitywhitneywiggitywhitney

prd-done

Automate branch creation, commits, pull requests, merging, and issue closure via GitHub CLI.

Community
Advanced
GGPromptsGGPrompts
147

brainstorming

Convert vague ideas into structured beads workflows with epics and dependencies.

Community
Basic