A Claude Code skill for working with Atlassian products (Jira, Confluence) via the command line using the acli tool.
This skill provides comprehensive guidance for using the Atlassian CLI (acli) effectively, including:
- Authentication management - Always check auth first
- Correct command structure - Modern syntax patterns
- Batch operations - JQL queries, filters, and bulk updates
- Output formats - CSV, JSON, and web options
- Bulk creation - Efficient multi-issue workflows
- Common patterns - Sprint reports, status updates, project management
Copy the skill to your Claude skills directory:
mkdir -p ~/.claude/skills/atlassian-cli
cp SKILL.md ~/.claude/skills/atlassian-cli/The skill will be automatically available in your next Claude Code session.
You need the Atlassian CLI (acli) tool installed. Install it following the official documentation.
# Verify installation
acli --versionWithout this skill, Claude agents commonly make these mistakes:
- ❌ Skip authentication checks (commands fail)
- ❌ Use old syntax with
--actionflag (doesn't work) - ❌ Use wrong flags (
--outputFormatvs--csv,--columnsvs--fields) - ❌ Don't know about bulk features (
create-bulk,--from-json) - ❌ Suggest inefficient bash loops instead of built-in commands
- ❌ Use wrong entity names
With this skill, Claude will:
- ✅ Always check authentication first
- ✅ Use correct modern syntax:
acli <product> <entity> <action> - ✅ Leverage batch operations with JQL
- ✅ Use proper output formats
- ✅ Recommend built-in bulk features
- ✅ Follow efficient patterns
The skill covers common workflows like:
# 1. Check auth
acli auth status
# 2. Search sprint issues with CSV output
acli jira workitem search \
--jql "project = TEAM AND sprint = 42" \
--fields "key,summary,status,assignee" \
--csv > sprint-report.csv# 1. Check auth
acli auth status
# 2. Transition all matching issues
acli jira workitem transition \
--jql "project = MOBILE AND status = 'In Review'" \
--status "Done" \
--yes# 1. Check auth
acli auth status
# 2. Generate template
acli jira workitem create --generate-json > template.json
# 3. Create from template
acli jira workitem create --from-json issue1.jsonThe skill enforces checking authentication before any operation, preventing command failures.
Clear documentation of the modern command format:
acli <product> <entity> <action> [flags]
- Jira entities and actions
- Confluence entities and actions
- Common JQL patterns
- Output format options
- Batch operation flags
Flowcharts showing:
- Authentication check workflow
- General command execution pattern
Catches common mistakes before they happen:
- Skipping auth check
- Using old
--actionsyntax - Writing bash loops for bulk operations
- Wrong flags and parameters
This skill was created following Test-Driven Development (TDD) principles for documentation:
- Tested agents WITHOUT the skill
- Documented 7 types of baseline failures
- Captured exact rationalizations
- Wrote skill addressing specific failures
- Verified agents follow guidance correctly
- All baseline failures resolved
- Tested for new issues
- No loopholes found
- Skill complete and bulletproof
See the /docs directory for detailed testing documentation.
Contributions are welcome! If you find issues or have suggestions:
- Test the change following TDD principles
- Document any new baseline failures
- Update the skill to address them
- Verify improvements
- Submit a pull request
MIT License - feel free to use and modify as needed.
Created by Jakob He
- Initial release
- Covers Jira and Confluence operations
- Authentication workflow
- Batch operations guide
- Bulk creation features
- Comprehensive examples