Effortless Jira Editing with AI: Atlassian ADF Skill

Effortless Jira Editing with AI: Atlassian ADF Skill

This AI agent skill simplifies the process of editing Jira story descriptions using Atlassian MCP ADF (Atlassian Document Format). It enables users to fetch full Jira documents, edit them locally in files, validate changes, and then submit the entire document back to Jira. This skill is particularly useful for tasks such as creating or editing Jira stories with complex table structures or fixing typos in tickets.

What this skill does

• Fetch: It retrieves the full Jira story description using the `getJiraIssue` command with `responseContentFormat: "adf"` and the field `description`. The document is stored in a backup file.
• Edit: Users can then edit the description by copying the backup to a new file and modifying the specific text nodes intended for change, such as correcting typos.
• Validate and Submit: Both the `validate-adf.js` and `preflight-adf-edit.js` validators are run to ensure changes are correct before sending the complete document back to Jira using MCP `editJiraIssue`.

Who it is for

This skill is designed for developers and teams who utilize AI coding agents like Claude Code, Cursor, or Codex, and regularly work with Atlassian Jira for project management. It supports those managing complex requirements and acceptance criteria by providing a method to handle intricate document structures within Jira.

Use cases

• Creating Jira stories with structured content using tables and bullet points.
• Fixing typographical errors in Jira story descriptions without disrupting existing formatting.
• Maintaining consistency in Jira documentation by ensuring the entire document is validated before submission.

Technical details

The skill utilizes tools and capabilities such as agent-skills, aiapplication, and atlassian-jira-adf-formatting to accomplish its tasks. It ensures that all updates are comprehensive by requiring a round-trip edit: fetching the full document, making controlled changes, and validating before sending back to Jira. Understanding the difference between Markdown and ADF formatting is essential for users, particularly when working with structured document shapes like tables with bullet points.

Source & Licence

This package is built on open-source work published by lucavb (lucavb/skills) and distributed under MIT. The original licence text and copyright notice are included in your download.

Personal and commercial use, modification and redistribution are permitted, provided the original copyright and licence notice are retained.

Your purchase covers curation, licence verification, packaging, documentation and instant delivery. It does not grant exclusive rights to the underlying open-source code, which remains available under its original licence.

Delivery & Support

• Delivery: instant — a secure download link is emailed to you as soon as payment is confirmed.
• Format: ZIP archive containing the skill files, documentation and the original licence.
• Support: support@mcpcart.com — we aim to reply within 2 business days.
• Updates: updates are included only where stated on this page.

Refunds

This is a digital product delivered immediately after purchase. By completing your order you request immediate delivery and acknowledge that, once the download has been accessed, the statutory right to cancel no longer applies to the extent permitted by law. Refund requests are handled in accordance with our published Refund Policy.

Claude, Codex, Gemini and Cursor are trademarks of their respective owners. MCP Cart is an independent marketplace and is not affiliated with, endorsed by, or sponsored by any of them. Compatibility references describe interoperability only.