Branch and PR Skill

When to Use This Skill

Use this skill when:

• Creating a git branch from a Jira ticket
• Opening a Pull Request to main/master branch
• Users mention “create branch for FB-1”, “open PR”, “submit for review”
• Automating the full workflow: branch → code → PR

Prerequisites

1. GitHub CLI

brew install gh
gh auth login

2. Atlassian MCP Server

Ensure .vscode/mcp.json is configured with Atlassian MCP.

Workflow Commands

Create Branch from Jira Ticket

# Creates a properly named branch from Jira ticket
node --loader ts-node/esm .github/skills/skills/branch-and-pr/scripts/create-branch.ts --ticket FB-1

What it does:

1. ✅ Fetches ticket details from Jira
2. ✅ Creates branch with naming convention: feature/{ticket-key}-{short-description}
3. ✅ Pushes branch to origin
4. ✅ Transitions ticket to “In Progress” (optional)

Create Pull Request

# Creates a draft PR from current branch to main
node --loader ts-node/esm .github/skills/skills/branch-and-pr/scripts/create-pr.ts --ticket FB-1

What it does:

1. ✅ Gets ticket summary from Jira
2. ✅ Creates PR with title: [FB-1] Ticket summary
3. ✅ Adds Jira link and description to PR body
4. ✅ Opens as draft PR for review

Full Workflow (Branch + PR)

# Creates branch, then PR when ready
node --loader ts-node/esm .github/skills/skills/branch-and-pr/scripts/full-workflow.ts --ticket FB-1

Branch Naming Conventions

PR Template

The generated PR includes:

• Link to Jira ticket
• Description from ticket
• Checklist for review
• Auto-draft status

Agent Instructions

When the user asks to create a branch or PR:

1. Extract ticket ID from the request (e.g., “FB-1”, “SAM1-123”)
2. Fetch ticket details using Atlassian MCP: mcp_atlassian_atl_getJiraIssue
3. Create branch with proper naming convention
4. Push to origin to make it available
5. Create PR when user is ready for review

Example Prompts

User: “Create a branch for FB-1” → Run create-branch.ts --ticket FB-1

User: “Open a PR for this ticket to main” → Run create-pr.ts --ticket FB-1

User: “I’m done with FB-1, create a PR” → Commit changes, then run create-pr.ts --ticket FB-1

Script Options

create-branch.ts

create-pr.ts

Error Handling

• If branch already exists: Switch to existing branch
• If PR already exists: Show existing PR URL
• If GitHub CLI not installed: Show installation instructions
• If ticket not found: Show error with suggestions