jira-writinglisted

Use when creating or editing Jira issues via the Atlassian MCP (createJiraIssue / editJiraIssue) — composing descriptions and acceptance criteria, bulk-editing or find-replacing across ticket bodies, or when a link must render as an inline smartlink chip (📄 card). Symptoms — "link shows as plain text not a chip", "chips survive a markdown round-trip" (they don't), <custom data-type="smartlink">, ADF vs markdown, renaming a field across ticket bodies, acceptance criteria / Given-When-Then AC table (AC No., Scenario, Given, When, Then/And).
atomgunlk/skills · ★ 0 · AI & Automation · score 68

Install: claude install-skill atomgunlk/skills

# Writing Jira issues (Atlassian MCP) ## Overview Two facts drive everything here: 1. `editJiraIssue` **replaces the entire description** — there is no append/patch. Always `getJiraIssue` first (someone may have edited it) and send the whole body back. 2. `contentFormat: "markdown"` authors prose, headings, bullets, tables, and code blocks fine — but it **cannot express ADF-only nodes**: smartlink chips (`inlineCard`), mentions, status lozenges, dates, emoji, media. Re-saving a body that contains any of them as markdown silently destroys them. ## Creating a new issue - `createJiraIssue` with `contentFormat: "markdown"` for plain content. Issue type names vary per project ("Story" vs localized or renamed types) — when unsure, confirm via `getJiraProjectIssueTypesMetadata` / `getJiraIssueTypeMetaWithFields` (also reveals required custom fields) instead of guessing `issueTypeName` and letting the create call fail. - Description shape: **Context → Acceptance criteria (AC table, see below) → Out of scope**. - Chip needed in a brand-new issue → author the whole doc as ADF (`contentFormat: "adf"`) from the start. ## Acceptance criteria — AC table (house style) Acceptance criteria in a description ARE a markdown table — **one row per AC, five columns**. Not "shall" clauses, not free-form bullets. If the source arrives as EARS, prose, or Gherkin `Scenario:` blocks, convert it into rows (a Gherkin `Scenario:` title maps straight onto the `Scenario` column). | AC No. | Scenario