Atlassian Skill Skill | Agent Skills

Atlassian Skill

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

See frontmatter schema: ~/ghq/github.com/i9wa4/internal/docs/schema/frontmatter-schema.md

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.

2. Jira Operations (acli)

2.1. Authentication

# Check status
nix run nixpkgs#acli -- jira auth status

# Login (if needed)
nix run nixpkgs#acli -- jira auth login

2.2. Work Items

# View issue
nix run nixpkgs#acli -- jira workitem view <ISSUE-KEY>

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

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

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

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

2.3. Boards and Sprints

# List boards
nix run nixpkgs#acli -- jira board list

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

2.4. Common JQL Patterns

# 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

# Today's activities
nix run nixpkgs#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)
nix run nixpkgs#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
nix run nixpkgs#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/agents/skills/atlassian/scripts/confluence-to-md.py <confluence_url>

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

Agent Skills: Atlassian Skill

Install this agent skill to your local

Skill Files