atlassian-attachments

Attach files to Jira issues and Confluence pages via the Atlassian REST API.

14|1|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/jpoutrin/product-forge --skill atlassian-attachments
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atlassian-attachments
Source: https://github.com/jpoutrin/product-forge/tree/main/plugins/atlassian-integration/skills/atlassian-attachments
Command: npx skills add https://github.com/jpoutrin/product-forge --skill atlassian-attachments

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about atlassian-attachments

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate uploading attachments to Jira issues via API?

Automate Jira attachments using the Atlassian REST API with multipart/form-data uploads. You need domain, email, and API token credentials. The Skill provides Python scripts and commands to upload single or multiple files directly to Jira issues without manual attachment steps.

Can I embed files into Confluence pages programmatically?

Yes, embed attachments into Confluence pages via the REST API using Markdown or Storage Format. The Skill handles the correct formatting requirements and CSRF bypass headers needed to attach and embed documents, screenshots, and media directly into page content.

What's the best way to organize QA test evidence in Jira and Confluence?

Map local QA screenshot structures to Confluence attachment names using the patterns and scripts provided. This Skill automates batch uploads of test evidence to Jira bugs while organizing and embedding screenshots into Confluence pages for centralized documentation.

Do I need special authentication to use the Atlassian API for attachments?

Set up Atlassian API tokens and configure environment variables with your domain, email, and token for secure access. The Skill includes authentication guidance and handles the required headers and credentials for both Jira and Confluence endpoints.

How do I handle large files or fix broken image references in Confluence?

The Skill provides error handling best practices for large file uploads, naming conventions for attachment types, and automation patterns to fix broken image references in existing Confluence pages via the REST API.

Can I batch upload release assets to both Jira and Confluence at once?

Yes, automate batch uploads of release assets to Jira issues and Confluence pages using the provided Python examples and commands. The Skill supports multiple attachments and coordinates uploads across both Atlassian products in a single workflow.