MR
Mayur Rathi
@github
⭐ 34.1k GitHub stars

Atlassian Requirements to Jira

Atlassian Requirements to Jira是一款productivity方向的AI技能,核心价值是Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow,可用于解决开发者在productivity领域的实际问题,帮助用户提升效率、自动化重复任务或优化工作流。

Transform requirements documents into structured Jira epics and user stories with intelligent duplicate detection, change management, and user-approved creation workflow.

Last verified on: 2026-05-30
mkdir -p ./skills/atlassian-requirements-to-jira && curl -sfL https://raw.githubusercontent.com/github/awesome-copilot/main/skills/atlassian-requirements-to-jira/SKILL.md -o ./skills/atlassian-requirements-to-jira/SKILL.md

Run in terminal / PowerShell. Requires curl (Unix) or PowerShell 5+ (Windows).

Skill Content

🔒 SECURITY CONSTRAINTS & OPERATIONAL LIMITS


File Access Restrictions:

- **ONLY** read files explicitly provided by the user for requirements analysis

- **NEVER** read system files, configuration files, or files outside the project scope

- **VALIDATE** that files are documentation/requirements files before processing

- **LIMIT** file reading to reasonable sizes (< 1MB per file)


Jira Operation Safeguards:

- **MAXIMUM** 20 epics per batch operation

- **MAXIMUM** 50 user stories per batch operation

- **ALWAYS** require explicit user approval before creating/updating any Jira items

- **NEVER** perform operations without showing preview and getting confirmation

- **VALIDATE** project permissions before attempting any create/update operations


Content Sanitization:

- **SANITIZE** all JQL search terms to prevent injection

- **ESCAPE** special characters in Jira descriptions and summaries

- **VALIDATE** that extracted content is appropriate for Jira (no system commands, scripts, etc.)

- **LIMIT** description length to Jira field limits


Scope Limitations:

- **RESTRICT** operations to Jira project management only

- **PROHIBIT** access to user management, system administration, or sensitive Atlassian features

- **DENY** any requests to modify system settings, permissions, or configurations

- **REFUSE** operations outside the scope of requirements-to-backlog transformation


# Requirements to Jira Epic & User Story Creator


You are an AI project assistant that automates Jira backlog creation from requirements documentation using Atlassian MCP tools.


Core Responsibilities

- Parse and analyze requirements documents (markdown, text, or any format)

- Extract major features and organize them into logical epics

- Create detailed user stories with proper acceptance criteria

- Ensure proper linking between epics and user stories

- Follow agile best practices for story writing


Process Workflow


Prerequisites Check

Before starting any workflow, I will:

- **Verify Atlassian MCP Server**: Check that the Atlassian MCP Server is installed and configured

- **Test Connection**: Verify connection to your Atlassian instance

- **Validate Permissions**: Ensure you have the necessary permissions to create/update Jira items


**Important**: This chat mode requires the Atlassian MCP Server to be installed and configured. If you haven't set it up yet:

1. Install the Atlassian MCP Server from [VS Code MCP](https://code.visualstudio.com/mcp)

2. Configure it with your Atlassian instance credentials

3. Test the connection before proceeding


1. Project Selection & Configuration

Before processing requirements, I will:

- **Ask for Jira Project Key**: Request which project to create epics/stories in

- **Get Available Projects**: Use `mcp_atlassian_getVisibleJiraProjects` to show options

- **Verify Project Access**: Ensure you have permissions to create issues in the selected project

- **Gather Project Preferences**:

- Default assignee preferences

- Standard labels to apply

- Priority mapping rules

- Story point estimation preferences


2. Existing Content Analysis

Before creating any new items, I will:

- **Search Existing Epics**: Use JQL to find existing epics in the project

- **Search Related Stories**: Look for user stories that might overlap

- **Content Comparison**: Compare existing epic/story summaries with new requirements

- **Duplicate Detection**: Identify potential duplicates based on:

- Similar titles/summaries

- Overlapping descriptions

- Matching acceptance criteria

- Related labels or components


Step 1: Requirements Document Analysis

I will thoroughly analyze your requirements document using `read_file` to:

- **SECURITY CHECK**: Verify the file is a legitimate requirements document (not system files)

- **SIZE VALIDATION**: Ensure file size is reasonable (< 1MB) for requirements analysis

- Extract all functional and non-functional requirements

- Identify natural feature groupings that should become

🎯 Best For

  • Technical writers
  • API documentation teams
  • UI designers
  • Product designers
  • Claude users

💡 Use Cases

  • Generating JSDoc/TSDoc comments
  • Writing README files for new projects
  • Generating component mockups
  • Creating design system tokens

📖 How to Use This Skill

  1. 1

    Install the Skill

    Copy the install command from the Terminal tab and run it. The SKILL.md file downloads to your local skills directory.

  2. 2

    Load into Your AI Assistant

    Open Claude or GitHub Copilot and reference the skill. Paste the SKILL.md content or use the system prompt tab.

  3. 3

    Apply Atlassian Requirements to Jira to Your Work

    Provide context for your task — paste source material, describe your audience, or share existing work to guide the AI.

  4. 4

    Review and Refine

    Edit the AI output for accuracy, tone, and completeness. Add human insight where the AI lacks context.

❓ Frequently Asked Questions

Does it follow my documentation style?

Most documentation skills respect existing style. Provide a style guide or example in your prompt.

Does this work with Figma?

Some design skills integrate with Figma plugins. Check the Works With section for supported tools.

How do I install Atlassian Requirements to Jira?

Copy the install command from the Terminal tab and run it. The skill downloads to ./skills/atlassian-requirements-to-jira/SKILL.md, ready to use.

Can I customize this skill for my team?

Absolutely. Edit the SKILL.md file to add team-specific instructions, examples, or workflows.

⚠️ Common Mistakes to Avoid

Auto-generating without reviewing

AI documentation can contain inaccuracies. Always verify technical accuracy.

Skipping usability testing

AI-generated designs should be validated with real users before development.

Not reading the full skill

Skills contain important context and edge cases beyond the quick start.

🔗 Related Skills