Claude Skill

atlassian

Manage Jira issues and Confluence wiki pages in Atlassian Cloud. Use when: (1) searching/creating/updating Jira issues with JQL, (2) searching/reading/creating Confluence pages with CQL, (3) managing Jira workflows, transitions, and comments, (4) browsing Confluence spaces and pa

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Download sanjay3290-ai-skills-skills_atlassian-c842558.zip · 26 KB

Install

skills CLI npx skills add https://github.com/sanjay3290/ai-skills/tree/main/skills/atlassian
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sanjay3290-ai-skills@llmmart
Git git clone https://github.com/sanjay3290/ai-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole sanjay3290/ai-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Atlassian (Jira + Confluence)

Full Jira and Confluence integration with two authentication methods:

  • OAuth 2.1 via Atlassian MCP server — browser-based consent, auto-refresh tokens, calls MCP tools
  • API token — email + token stored in keyring, calls REST API directly

First-Time Setup

Option 1: OAuth 2.1 via MCP Server (Recommended)

No API tokens or instance URLs needed. Uses dynamic client registration and PKCE.

pip install -r requirements.txt
python scripts/auth.py login --oauth

A browser opens for Atlassian authorization. Select which products (Jira, Confluence, Compass) to grant access. Tokens are stored in the system keyring and auto-refresh when expired.

Check status:

python scripts/auth.py status

Option 2: API Token (Fallback)

For environments where browser-based OAuth isn't available.

pip install -r requirements.txt
python scripts/auth.py login

Follow the prompts to enter your Atlassian URL, email, and API token. Credentials are stored securely in the system keyring.

Create an API token at: https://id.atlassian.com/manage-profile/security/api-tokens

Check authentication status:

python scripts/auth.py status

Logout (clears both OAuth and API token credentials):

python scripts/auth.py logout

Backend Selection

The scripts automatically detect which backend to use based on your auth type:

  • OAuth → MCP backend (calls Atlassian MCP server tools)
  • API token → REST backend (calls Atlassian REST API directly)

All commands work identically regardless of backend.

Jira (scripts/jira.py)

Search issues with JQL

python scripts/jira.py search "project = DEV AND status = Open"
python scripts/jira.py search "assignee = currentUser() ORDER BY updated DESC" --limit 10

Get issue details

python scripts/jira.py get DEV-123

Create an issue

python scripts/jira.py create --project DEV --summary "Fix login bug" --type Bug
python scripts/jira.py create --project DEV --summary "New feature" --type Story \
  --description "Details here" --priority High --assignee "user@example.com" --labels "backend,urgent"

Update an issue

python scripts/jira.py update DEV-123 --summary "Updated summary" --priority High
python scripts/jira.py update DEV-123 --assignee "user@example.com"

Transition issue status

python scripts/jira.py transition DEV-123 "In Progress"
python scripts/jira.py transition DEV-123 "Done"

Add and list comments

python scripts/jira.py comment DEV-123 --add "This is a comment"
python scripts/jira.py comment DEV-123 --list

List projects and statuses

python scripts/jira.py list-projects
python scripts/jira.py list-statuses DEV

Test authentication

python scripts/jira.py auth-info

List available MCP tools (OAuth only)

python scripts/jira.py list-tools

Confluence (scripts/confluence.py)

Search pages

python scripts/confluence.py search "deployment guide"
python scripts/confluence.py search "type=page AND space=DEV AND text~\"deployment\""
python scripts/confluence.py search "onboarding" --limit 10

Read a page

python scripts/confluence.py read <page-id>
python scripts/confluence.py read <page-id> --json

List spaces

python scripts/confluence.py list-spaces
python scripts/confluence.py list-spaces --limit 50

Get space details

python scripts/confluence.py get-space <space-id>

List pages in a space

python scripts/confluence.py list-pages --space-id <space-id>

Create a page

python scripts/confluence.py create --title "New Page" --space-id <space-id>
python scripts/confluence.py create --title "Guide" --space-id <id> --body "<p>Content here</p>"
python scripts/confluence.py create --title "Child" --space-id <id> --parent-id <parent-id>

Update a page

python scripts/confluence.py update <page-id> --title "Updated Title"
python scripts/confluence.py update <page-id> --body "<p>New content</p>"

Get child pages

python scripts/confluence.py get-children <page-id>

Test authentication

python scripts/confluence.py auth-info

List available MCP tools (OAuth only)

python scripts/confluence.py list-tools

Operations Reference

Jira

Command Description Required Args
search Search issues with JQL jql
get Get issue details issue_key
create Create new issue --project, --summary, --type
update Update existing issue issue_key
transition Change issue status issue_key, status
comment Add or list comments issue_key
list-projects List accessible projects -
list-statuses List statuses for project project_key
auth-info Test API connection -
list-tools List MCP tools (OAuth only) -

Confluence

Command Description Required Args
search Search using CQL query
read Get page content page_id
list-spaces List all spaces -
get-space Get space details space_id
list-pages List pages in a space --space-id
create Create new page --title, --space-id
update Update existing page page_id
get-children Get child pages page_id
auth-info Test API connection -
list-tools List MCP tools (OAuth only) -

JSON Output

Add --json flag to any script command for machine-readable output.

Token Management

Credentials stored securely using the system keyring:

  • macOS: Keychain
  • Windows: Windows Credential Locker
  • Linux: Secret Service API

Service name: atlassian-skill

OAuth tokens auto-refresh when expired (if refresh token is available).

Files (ai-skills)
  • scripts
    • api_client.py 5.4 KB
      Loading…
    • auth.py 23.2 KB
      Loading…
    • confluence.py 26.9 KB
      Loading…
    • jira.py 32.1 KB
      Loading…
    • mcp_client.py 10.3 KB
      Loading…
  • .env.example 688 B · in bundle
  • requirements.txt 51 B
    Loading…
  • SKILL.md 6.2 KB
    ---
    name: atlassian
    description: |
      Manage Jira issues and Confluence wiki pages in Atlassian Cloud.
      Use when: (1) searching/creating/updating Jira issues with JQL, (2) searching/reading/creating Confluence pages
      with CQL, (3) managing Jira workflows, transitions, and comments, (4) browsing Confluence spaces and page
      hierarchies. Supports OAuth 2.1 via MCP server (recommended) or API token authentication (fallback).
    ---
    
    # Atlassian (Jira + Confluence)
    
    Full Jira and Confluence integration with two authentication methods:
    - **OAuth 2.1** via Atlassian MCP server — browser-based consent, auto-refresh tokens, calls MCP tools
    - **API token** — email + token stored in keyring, calls REST API directly
    
    ## First-Time Setup
    
    ### Option 1: OAuth 2.1 via MCP Server (Recommended)
    
    No API tokens or instance URLs needed. Uses dynamic client registration and PKCE.
    
    ```bash
    pip install -r requirements.txt
    python scripts/auth.py login --oauth
    ```
    
    A browser opens for Atlassian authorization. Select which products (Jira, Confluence, Compass) to grant access. Tokens are stored in the system keyring and auto-refresh when expired.
    
    Check status:
    ```bash
    python scripts/auth.py status
    ```
    
    ### Option 2: API Token (Fallback)
    
    For environments where browser-based OAuth isn't available.
    
    ```bash
    pip install -r requirements.txt
    python scripts/auth.py login
    ```
    
    Follow the prompts to enter your Atlassian URL, email, and API token. Credentials are stored securely in the system keyring.
    
    Create an API token at: https://id.atlassian.com/manage-profile/security/api-tokens
    
    Check authentication status:
    ```bash
    python scripts/auth.py status
    ```
    
    Logout (clears both OAuth and API token credentials):
    ```bash
    python scripts/auth.py logout
    ```
    
    ## Backend Selection
    
    The scripts automatically detect which backend to use based on your auth type:
    - **OAuth** → MCP backend (calls Atlassian MCP server tools)
    - **API token** → REST backend (calls Atlassian REST API directly)
    
    All commands work identically regardless of backend.
    
    ## Jira (scripts/jira.py)
    
    ### Search issues with JQL
    ```bash
    python scripts/jira.py search "project = DEV AND status = Open"
    python scripts/jira.py search "assignee = currentUser() ORDER BY updated DESC" --limit 10
    ```
    
    ### Get issue details
    ```bash
    python scripts/jira.py get DEV-123
    ```
    
    ### Create an issue
    ```bash
    python scripts/jira.py create --project DEV --summary "Fix login bug" --type Bug
    python scripts/jira.py create --project DEV --summary "New feature" --type Story \
      --description "Details here" --priority High --assignee "user@example.com" --labels "backend,urgent"
    ```
    
    ### Update an issue
    ```bash
    python scripts/jira.py update DEV-123 --summary "Updated summary" --priority High
    python scripts/jira.py update DEV-123 --assignee "user@example.com"
    ```
    
    ### Transition issue status
    ```bash
    python scripts/jira.py transition DEV-123 "In Progress"
    python scripts/jira.py transition DEV-123 "Done"
    ```
    
    ### Add and list comments
    ```bash
    python scripts/jira.py comment DEV-123 --add "This is a comment"
    python scripts/jira.py comment DEV-123 --list
    ```
    
    ### List projects and statuses
    ```bash
    python scripts/jira.py list-projects
    python scripts/jira.py list-statuses DEV
    ```
    
    ### Test authentication
    ```bash
    python scripts/jira.py auth-info
    ```
    
    ### List available MCP tools (OAuth only)
    ```bash
    python scripts/jira.py list-tools
    ```
    
    ## Confluence (scripts/confluence.py)
    
    ### Search pages
    ```bash
    python scripts/confluence.py search "deployment guide"
    python scripts/confluence.py search "type=page AND space=DEV AND text~\"deployment\""
    python scripts/confluence.py search "onboarding" --limit 10
    ```
    
    ### Read a page
    ```bash
    python scripts/confluence.py read <page-id>
    python scripts/confluence.py read <page-id> --json
    ```
    
    ### List spaces
    ```bash
    python scripts/confluence.py list-spaces
    python scripts/confluence.py list-spaces --limit 50
    ```
    
    ### Get space details
    ```bash
    python scripts/confluence.py get-space <space-id>
    ```
    
    ### List pages in a space
    ```bash
    python scripts/confluence.py list-pages --space-id <space-id>
    ```
    
    ### Create a page
    ```bash
    python scripts/confluence.py create --title "New Page" --space-id <space-id>
    python scripts/confluence.py create --title "Guide" --space-id <id> --body "<p>Content here</p>"
    python scripts/confluence.py create --title "Child" --space-id <id> --parent-id <parent-id>
    ```
    
    ### Update a page
    ```bash
    python scripts/confluence.py update <page-id> --title "Updated Title"
    python scripts/confluence.py update <page-id> --body "<p>New content</p>"
    ```
    
    ### Get child pages
    ```bash
    python scripts/confluence.py get-children <page-id>
    ```
    
    ### Test authentication
    ```bash
    python scripts/confluence.py auth-info
    ```
    
    ### List available MCP tools (OAuth only)
    ```bash
    python scripts/confluence.py list-tools
    ```
    
    ## Operations Reference
    
    ### Jira
    
    | Command | Description | Required Args |
    |---------|-------------|---------------|
    | search | Search issues with JQL | jql |
    | get | Get issue details | issue_key |
    | create | Create new issue | --project, --summary, --type |
    | update | Update existing issue | issue_key |
    | transition | Change issue status | issue_key, status |
    | comment | Add or list comments | issue_key |
    | list-projects | List accessible projects | - |
    | list-statuses | List statuses for project | project_key |
    | auth-info | Test API connection | - |
    | list-tools | List MCP tools (OAuth only) | - |
    
    ### Confluence
    
    | Command | Description | Required Args |
    |---------|-------------|---------------|
    | search | Search using CQL | query |
    | read | Get page content | page_id |
    | list-spaces | List all spaces | - |
    | get-space | Get space details | space_id |
    | list-pages | List pages in a space | --space-id |
    | create | Create new page | --title, --space-id |
    | update | Update existing page | page_id |
    | get-children | Get child pages | page_id |
    | auth-info | Test API connection | - |
    | list-tools | List MCP tools (OAuth only) | - |
    
    ## JSON Output
    
    Add `--json` flag to any script command for machine-readable output.
    
    ## Token Management
    
    Credentials stored securely using the system keyring:
    - **macOS**: Keychain
    - **Windows**: Windows Credential Locker
    - **Linux**: Secret Service API
    
    Service name: `atlassian-skill`
    
    OAuth tokens auto-refresh when expired (if refresh token is available).
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.