---

name: atlassian description: | Atlassian (Jira/Confluence) operations using acli and REST API scripts. Use when:

• Working with Jira issues, boards, sprints
• Converting Confluence pages to Markdown
• Checking Jira authentication status
• Searching or viewing Jira work items

---

Atlassian Skill

Jira operations via acli, Confluence operations via REST API script.

1. Environment Setup

1.1. Required Environment Variables

CopyATLASSIAN_SITE=https://your-instance.atlassian.net
ATLASSIAN_EMAIL=your-email@example.com
ATLASSIAN_API_TOKEN=your-api-token

1.2. API Token Creation

1. Access https://id.atlassian.com/manage-profile/security/api-tokens
2. Click "Create API token"
3. Select "Create classic API token" (NOT scoped)

Classic tokens work with both acli and REST API scripts.

2. Jira Operations (acli)

2.1. Authentication

Copy# Check status
acli jira auth status

# Login (if needed)
acli jira auth login

2.2. Work Items

Copy# View issue
acli jira workitem view <ISSUE-KEY>

# Search issues (JQL)
acli jira workitem search --jql "assignee = currentUser() AND status = 'In Progress'"

# Create issue
acli jira workitem create --project <PROJECT> --type Task --summary "Title"

# Transition issue
acli jira workitem transition <ISSUE-KEY> --transition "Done"

# Add comment
acli jira workitem comment add <ISSUE-KEY> --body "Comment text"

2.3. Boards and Sprints

Copy# List boards
acli jira board list

# List sprints
acli jira sprint list --board <BOARD-ID>

2.4. Common JQL Patterns

Copy# Recently updated (last 7 days)
updated >= -7d AND assignee = currentUser()

# In progress issues
status = "In Progress" AND project = <PROJECT>

# Created this week
created >= startOfWeek() AND project = <PROJECT>

2.5. Date Range Search

Copy# Today's activities
acli jira workitem search \
    --jql "updated >= startOfDay() AND (assignee = currentUser() OR reporter = currentUser()) ORDER BY updated DESC" \
    --fields "key,summary,status"

# Specific date range (YYYY-MM-DD)
acli jira workitem search \
    --jql "updated >= '2026-01-20' AND updated < '2026-01-21' AND (assignee = currentUser() OR reporter = currentUser()) ORDER BY updated DESC" \
    --fields "key,summary,status"

# Relative days
acli jira workitem search \
    --jql "updated >= -7d AND assignee = currentUser() ORDER BY updated DESC" \
    --fields "key,summary,status"

JQL date functions:

3. Confluence Operations (Script)

3.1. Convert Page to Markdown

Copyuvx --with requests --with beautifulsoup4 --with html2text \
    python ~/ghq/github.com/i9wa4/dotfiles/config/claude/skills/atlassian/scripts/confluence-to-md.py <confluence_url>

Output: ~/Downloads/{timestamp}-confluence-{title}.md

3.2. URL Format

Copyhttps://your-instance.atlassian.net/wiki/spaces/SPACE/pages/123456789/Page+Title

3.3. Features

• Preserves bullet list structure
• Converts draw.io diagrams to full URL
• Maintains code blocks
• Aligns table columns