{"id":"dbb47f70-4c4e-43b5-96d8-4e31dbd39000","shortId":"TBwrtm","kind":"skill","title":"create-jira-item","tagline":"Create Jira issues (stories, epics, initiatives) with custom field introspection to fill org-specific fields correctly. Use when the user asks to create a Jira ticket, story, epic, initiative, or task.","description":"# Create Jira Item\n\nCreate Jira issues using the Atlassian MCP, with proper custom field handling.\n\n## 1. Determine Target\n\n- **Project**: Use the project specified by the user. If not specified, infer by searching the user's recent issues (`searchJiraIssuesUsingJql` with `(assignee = currentUser() OR reporter = currentUser()) ORDER BY updated DESC`). If inference fails, ask.\n- **Issue type**: story, epic, task, initiative, etc. Infer from context or ask.\n\n## 2. Introspect Custom Fields\n\nBefore creating the issue, discover the project's field requirements:\n\n1. Get available issue types via `getJiraProjectIssueTypesMetadata(cloudId, projectIdOrKey)`.\n2. Get field metadata for the chosen issue type via `getJiraIssueTypeMetaWithFields(cloudId, projectIdOrKey, issueTypeId)`.\n\n3. Pay attention to:\n   - **Required fields** that are not standard (e.g., \"Team\", \"Quarter\", \"Initiative Link\", \"Sprint\")\n   - **Custom field IDs** (`customfield_NNNNN`) -- use these in the create call\n   - **Allowed values** for select/multi-select fields\n\nFor **epics and initiatives** especially, org-specific fields are common and must be populated. Do not rely on default field assumptions.\n\n## 3. Create the Issue\n\nUse `createJiraIssue` with:\n- **Summary**: terse, descriptive title\n- **Description**: terse. Bullet points preferred. No boilerplate.\n- **Assignee**: current user (use `lookupJiraAccountId` if needed)\n- **Priority**: Medium unless user specifies otherwise\n- All required custom fields populated from step 2\n\n## 4. Link to Epic (if applicable)\n\nIf the issue should be under an epic:\n- Use `createIssueLink` or set the epic link field (varies by Jira config)\n- If the user mentions an epic by name or key, search for it first via `searchJiraIssuesUsingJql(cloudId, \"project = X AND issuetype = Epic AND summary ~ 'name'\")`.\n\n## 5. Report\n\nReturn the issue key and URL. If any required fields were unknown or couldn't be populated, note them.","tags":["create","jira","item","skill","issue","paultyng","agent-skills","ai-tools","claude-code","cursor","dotfiles"],"capabilities":["skill","source-paultyng","skill-create-jira-item","topic-agent-skills","topic-ai-tools","topic-claude-code","topic-cursor","topic-dotfiles"],"categories":["skill-issue"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/paultyng/skill-issue/create-jira-item","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add paultyng/skill-issue","source_repo":"https://github.com/paultyng/skill-issue","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (1,945 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:09:00.442Z","embedding":null,"createdAt":"2026-05-18T13:21:25.232Z","updatedAt":"2026-05-18T19:09:00.442Z","lastSeenAt":"2026-05-18T19:09:00.442Z","tsv":"'1':52,115 '2':101,124,230 '3':138,192 '4':231 '5':282 'allow':165 'applic':236 'ask':26,88,100 'assigne':76,210 'assumpt':191 'atlassian':45 'attent':140 'avail':117 'boilerpl':209 'bullet':205 'call':164 'chosen':130 'cloudid':122,135,273 'common':180 'config':256 'context':98 'correct':21 'couldn':297 'creat':2,5,28,37,40,106,163,193 'create-jira-item':1 'createissuelink':246 'createjiraissu':197 'current':211 'currentus':77,80 'custom':12,49,103,154,225 'customfield':157 'default':189 'desc':84 'descript':201,203 'determin':53 'discov':109 'e.g':148 'epic':9,33,92,171,234,244,250,262,278 'especi':174 'etc':95 'fail':87 'field':13,20,50,104,113,126,143,155,169,178,190,226,252,293 'fill':16 'first':270 'get':116,125 'getjiraissuetypemetawithfield':134 'getjiraprojectissuetypesmetadata':121 'handl':51 'id':156 'infer':66,86,96 'initi':10,34,94,151,173 'introspect':14,102 'issu':7,42,73,89,108,118,131,195,239,286 'issuetyp':277 'issuetypeid':137 'item':4,39 'jira':3,6,30,38,41,255 'key':266,287 'link':152,232,251 'lookupjiraaccountid':214 'mcp':46 'medium':218 'mention':260 'metadata':127 'must':182 'name':264,281 'need':216 'nnnnn':158 'note':301 'order':81 'org':18,176 'org-specif':17,175 'otherwis':222 'pay':139 'point':206 'popul':184,227,300 'prefer':207 'prioriti':217 'project':55,58,111,274 'projectidorkey':123,136 'proper':48 'quarter':150 'recent':72 'reli':187 'report':79,283 'requir':114,142,224,292 'return':284 'search':68,267 'searchjiraissuesusingjql':74,272 'select/multi-select':168 'set':248 'skill' 'skill-create-jira-item' 'source-paultyng' 'specif':19,177 'specifi':59,65,221 'sprint':153 'standard':147 'step':229 'stori':8,32,91 'summari':199,280 'target':54 'task':36,93 'team':149 'ters':200,204 'ticket':31 'titl':202 'topic-agent-skills' 'topic-ai-tools' 'topic-claude-code' 'topic-cursor' 'topic-dotfiles' 'type':90,119,132 'unknown':295 'unless':219 'updat':83 'url':289 'use':22,43,56,159,196,213,245 'user':25,62,70,212,220,259 'valu':166 'vari':253 'via':120,133,271 'x':275","prices":[{"id":"e386110b-a2ee-41a1-9b84-d66df791ab9a","listingId":"dbb47f70-4c4e-43b5-96d8-4e31dbd39000","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"paultyng","category":"skill-issue","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:25.232Z"}],"sources":[{"listingId":"dbb47f70-4c4e-43b5-96d8-4e31dbd39000","source":"github","sourceId":"paultyng/skill-issue/create-jira-item","sourceUrl":"https://github.com/paultyng/skill-issue/tree/main/skills/create-jira-item","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:25.232Z","lastSeenAt":"2026-05-18T19:09:00.442Z"}],"details":{"listingId":"dbb47f70-4c4e-43b5-96d8-4e31dbd39000","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"paultyng","slug":"create-jira-item","github":{"repo":"paultyng/skill-issue","stars":8,"topics":["agent-skills","ai-tools","claude-code","cursor","dotfiles"],"license":"mit","html_url":"https://github.com/paultyng/skill-issue","pushed_at":"2026-05-18T18:26:54Z","description":"Personal Claude Code / Cursor agent skills, rules, and config","skill_md_sha":"1f56ca411b1acad87973bd21dda791ce5c15320d","skill_md_path":"skills/create-jira-item/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/paultyng/skill-issue/tree/main/skills/create-jira-item"},"layout":"multi","source":"github","category":"skill-issue","frontmatter":{"name":"create-jira-item","description":"Create Jira issues (stories, epics, initiatives) with custom field introspection to fill org-specific fields correctly. Use when the user asks to create a Jira ticket, story, epic, initiative, or task."},"skills_sh_url":"https://skills.sh/paultyng/skill-issue/create-jira-item"},"updatedAt":"2026-05-18T19:09:00.442Z"}}