ihkreddy 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:
- ✅ Fetches ticket details from Jira
- ✅ Creates branch with naming convention:
feature/{ticket-key}-{short-description} - ✅ Pushes branch to origin
- ✅ 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:
- ✅ Gets ticket summary from Jira
- ✅ Creates PR with title:
[FB-1] Ticket summary - ✅ Adds Jira link and description to PR body
- ✅ 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
| Issue Type | Branch Prefix | Example |
|---|---|---|
| Task/Story | feature/ |
feature/fb-1-add-meal-selection |
| Bug | bugfix/ |
bugfix/fb-2-fix-booking-error |
| Hotfix | hotfix/ |
hotfix/fb-3-critical-payment-fix |
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:
- Extract ticket ID from the request (e.g., "FB-1", "SAM1-123")
- Fetch ticket details using Atlassian MCP:
mcp_atlassian_atl_getJiraIssue - Create branch with proper naming convention
- Push to origin to make it available
- 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
| Option | Description | Default |
|---|---|---|
--ticket |
Jira ticket key (required) | - |
--no-push |
Create branch without pushing | false |
--no-transition |
Don't update Jira status | false |
create-pr.ts
| Option | Description | Default |
|---|---|---|
--ticket |
Jira ticket key (required) | - |
--base |
Target branch | main |
--draft |
Create as draft PR | true |
--no-draft |
Create as ready for review | false |
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