setup-new-work

Fetch Jira ticket details via Atlassian MCP and create a git worktree with a feature branch.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/shysssthanhtri/AI-tools --skill setup-new-work
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-new-work
Source: https://github.com/shysssthanhtri/AI-tools/tree/main/skills/setup-new-work
Command: npx skills add https://github.com/shysssthanhtri/AI-tools --skill setup-new-work

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When starting work on a Jira ticket, you need a clean, isolated workspace that won't interfere with other tasks. This skill fetches ticket details via Atlassian MCP to derive a branch slug and create a local story snapshot, then spins up a git worktree and a feature branch, and writes a ticket brief into the worktree.

Core Features & Use Cases

  • Fetch Jira issue details to derive a deterministic slug from the summary and to produce a local story snapshot.
  • Create an isolated git worktree at worktrees/<ticket-id>-<platform> and a feature branch named feature/<ticket-id>-<slug>-<platform>.
  • Write docs/<ticket-id>/<ticket-id>.md inside the worktree containing the summary, description, status, priority, type, people, labels, parent epic, and links for team visibility.

Quick Start

Provide a Jira ticket key and an optional platform name to initiate the worktree setup, generating the branch and local story file automatically.

Frequently Asked Questions about setup-new-work

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

FAQPage Schema
How do I create a git worktree for a Jira ticket automatically?

To create a git worktree for a Jira ticket, this skill fetches issue details via Atlassian MCP, derives a slug from the summary, and sets up an isolated worktree at ./worktrees/<ticket-id>-<platform> with a corresponding feature branch.

How do I name a feature branch based on a Jira ticket summary?

Naming a feature branch from a Jira ticket summary involves fetching the issue data and generating a deterministic slug. This skill creates a branch named feature/<ticket-id>-<slug>-<platform> while preserving the original ticket key casing.

Do I need Atlassian MCP to set up isolated git worktrees for Jira issues?

Yes, Atlassian MCP is required to fetch Jira issue details like the summary and metadata. This information is necessary to derive the branch slug and generate the local story snapshot inside the git worktree.

Can I generate a local story snapshot from a Jira ticket for my team?

Generating a local story snapshot from a Jira ticket writes a markdown brief at docs/<ticket-id>/<ticket-id>.md inside the worktree. This file includes the summary, status, priority, people, and parent epic for team visibility.

What is the best way to isolate development work for multiple Jira tickets?

Using git worktrees is an effective way to isolate development work for multiple Jira tickets. This approach creates separate directories for each task, preventing branch interference while automatically fetching ticket details and setting up feature branches.

Why does my worktree setup require a Jira ticket key?

A Jira ticket key is strictly enforced because it forms the foundation of the worktree directory name and the feature branch. Without a valid ticket key, the automated branch slug generation and local story snapshot creation cannot proceed accurately.