---

name: manage-sprint description: This skill MUST be used when the user asks to "create sprint", "start sprint", "end sprint", "complete sprint", "close sprint", "new sprint", "begin sprint", "finish sprint", "update sprint", "rename sprint", or otherwise wants to create or change sprint state/details.

Manage Sprint

Create, start, complete, and update sprints.

Quick Start

Use the Python script at scripts/manage_sprint.py:

Copy# Create a new 2-week sprint
python scripts/manage_sprint.py PROJ --create "Sprint 24" --duration 14

# Create sprint with specific dates
python scripts/manage_sprint.py PROJ --create "Sprint 24" \
  --start-date 2024-02-01 --end-date 2024-02-14

# Start a sprint (future -> active)
python scripts/manage_sprint.py PROJ --start --sprint-id 123

# Start the next future sprint
python scripts/manage_sprint.py PROJ --start --next

# Complete/close a sprint (active -> closed)
python scripts/manage_sprint.py PROJ --complete

# Complete specific sprint
python scripts/manage_sprint.py PROJ --complete --sprint-id 123

Actions

Create Options

If only --duration is provided, sprint starts tomorrow.

Start/Complete Options

Update Options

Examples

Create and Start Sprint

Copy# Create sprint starting tomorrow for 2 weeks
python scripts/manage_sprint.py PROJ --create "Sprint 24" --goal "Complete auth module"

# Start it immediately
python scripts/manage_sprint.py PROJ --start --next

End Current Sprint

Copy# Complete the active sprint
python scripts/manage_sprint.py PROJ --complete

Update Sprint Details

Copy# Rename and extend sprint
python scripts/manage_sprint.py PROJ --update --sprint-id 123 \
  --name "Sprint 24 (Extended)" --end-date 2024-02-21

Output Example

Compact (default)

CopyCREATED|456|Sprint 24|future|2024-02-01|2024-02-14

CopySTARTED|456|Sprint 24|active

CopyCOMPLETED|456|Sprint 24|closed

Environment Setup

Requires three environment variables:

• JIRA_BASE_URL - e.g., https://yoursite.atlassian.net
• JIRA_EMAIL - Your Jira account email
• JIRA_API_TOKEN - API token from Atlassian account settings

Permissions

Requires "Manage Sprints" permission on the project's board.

Reference

For complete options and error handling, see references/options-reference.md.