JIRA Backlog Summary Skill

Overview

Fetch and analyze top backlog tickets from a JIRA project using the Atlassian MCP Server or Atlassian CLI (acli), providing AI-powered sprint planning summaries with actionable recommendations.

Note: Prefer using the Atlassian MCP Server tools when available. The MCP server provides direct API integration without requiring CLI installation.

When to Use

Use this skill when:

• Preparing for sprint planning and need backlog analysis
• Summarizing top N tickets from a project backlog
• Identifying themes, patterns, or groupings in upcoming work
• Generating sprint scope recommendations based on team velocity

Do NOT use this skill for:

• Searching for specific tickets (use jira-search instead)
• Creating new tickets (use jira-create instead)
• Updating existing tickets (use jira-update instead)

Quick Reference

MCP Server (Preferred)

Fetch Backlog Tickets:

atlassian:searchJiraIssues
  jql: "project = KEY AND status IN ('To Do', 'Backlog') ORDER BY rank ASC"
  maxResults: 10

Get Issue Details:

atlassian:getJiraIssue
  issueKey: "KEY-123"

CLI Fallback

Fetch Backlog Tickets:

acli jira workitem search \
  --jql "project = KEY AND status IN ('To Do', 'Backlog') ORDER BY rank ASC" \
  --limit 10 \
  --fields "key,summary,description,issuetype,priority,status,labels,assignee" \
  --json

Step-by-Step Process

1. Check for MCP Server Availability

First, check if the Atlassian MCP Server is available by looking for these tools:

• atlassian:searchJiraIssues - Search for backlog issues using JQL
• atlassian:getJiraIssue - Get detailed issue information

If MCP tools are available, prefer using them over the CLI approach.

2. Gather Configuration

Collect from user:

• Project key (e.g., "PROJ", "ENG", "PLAT")
• Number of tickets to analyze (default: 10, max: 25)
• Optional filters: epic, component, or label

3. Build JQL Query

Base query:

project = KEY AND status IN ("To Do", "Backlog") ORDER BY rank ASC

Add filters if specified:

• Epic: AND "Epic Link" = EPIC-123
• Component: AND component = "ComponentName"
• Label: AND labels = "label-name"

4. Fetch Backlog Tickets

Use the appropriate MCP tool or CLI command based on availability.

MCP Example:

atlassian:searchJiraIssues with:
  jql: "project = PROJ AND status IN ('To Do', 'Backlog') ORDER BY rank ASC"
  maxResults: 10

CLI Example:

acli jira workitem search \
  --jql "project = PROJ AND status IN ('To Do', 'Backlog') ORDER BY rank ASC" \
  --limit 10 \
  --fields "key,summary,description,issuetype,priority,status,labels,assignee" \
  --json

5. Parse and Analyze

Extract for each ticket:

• Key, Summary, Issue type, Priority
• Story points (if available)
• Labels, Assignee, Epic link
• Description (first 500 chars)

6. Generate AI Analysis

Provide structured analysis covering:

A. Executive Summary

• Overall theme of upcoming work
• Key focus areas (e.g., "5 tickets focused on authentication")
• Notable patterns or concerns

B. Ticket Groupings

• Group by epic, component, or detected theme
• Show breakdown by category
• Identify related work to tackle together

C. Complexity Distribution

• Story point distribution
• Estimated total effort
• Balance of ticket types (Stories vs. Bugs vs. Tasks)

D. Priority Analysis

• High-priority items requiring immediate attention
• Dependencies between tickets
• Potential blockers

E. Sprint Recommendations

• Suggested ticket groupings for sprint
• Tickets that pair well together
• Large tickets that should be broken down
• Quick wins vs. complex work

7. Format Output

# Sprint Planning Summary - [PROJECT] Backlog

## Executive Summary
[1-2 paragraphs describing overall state and focus areas]

## Ticket Breakdown (N tickets analyzed)

### By Theme
- **Authentication & Security** (4 tickets, 21 points)
  - PROJ-101: Implement JWT authentication (8 pts)
  - PROJ-102: Add password reset flow (5 pts)

### By Priority
- **High**: 3 tickets (15 points)
- **Medium**: 5 tickets (19 points)

### By Type
- Stories: 7 (34 points)
- Bugs: 2 (5 points)

## Sprint Recommendations

### Suggested Sprint Scope (if 20-point sprint)
1. PROJ-101 (8 pts) - Critical auth work
2. PROJ-102 (5 pts) - Builds on PROJ-101
3. PROJ-201 (5 pts) - Independent work
4. PROJ-305 (2 pts) - Quick win

**Total**: 20 points

### Consider for Next Sprint
- PROJ-203 (8 pts) - Needs design discussion
- PROJ-401 (13 pts) - Should be broken down

### Risks & Blockers
- PROJ-101 blocked by security review
- PROJ-305 has no clear acceptance criteria

## Detailed Tickets
[List of all tickets with key details]

Common Mistakes

Advanced CLI Usage

With Epic Filter

acli jira workitem search \
  --jql "project = PROJ AND status = 'To Do' AND 'Epic Link' = EPIC-123 ORDER BY rank ASC" \
  --limit 10 --json

With Component Filter

acli jira workitem search \
  --jql "project = PROJ AND status = 'To Do' AND component = 'Backend' ORDER BY rank ASC" \
  --limit 10 --json

Multi-Project

acli jira workitem search \
  --jql "project IN (PROJ1, PROJ2) AND status = 'To Do' ORDER BY rank ASC" \
  --limit 20 --json

Analysis Guidelines

Identify Themes

Look for patterns in:

• Ticket summaries (common keywords)
• Labels and components
• Epic groupings
• Related functionality

Assess Complexity

Complex work indicators:

• High story point estimates
• Vague or incomplete descriptions
• Multiple dependencies
• Mentions of "research", "spike", "investigation"

Spot Quick Wins

Quick win indicators:

• Low story points (1-2)
• Clear acceptance criteria
• Labels like "good-first-issue", "polish"
• Bug fixes with known root cause

Flag Risks

Watch for:

• Blockers or dependencies
• Incomplete descriptions
• Missing acceptance criteria
• Work spanning multiple systems

Troubleshooting

• No story points: Analyze based on title complexity, description length, priority
• Empty backlog: Check status values for this project
• Custom fields: Story points field ID varies by instance (typically customfield_10016)

MCP Server Integration

Available Tools

The Atlassian MCP Server provides these JIRA analysis tools:

• atlassian:searchJiraIssues - Search for backlog issues using JQL

  • Parameters: jql (string), maxResults (number, default 50)
  • Returns: Array of issue objects with key, summary, status, assignee, description, etc.
  • Use this to fetch backlog tickets for analysis

• atlassian:getJiraIssue - Get detailed issue information

  • Parameters: issueKey (string)
  • Returns: Full issue details including custom fields, story points, epic links
  • Use this to get additional details for specific tickets

MCP vs CLI Usage

Use MCP Server when:

• Available in the environment
• Need structured JSON responses for analysis
• Want consistent field formats
• Prefer direct API integration

Use CLI when:

• MCP server is not configured
• Need specific field selection (custom fields)
• Working with custom acli configurations
• Performing complex JQL with custom field IDs

Example MCP Workflow

Fetch and analyze backlog:

1. Use atlassian:searchJiraIssues with:
   jql: "project = PROJ AND status IN ('To Do', 'Backlog') ORDER BY rank ASC"
   maxResults: 10

2. For each issue in results:
   - Extract key, summary, type, priority, labels
   - Group by theme (detected from labels, summary keywords)
   - Calculate complexity based on description length, priority

3. Optionally use atlassian:getJiraIssue for issues needing more detail:
   issueKey: "PROJ-123"
   (to get story points, epic links, custom fields)

4. Generate sprint planning analysis with recommendations

Benefits of MCP approach:

• Single API call retrieves multiple issues
• Consistent field names across JIRA instances
• No need to specify field IDs for standard fields
• Easier to parse and analyze results programmatically