This skill should be used when the user asks to "search jira", "find tickets", "look up an issue", "search confluence", "find pages", "read a document", "create a ticket", "update an issue", "add a comment", mentions JQL, CQL, Atlassian, Jira issues, Confluence pages, or provides an Atlassian URL (*.atlassian.net). Provides guidance for using the atl CLI to interact with Atlassian products.
View on GitHubplugins/atlassian-cli/skills/atlassian-usage/SKILL.md
January 24, 2026
Select agents to install to:
npx add-skill https://github.com/dhughes/claude-marketplace/blob/main/plugins/atlassian-cli/skills/atlassian-usage/SKILL.md -a claude-code --skill atlassian-usageInstallation paths:
.claude/skills/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