atlassian

# Atlassian API Skill

Work with Confluence pages and Jira issues using Python scripts and the uv package manager.

## Prerequisites

**Required:**
- uv package manager installed
- Environment variables set:
  - `ATLASSIAN_USER_EMAIL` - Your Atlassian account email
  - `ATLASSIAN_API_TOKEN` - API token from https://id.atlassian.com/manage/api-tokens
  - `JIRA_URL` - Your Atlassian instance URL (e.g., https://your-domain.atlassian.net)

**Execution pattern:**
```bash
uv run --no-project --with requests python scripts/script_name.py [args]
```

## Available Scripts

### Confluence Operations

**Read page to markdown:**
```bash
uv run --no-project --with requests python scripts/confluence_api.py read <page_id> -o output.md
```

**Update page from file (requires `-f`):**
```bash
# From markdown file
uv run --no-project --with requests python scripts/confluence_api.py update <page_id> -f input.md

# From marimo HTML export (auto-detected, requires lxml)
uv run --no-project --with requests --with lxml python scripts/confluence_api.py update <page_id> -f notebook.html
```

Note: `.html` files are auto-detected and delegated to `marimo_converter.py` for conversion.

**Update with new title:**
```bash
uv run --no-project --with requests python scripts/confluence_api.py update <page_id> -f input.md -t "New Title"
```

**Get page tree (descendants):**
```bash
# All descendants
uv run --no-project --with requests python scripts/confluence_api.py tree <page_id>

# Direct children only
uv run --no-project --with requests python scripts/confluence_api.py tree <page_id> -d root

# Save to JSON file
uv run --no-project --with requests python scripts/confluence_api.py tree <page_id> -o tree.json
```

**Create new page:**
```bash
# Create empty page under parent page or folder
uv run --no-project --with requests python scripts/confluence_api.py create <parent_id> -t "Page Title"

# Create page with content from markdown file
uv run --no-project --with requests python scripts/confluenc