atlassian-attachments

What problem does it solves?

Manually attaching files to Jira issues or Confluence pages is repetitive, and embedding them correctly via API can be complex, especially with specific formatting requirements. This Skill automates the process of uploading and embedding documents, screenshots, and other media.

Core Features & Use Cases

• Authentication Setup: Guidance on configuring Atlassian API tokens and environment variables for secure access.
• Jira REST API: Commands and Python examples for uploading single or multiple attachments to Jira issues.
• Confluence REST API: Commands and Python examples for uploading attachments and critically, embedding them correctly into page content using Markdown or Storage Format.
• QA Screenshot Mapping: Specific patterns and scripts for mapping local QA screenshot structures to Confluence attachment names for better organization.
• Error Handling & Best Practices: Advice on common errors, handling large files, and naming conventions for various attachment types.
• Use Case: Uploading QA test evidence to a Jira bug, embedding an architecture diagram into a Confluence page, automating batch uploads of release assets, or fixing broken image references in existing Confluence pages.

Quick Start

Use the atlassian-attachments skill to generate a Python script to upload a screenshot named bug-report.png to Jira issue PROJ-123.