worktree-init
Create a git worktree for a bd issue. Use when spawning a worker agent for an issue. Keywords: worktree, worker, spawn, parallel, issue.
📖 中文导读:Create a git worktree for a bd issue. Use when spawning a worker agent for an issue. Keywords: worktree, worker, spawn, parallel, issue. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: worktree-init description: "Create a git worktree for a bd issue. Use when spawning a worker agent for an issue. Keywords: worktree, worker, spawn, parallel, issue."
worktree-init
Creates a git worktree configured for Claude Code agents to work on a bd issue.
Workflow
When asked to spawn a worker or create a worktree for an issue:
Get issue details:
bd show <issue-id>Create branch name from issue type + title slug:
- bug →
fix/short-description - feature →
feat/short-description - task, chore, epic →
chore/short-description
Example: Issue "Add dark mode toggle" (feature) →
feat/dark-mode-toggle- bug →
Create worktree:
worktree-init feat/dark-mode-toggleOutput for user - provide the command to start the worker:
cd ../mentorfy-feat/dark-mode-toggle && claude "bd show mt-xyz && work on this issue"
What worktree-init creates
../<project>-<branch> with:
- Beads redirect (shared issue database)
- Symlinked
.mcp.json(MCP servers) - Symlinked
.claude/(settings & skills) - Copied
.env*files
Cleanup
bd worktree remove ../<worktree-path> --force