Atlassian CLI (acli) Skill

An agent skill that provides a complete reference for the Atlassian CLI (acli) — enabling AI agents to help you manage Jira Cloud work items, projects, boards, sprints, filters, Atlassian organization administration, and more from the command line.

Available on ClawHub.

What's Included

├── SKILL.md                                # Core guide: auth, command structure, common patterns
├── references/
│   ├── jira-workitem-commands.md            # 23 workitem commands (create, edit, search, transition, ...)
│   └── other-commands.md                    # Project, board, sprint, filter, dashboard, field, admin, rovodev
└── README.md

Covers 58 commands across all acli command groups with flags, descriptions, and usage examples.

Prerequisites

This skill does not bundle the acli binary. You need to:

1. Install acli — follow the official install guide
2. Authenticate — via OAuth, API token, or admin API key:

   # Interactive (browser-based)
   acli jira auth login --web
   
   # API token (non-interactive / CI)
   echo "$API_TOKEN" | acli jira auth login --site "yoursite.atlassian.net" --email "you@example.com" --token

3. Verify — acli jira auth status

Installation

The repo is structured so that it can be cloned directly into a skills directory. This layout is compatible with Claude Code, OpenCode, and GitHub Copilot.

Personal skill (all projects)

Clone into any of the supported personal skill directories:

# Works with Claude Code, OpenCode, and GitHub Copilot
git clone https://github.com/peetzweg/acli-skill.git ~/.claude/skills/acli

# OpenCode-specific alternative
git clone https://github.com/peetzweg/acli-skill.git ~/.config/opencode/skills/acli

# Copilot-specific alternative
git clone https://github.com/peetzweg/acli-skill.git ~/.copilot/skills/acli

To update: git -C ~/.claude/skills/acli pull

Project skill (single repository)

Clone or symlink into your project's skills directory:

git clone https://github.com/peetzweg/acli-skill.git .claude/skills/acli
# Add to .gitignore or commit as a subtree/submodule

Usage

Once installed, just ask your agent to perform Jira operations naturally:

• "Create a bug in project TEAM about the login timeout"
• "Search for all in-progress issues assigned to me"
• "Transition KEY-123 to Done"
• "List all sprints on board 42"
• "Bulk assign these issues to user@company.com"

The agent will use the skill's reference to construct the right acli commands.

Security Notes

• The skill references environment variables $API_TOKEN and $API_KEY for non-interactive authentication. These are optional — interactive OAuth (--web) is recommended for normal use.
• Destructive commands (delete, deactivate, archive) include warnings in the reference docs. The agent is instructed to always confirm with you before running them.
• Never paste API tokens directly into chat. Use environment variables or file-based input.

Reference

• Atlassian CLI official docs
• acli command reference