--- name: atlassian description: Interact with Jira and Confluence via REST API - search, create, update issues and pages --- # Atlassian Skill Access Jira and Confluence directly via REST APIs. This skill provides full CRUD operations for issues and pages without requiring the MCP server. ## Authentication Requires environment variables in `.env`: - `ATLASSIAN_SITE` - Your Atlassian site (e.g., `yourcompany.atlassian.net`) - `ATLASSIAN_EMAIL` - Your Atlassian account email - `ATLASSIAN_API_TOKEN` - API token from https:\/\/id.atlassian.com\/manage-profile\/security\/api-tokens ## Available Scripts ### Jira #### Search Issues ```bash npx tsx scripts\/jira-search.ts "" [maxResults] [nextPageToken] ``` Examples: - `npx tsx scripts\/jira-search.ts "assignee = currentUser() AND status != Done"` - `npx tsx scripts\/jira-search.ts "project = PROJ AND type = Bug" 50` - `npx tsx scripts\/jira-search.ts "project = PROJ" 50 "token..."` (pagination) See `docs\/jql-guide.md` for JQL syntax reference. #### Get Issue Details ```bash npx tsx scripts\/jira-get.ts ``` Example: `npx tsx scripts\/jira-get.ts PROJ-123` #### Create Issue ```bash npx tsx scripts\/jira-create.ts '' ``` Single issue: ```bash npx tsx scripts\/jira-create.ts '{"project": "PROJ", "type": "Story", "summary": "New feature", "description": "Details here"}' ``` Bulk create (array): ```bash npx tsx scripts\/jira-create.ts '[{"project": "PROJ", "type": "Bug", "summary": "Bug 1"}, {"project": "PROJ", "type": "Bug", "summary": "Bug 2"}]' ``` #### Update Issue ```bash npx tsx scripts\/jira-update.ts '' ``` Example: `npx tsx scripts\/jira-update.ts PROJ-123 '{"status": "In Progress", "assignee": "user@example.com"}'` #### Comments ```bash # Get comments npx tsx scripts\/jira-comment.ts get # Add comment npx tsx scripts\/jira-comment.ts add "" ``` ### Confluence #### Search Pages ```bash npx tsx scripts\/confluence-search.ts "" [maxResults] ``` Examples: - `npx tsx scripts\/confluence-search.ts "title ~ 'Roadmap'"` - `npx tsx scripts\/confluence-search.ts "space = DEV AND type = page" 25` See `docs\/cql-guide.md` for CQL syntax reference. #### Get Page Content ```bash npx tsx scripts\/confluence-get.ts # or by title npx tsx scripts\/confluence-get.ts --title "" --space ``` #### Create Page ```bash npx tsx scripts\/confluence-create.ts '' ``` Example: ```bash npx tsx scripts\/confluence-create.ts '{"space": "DEV", "title": "New Page", "body": "

Content here<\/p>"}' ``` Optional parent page: ```bash npx tsx scripts\/confluence-create.ts '{"space": "DEV", "title": "Child Page", "body": "

Content<\/p>", "parentId": "123456"}' ``` #### Update Page ```bash npx tsx scripts\/confluence-update.ts '' ``` Example: `npx tsx scripts\/confluence-update.ts 123456 '{"title": "Updated Title", "body": "

New content<\/p>"}'` ## Query Language References For generating correct queries: - **Jira**: Read `docs\/jql-guide.md` for JQL syntax, fields, operators, and functions - **Confluence**: Read `docs\/cql-guide.md` for CQL syntax and fields ## Common Workflows ### Find and update my open issues 1. Search: `npx tsx scripts\/jira-search.ts "assignee = currentUser() AND status != Done"` 2. Update: `npx tsx scripts\/jira-update.ts PROJ-123 '{"status": "Done"}'` ### Create issues from a list 1. Bulk create: `npx tsx scripts\/jira-create.ts '[{...}, {...}, {...}]'` ### Find and read documentation 1. Search: `npx tsx scripts\/confluence-search.ts "title ~ 'API Documentation'"` 2. Get content: `npx tsx scripts\/confluence-get.ts 123456` ### Create a new documentation page 1. Create: `npx tsx scripts\/confluence-create.ts '{"space": "DEV", "title": "API Guide", "body": "

API Guide<\/h1>
...<\/p>"}'`

API Guide<\/h1>...<\/p>"}'`

API Guide<\/h1>
...<\/p>"}'`