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

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

npx tsx scripts/jira-get.ts <issueKey>

Example: npx tsx scripts/jira-get.ts PROJ-123

Create Issue

npx tsx scripts/jira-create.ts '<JSON>'

Single issue:

npx tsx scripts/jira-create.ts '{"project": "PROJ", "type": "Story", "summary": "New feature", "description": "Details here"}'

Bulk create (array):

npx tsx scripts/jira-create.ts '[{"project": "PROJ", "type": "Bug", "summary": "Bug 1"}, {"project": "PROJ", "type": "Bug", "summary": "Bug 2"}]'

Update Issue

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

# 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

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

npx tsx scripts/confluence-get.ts <pageId>
# or by title
npx tsx scripts/confluence-get.ts --title "<page title>" --space <spaceKey>

Create Page

npx tsx scripts/confluence-create.ts '<JSON>'

Example:

npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "New Page", "body": "<p>Content here</p>"}'

Optional parent page:

npx tsx scripts/confluence-create.ts '{"space": "DEV", "title": "Child Page", "body": "<p>Content</p>", "parentId": "123456"}'

Update Page

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>"}'