atlassian-usage_skill

Overview

This skill provides concise, practical guidance for using the atl CLI to interact with Atlassian Cloud (Jira and Confluence). It explains how to safely handle Atlassian URLs, extract identifying values, and run the appropriate atl commands to search, read, create, or update content. Follow these steps to avoid unauthenticated web fetches and use the authenticated CLI instead.

How this skill works

When given an Atlassian URL, the skill extracts the relevant identifier (Jira project or issue key, Confluence page ID or space key) and maps it to the correct atl command. It never attempts to fetch content via generic web tools; instead it recommends atl commands for JQL/CQL searches, issue/page read, create, update, comments, transitions, and navigation. It also points to atl --help and product-level help for discovering additional commands.

When to use it

• User provides any URL containing .atlassian.net
• User asks to search Jira, find tickets, or run JQL
• User asks to search Confluence, find pages, or run CQL
• User asks to read, create, update, or comment on Jira issues
• User asks to read, create, update, or comment on Confluence pages

Best practices

• Never use web fetch tools on Atlassian Cloud URLs; extract identifiers and use atl instead
• Use atl --help and atl <product> --help to discover current commands and flags
• Prefer --json output for machine-readable results and pipe to jq for extraction
• Verify authentication with atl meta user-info and run atl auth if needed
• When given a full URL, extract project keys for Jira and numeric page IDs or space keys for Confluence

Example use cases

• Given a Jira board URL, extract the project key and run: atl jira search-jql "project = PROJ"
• Given a Confluence page URL, extract the numeric page ID and run: atl confluence get-page 123456789
• Search recent tickets assigned to you: atl jira search-jql "assignee = currentUser() AND created >= -7d"
• Create a new task: atl jira create-issue --project PROJ --type Task --summary "Task name" --description "Details"
• Find pages in a space: atl confluence get-pages-in-space TEAM or search-cql "space = TEAM AND type = page"