atlassian-usage

# Atlassian CLI Usage

This skill provides guidance for using the `atl` CLI tool to interact with Jira and Confluence.

## CRITICAL: Handling Atlassian URLs

**NEVER attempt to fetch Atlassian URLs directly via web tools.** Atlassian Cloud requires authentication that web fetch tools cannot provide. Instead, extract identifiers from URLs and use the `atl` CLI.

### Jira URL Patterns

When a user provides a Jira URL, extract the relevant identifier and use `atl`:

| URL Pattern | Extract | Command |
|-------------|---------|---------|
| `https://*.atlassian.net/jira/software/projects/PROJ/boards/123` | `PROJ` | `atl jira search-jql "project = PROJ"` |
| `https://*.atlassian.net/jira/core/projects/PROJ/board` | `PROJ` | `atl jira search-jql "project = PROJ"` |

**Examples:**
- `https://example.atlassian.net/jira/software/projects/PROJ/boards/5` → `atl jira search-jql "project = PROJ"`

### Confluence URL Patterns

When a user provides a Confluence URL, extract the page ID and use `atl`:

| URL Pattern | Extract | Command |
|-------------|---------|---------|
| `https://*.atlassian.net/wiki/spaces/SPACE/pages/123456789/Page+Title` | `123456789` | `atl confluence get-page 123456789` |
| `https://*.atlassian.net/wiki/spaces/SPACE/overview` | `SPACE` | `atl confluence get-pages-in-space SPACE` |

**Examples:**
- `https://example.atlassian.net/wiki/spaces/ENG/pages/987654321/Architecture` → `atl confluence get-page 987654321`
- `https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789` → `atl confluence get-page 123456789`

### URL Recognition Rules

1. Any URL containing `.atlassian.net` should trigger this skill
2. NEVER use WebFetch or similar tools on Atlassian URLs
3. Extract the identifier (issue key or page ID) from the URL
4. Use the appropriate `atl` command to retrieve the content

## Overview

The `atl` CLI provides direct access to Jira and Confluence through their REST APIs. Use it for searching, reading, creating, and updating content in Atlassian produ