jira-expert
Scannednpx machina-cli add skill alirezarezvani/claude-skills/jira-expert --openclawAtlassian Jira Expert
Master-level expertise in Jira configuration, project management, JQL, workflows, automation, and reporting. Handles all technical and operational aspects of Jira.
Core Competencies
Project Configuration
- Create and configure Jira projects (Scrum, Kanban, custom)
- Design and implement custom workflows
- Configure issue types, fields, and screens
- Set up project permissions and security schemes
JQL Mastery
- Write advanced JQL queries for any use case
- Create complex filters with multiple conditions
- Optimize query performance
- Build saved filters for team use
Automation & Integration
- Design Jira automation rules
- Configure webhooks and integrations
- Set up email notifications
- Integrate with external tools (Confluence, Slack, etc.)
Reporting & Dashboards
- Create custom dashboards with gadgets
- Build reports for sprint metrics, velocity, burndown
- Configure portfolio-level reporting
- Export data for executive reporting
Workflows
Project Creation
- Determine project type (Scrum, Kanban, Bug Tracking, etc.)
- Create project with appropriate template
- Configure project settings:
- Name, key, description
- Project lead and default assignee
- Notification scheme
- Permission scheme
- Set up issue types and workflows
- Configure custom fields if needed
- Create initial board/backlog view
- HANDOFF TO: Scrum Master for team onboarding
Workflow Design
- Map out process states (To Do → In Progress → Done)
- Define transitions and conditions
- Add validators, post-functions, and conditions
- Configure workflow scheme
- Associate workflow with project
- Test workflow with sample issues
- USE: References for complex workflow patterns
JQL Query Building
Basic Structure: field operator value
Common Operators:
=, !=: equals, not equals~, !~: contains, not contains>, <, >=, <=: comparisonin, not in: list membershipis empty, is not emptywas, was in, was notchanged
Powerful JQL Examples:
Find overdue issues:
dueDate < now() AND status != Done
Sprint burndown issues:
sprint = 23 AND status changed TO "Done" DURING (startOfSprint(), endOfSprint())
Find stale issues:
updated < -30d AND status != Done
Cross-project epic tracking:
"Epic Link" = PROJ-123 ORDER BY rank
Velocity calculation:
sprint in closedSprints() AND resolution = Done
Team capacity:
assignee in (user1, user2) AND sprint in openSprints()
Dashboard Creation
- Create new dashboard (personal or shared)
- Add relevant gadgets:
- Filter Results (JQL-based)
- Sprint Burndown
- Velocity Chart
- Created vs Resolved
- Pie Chart (status distribution)
- Arrange layout for readability
- Configure automatic refresh
- Share with appropriate teams
- HANDOFF TO: Senior PM or Scrum Master for use
Automation Rules
- Define trigger (issue created, field changed, scheduled)
- Add conditions (if applicable)
- Define actions:
- Update field
- Send notification
- Create subtask
- Transition issue
- Post comment
- Test automation with sample data
- Enable and monitor
- USE: References for complex automation patterns
Advanced Features
Custom Fields
When to Create:
- Track data not in standard fields
- Capture process-specific information
- Enable advanced reporting
Field Types:
- Text: Short text, paragraph
- Numeric: Number, decimal
- Date: Date picker, date-time
- Select: Single select, multi-select, cascading
- User: User picker, multi-user picker
Configuration:
- Create custom field
- Configure field context (which projects/issue types)
- Add to appropriate screens
- Update search templates if needed
Issue Linking
Link Types:
- Blocks / Is blocked by
- Relates to
- Duplicates / Is duplicated by
- Clones / Is cloned by
- Epic-Story relationship
Best Practices:
- Use Epic linking for feature grouping
- Use blocking links to show dependencies
- Document link reasons in comments
Permissions & Security
Permission Schemes:
- Browse Projects
- Create/Edit/Delete Issues
- Administer Projects
- Manage Sprints
Security Levels:
- Define confidential issue visibility
- Control access to sensitive data
- Audit security changes
Bulk Operations
Bulk Change:
- Use JQL to find target issues
- Select bulk change operation
- Choose fields to update
- Preview changes
- Execute and confirm
- Monitor background task
Bulk Transitions:
- Move multiple issues through workflow
- Useful for sprint cleanup
- Requires appropriate permissions
JQL Functions Reference
Date Functions:
startOfDay(),endOfDay()startOfWeek(),endOfWeek()startOfMonth(),endOfMonth()startOfYear(),endOfYear()
Sprint Functions:
openSprints()closedSprints()futureSprints()
User Functions:
currentUser()membersOf("group")
Advanced Functions:
issueHistory()linkedIssues()issuesWithFixVersions()
Reporting Templates
Sprint Report:
project = PROJ AND sprint = 23
Team Velocity:
assignee in (team) AND sprint in closedSprints() AND resolution = Done
Bug Trend:
type = Bug AND created >= -30d
Blocker Analysis:
priority = Blocker AND status != Done
Decision Framework
When to Escalate to Atlassian Admin:
- Need new project permission scheme
- Require custom workflow scheme across org
- User provisioning or deprovisioning
- License or billing questions
- System-wide configuration changes
When to Collaborate with Scrum Master:
- Sprint board configuration
- Backlog prioritization views
- Team-specific filters
- Sprint reporting needs
When to Collaborate with Senior PM:
- Portfolio-level reporting
- Cross-project dashboards
- Executive visibility needs
- Multi-project dependencies
Handoff Protocols
FROM Senior PM:
- Project structure requirements
- Workflow and field needs
- Reporting requirements
- Integration needs
TO Senior PM:
- Cross-project metrics
- Issue trends and patterns
- Workflow bottlenecks
- Data quality insights
FROM Scrum Master:
- Sprint board configuration requests
- Workflow optimization needs
- Backlog filtering requirements
- Velocity tracking setup
TO Scrum Master:
- Configured sprint boards
- Velocity reports
- Burndown charts
- Team capacity views
Best Practices
Data Quality:
- Enforce required fields
- Use field validation
- Regular cleanup of stale issues
- Consistent naming conventions
Performance:
- Optimize JQL queries
- Limit dashboard gadgets
- Use saved filters
- Archive old projects
Governance:
- Document workflow rationale
- Version control for schemes
- Change management for major updates
- Regular permission audits
Atlassian MCP Integration
Primary Tool: Jira MCP Server
Key Operations:
- Create and configure projects
- Execute JQL queries for data extraction
- Update issue fields and statuses
- Create and manage sprints
- Generate reports and dashboards
- Configure workflows and automation
- Manage boards and filters
Integration Points:
- Pull metrics for Senior PM reporting
- Configure sprint boards for Scrum Master
- Create documentation pages for Confluence Expert
- Support template creation for Template Creator
Source
git clone https://github.com/alirezarezvani/claude-skills/blob/main/project-management/jira-expert/SKILL.mdView on GitHub Overview
Master-level Jira configuration and administration, covering project setup, custom fields, and workflow design. It also handles advanced JQL queries, automation rules, and comprehensive dashboards and reporting to keep teams aligned and projects on track.
How This Skill Works
Leverages core competencies in Project Configuration, JQL Mastery, Automation & Integration, and Reporting & Dashboards. It guides from initial project creation through workflow mapping, field configuration, and testing, then builds dashboards and saved filters for team-wide use.
When to Use It
- Starting a new Jira project (Scrum, Kanban, or custom) and configuring templates, permissions, and screens.
- Writing advanced JQL to support sprint planning, filtering, and cross-project tracking.
- Designing and applying custom workflows with validators, post-functions, and conditions.
- Creating dashboards and reports for sprint metrics, velocity, burndown, and executive summaries.
- Automating routine tasks and integrating Jira with Confluence, Slack, or other tools.
Quick Start
- Step 1: Assess project needs and choose the appropriate Jira template (Scrum, Kanban, or custom).
- Step 2: Configure core settings: project details, issue types, custom fields, screens, and permissions; create workflows.
- Step 3: Build initial dashboard and JQL filters; set up automation and test with sample data.
Best Practices
- Define a standard project template and enforce consistent naming and defaults.
- Carefully plan permission schemes and security settings to avoid access issues.
- Start with simple JQL and saved filters, then optimize for performance and reuse.
- Use custom fields judiciously to enhance reporting without clutter.
- Test workflows and automations with sample data before production rollout.
Example Use Cases
- Kickoff a new Scrum project with tailored workflows, screens, and backlogs.
- Cross-project epic tracking and portfolio-level reporting for leadership.
- Dashboards displaying sprint velocity, burndown, and created vs resolved metrics.
- Automated notifications and integrations with Slack and Confluence.
- Advanced saved filters supporting product discovery and planning sessions.