atlassian

# 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 "<JQL query>" [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 <issueKey> ``` Example: `npx tsx scripts/jira-get.ts PROJ-123` #### Create Issue ```bash npx tsx scripts/jira-create.ts '<JSON>' ``` 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 <issueKey> '<JSON updates>' ``` 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 <issueKey> get # Add comment npx tsx scripts/jira-comment.ts <issueKey> add "<comment text>" ``` ### Confluence #### Search Pages ```bash npx tsx scripts/confluence-search.ts "<CQL query>" [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 <pageId> # or by title npx tsx scripts/confluence-get.ts --title "<page title>" --space <spaceKey> ``` #### Create Page ```bash npx tsx scripts/confluence-create.ts '<JSON>' ``` Example: ```bash npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "New Page", "body": "<p>Content here</p>"}' ``` Optional parent page: ```bash npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "Child Page", "body": "<p>Content</p>", "parentId": "123456"}' ``` #### Update Page ```bash npx tsx scripts/confluence-update.ts <pageId> '<JSON updates>' ``` Example: `npx tsx scripts/confluence-update.ts 123456 '{"title": "Updated Title", "body": "<p>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": "<h1>API Guide</h1><p>...</p>"}'`