sanjay3290sanjay3290/atlassian-skill/SKILL.md

atlassian

Skill0 starsChanged 8 months agoApache-2.0View on GitHub

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).

Installs packages

5 other projects use a version of this.

Adopted by

Most recently taken up by

razbakov/skillstheir own version, first seen Oct 17, 2026
nordz0r/skillstheir own version, first seen Oct 15, 2026
andeeplus/aplustheir own version, first seen Oct 4, 2026
dbhq-uk/atlassian-skilltheir own version, first seen Sep 25, 2026
sanjay3290/ai-skillsword for word, first seen Jul 6, 2026

Other versions5 projects use a version of this.
Word for word · 1
sanjay3290/ai-skills★ 452100% same
Edited · 0
None found.
Wrote their own version · 4
nordz0r/skills★ 8same name
razbakov/skills★ 4same name
andeeplus/aplus★ 2same name
dbhq-uk/atlassian-skill★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 4 are distinctive, and 1 is very specific to this project.

0
Common
Most of the 4 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
No API tokens or instance URLs needed.
line 20
Distinctive:
Follow the prompts to enter your Atlassian URL, email, and API token.
line 43
Distinctive:
Create an API token at: https://id.atlassian.com/manage-profile/security/api-tokens
line 45
Distinctive:
All commands work identically regardless of backend.
line 63
Very specific:
Add --json flag to any script command for machine-readable output.
line 212

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

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).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free

Adopted by

Most recently taken up by

Word for word · 1

Edited · 0

Wrote their own version · 4

The file

5 rules. 0 are common, 4 are distinctive, and 1 is very specific to this project.

Atlassian (Jira + Confluence)

First-Time Setup

Option 1: OAuth 2.1 via MCP Server (Recommended)

Option 2: API Token (Fallback)

Backend Selection

Jira (scripts/jira.py)

Search issues with JQL

Get issue details

Create an issue

Update an issue

Transition issue status

Add and list comments

List projects and statuses

Test authentication

List available MCP tools (OAuth only)

Confluence (scripts/confluence.py)

Search pages

Read a page

List spaces

Get space details

List pages in a space

Create a page

Update a page

Get child pages

Test authentication

List available MCP tools (OAuth only)

Operations Reference

Jira

Confluence

JSON Output

Token Management

Does it work?

No reviews yet

Your trail

Now do this for your own.