Atlassian Skill

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

1. Environment Setup 1.1. Required Environment Variables ATLASSIAN_SITE=https://your-instance.atlassian.net ATLASSIAN_EMAIL=your-email@example.com ATLASSIAN_API_TOKEN=your-api-token

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

Classic tokens work with both acli and REST API scripts.

1. Jira Operations (acli) 2.1. Authentication

Check status

acli jira auth status

Login (if needed)

acli jira auth login

2.2. Work Items

View issue

acli jira workitem view

Search issues (JQL)

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

Create issue

acli jira workitem create --project --type Task --summary "Title"

Transition issue

acli jira workitem transition --transition "Done"

Add comment

acli jira workitem comment add --body "Comment text"

2.3. Boards and Sprints

List boards

acli jira board list

List sprints

acli jira sprint list --board

2.4. Common JQL Patterns

Recently updated (last 7 days)

updated >= -7d AND assignee = currentUser()

In progress issues

status = "In Progress" AND project =

Created this week

created >= startOfWeek() AND project =

2.5. Date Range Search

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:

Function Description startOfDay() Today 00:00 startOfWeek() This week's Monday -1d, -7d Relative days 'YYYY-MM-DD' Specific date 3. Confluence Operations (Script) 3.1. Convert Page to Markdown uvx --with requests --with beautifulsoup4 --with html2text \ python ~/ghq/github.com/i9wa4/dotfiles/config/claude/skills/atlassian/scripts/confluence-to-md.py

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

3.2. URL Format https://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