💼 ビジネスコミュニティ

atlassian-rest

JiraやConfluenceに関する様々な操作、例えば課題の作成・編集・検索、Confluenceページの読み書き、ステータスレポートの作成などをREST APIを通じて行い、プロジェクト管理を支援するSkill。

📜 元の英語説明(参考)

Interact with Atlassian Jira and Confluence using REST APIs — no MCP server needed. Use this skill whenever the user mentions Jira, Confluence, Atlassian, tickets, issues, sprints, backlogs, epics, stories, or any project management task that involves creating/editing/searching/transitioning Jira issues, writing or reading Confluence pages, generating status reports, triaging bugs, converting specs to backlogs, capturing tasks from meeting notes, searching company knowledge, syncing local BMAD documents with Jira or Confluence, pushing docs to Jira, pulling from Jira, linking documents to tickets, downloading Confluence spaces to local markdown, or converting between Confluence storage format and markdown. Also trigger when the user says things like "move that ticket to done", "what's the status of PROJ-123", "create a bug for X", "search our wiki for Y", "file a ticket", "check for duplicates", "write a status update", "break this spec into stories", "sync this doc", "push to jira", "pull from jira", "sync to confluence", "link this to jira", "sync my epics", "download confluence pages", "sync confluence space", "convert confluence to markdown", or "pull docs from confluence". If there is even a chance the user wants to interact with Jira or Confluence, use this skill.

🇯🇵 日本人クリエイター向け解説

一言でいうと

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o atlassian-rest.zip https://jpskill.com/download/23713.zip && unzip -o atlassian-rest.zip && rm atlassian-rest.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/23713.zip -OutFile "$d\atlassian-rest.zip"; Expand-Archive "$d\atlassian-rest.zip" -DestinationPath $d -Force; ri "$d\atlassian-rest.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して atlassian-rest.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → atlassian-rest フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 24

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Atlassian REST API スキル

REST API を介したポータブルな Jira & Confluence 連携です。Node.js 18+ が動作するあらゆるエージェント環境で機能します — 依存関係はゼロで、MCP サーバーは不要です。

初回セットアップ

このドキュメント全体で <skill-path> は、このスキルがインストールされているディレクトリを指します。スキル呼び出しコンテキスト (例: claude plugin list で表示されるパス、または .claude/plugins/ 内のスキルのディレクトリ) から解決してください。

いずれの操作を行う前にも、ユーザーが認証情報を設定していることを確認してください。以下を実行します。

node <skill-path>/scripts/setup.mjs

失敗した場合は、ユーザーにセットアップを案内してください — スクリプトは段階的な指示を出力します。

必須環境変数

変数	説明	例
`ATLASSIAN_API_TOKEN`	API トークン	(Atlassian で生成)
`ATLASSIAN_EMAIL`	アカウントメール	`user@company.com`
`ATLASSIAN_DOMAIN`	Atlassian サイトドメイン	`company.atlassian.net`

このスキルの使い方

ユーザーが Jira または Confluence で何かをするように求めてきた場合は、以下の原則に従ってください。

まず曖昧さを解消します。 ユーザーが「チケットを作成して」と言ったがプロジェクトを指定していない場合は、node <skill-path>/scripts/jira.mjs projects を実行して利用可能なプロジェクトをリストアップし、どれにするか尋ねてください。課題タイプについても同様です — 不明な場合は node <skill-path>/scripts/jira.mjs issue-types <projectKey> を実行してください。
変更前に確認します。 課題の作成、チケットのトランジション、Confluence ページの公開を行う前に、何を行おうとしているのかをユーザーに示し、確認を得てください。読み取り操作 (検索、取得、リスト) は確認を必要としません。
決して削除しません。 このスキルは削除操作 (課題、ページ、添付ファイル、ボード、プロジェクト、アカウントなど) をサポートしていません。ユーザーが何かを削除するように求めてきた場合は、Atlassian ウェブ UI に誘導してください。この制限は意図的なものであり、迂回してはなりません。
操作を自然に構成します。 多くのユーザーリクエストは複数のスクリプト呼び出しを必要とします。例えば、「PROJ-123 を Sarah にアサインして」というリクエストは、(a) lookup-user "Sarah" でアカウント ID を取得し、次に (b) edit PROJ-123 --assignee <accountId> を実行する必要があります。
ドキュメントベースの操作には sync.mjs を優先します。 ローカルの Markdown ファイル (ストーリー文書、仕様書、エピック) から Jira 課題を作成する場合は、生の jira.mjs create ではなく sync.mjs を使用してください — フィールドマッピング、リンクトラッキング、同期状態を自動的に処理します。詳細については、以下の「ドキュメント同期操作」セクションを参照してください。ローカルドキュメントに裏付けられていないアドホックな課題にのみ jira.mjs create を使用してください。
複雑なタスクにはワークフローを使用します。 ユーザーのリクエストが以下のワークフローのいずれかに合致する場合は、対応するファイルを読み、その段階的なプロセスに従ってください。
必要に応じて参照ドキュメントを読みます。 JQL/CQL クエリを作成する前に references/query-languages.md を参照してください。チケットを作成する前に references/ticket-writing-guide.md を参照してください。参照ドキュメントは高品質な出力を生成するのに役立ちます — それらを活用してください。

スクリプトに長いコンテンツを渡す

約 200 文字を超える、または特殊文字 (バッククォート、引用符、$、改行) を含む説明、コメント、またはページ本文については、コンテンツを一時ファイルに書き込み、ファイルベースのフラグを使用してください。

インラインフラグ	ファイルフラグ	コマンド
`--description "text"`	`--description-file /tmp/desc.md`	jira create, jira edit
`<body>` (位置指定)	`--body-file /tmp/body.md`	jira comment, confluence comment
`--body "text"`	`--body-file /tmp/body.md`	confluence create-page, update-page
`--comment "text"`	`--comment-file /tmp/comment.md`	jira worklog

ファイルにはプレーンな Markdown を書き込んでください — スクリプトが ADF (Jira) またはストレージ形式 (Confluence) への変換を自動的に処理します。シェルエスケープの問題を避けるため、ファイルベースの入力を優先してください。

Jira 操作

スクリプト: node <skill-path>/scripts/jira.mjs <command> [args]

課題の検索

jira.mjs search 'project = PROJ AND status = "In Progress"' --max 20

課題の詳細を取得

jira.mjs get PROJ-123
jira.mjs get PROJ-123 --fields summary,status,assignee

課題の作成

jira.mjs create --project PROJ --type Task --summary "Implement feature X" \
  --description "Details here" --priority High --assignee <accountId> \
  --labels "backend,urgent" --components "API,Auth"
jira.mjs create --project PROJ --type Story --summary "User login" --parent PROJ-100
# 長い説明にはファイルを使用します:
jira.mjs create --project PROJ --type Task --summary "Feature X" \
  --description-file /tmp/desc.md --priority High

エピックの下に子ストーリーを作成する場合、ユーザーが異なる優先度を指定しない限り、--priority Medium を含めてください。

課題の編集

jira.mjs edit PROJ-123 --summary "Updated title" --priority Medium
jira.mjs edit PROJ-123 --labels "backend,v2" --components "API"
# 長い説明にはファイルを使用します:
jira.mjs edit PROJ-123 --description-file /tmp/desc.md

jira.mjs comment PROJ-123 "Fixed in PR #456"
# 長いコメントにはファイルを使用します:
jira.mjs comment PROJ-123 --body-file /tmp/comment.md

トランジション (チケットステータスの移動)

jira.mjs transitions PROJ-123          # まず利用可能なトランジションをリストアップします
jira.mjs transition PROJ-123 31        # 次に ID でトランジションします

常に最初にトランジションをリストアップして正しい ID を取得してください — 推測しないでください。

プロジェクトと課題タイプ

jira.mjs projects                      # すべての表示可能なプロジェクトをリストアップします
jira.mjs issue-types PROJ              # プロジェクトの課題タイプをリストアップします

課題リンク

jira.mjs link-types                    # まず利用可能なリンクタイプをリストアップします
jira.mjs link PROJ-1 PROJ-2 --type "relates to"

ユーザー検索

jira.mjs lookup-user "john"            # --assignee に必要なアカウント ID を返します

作業ログ

jira.mjs worklog PROJ-123 --time 2h --comment "Code review"

ドキュメント同期操作

スクリプト: node <skill-path>/scripts/sync.mjs <command> [args]

ローカルの Markdown から Jira/Confluence アイテムを作成する場合

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Atlassian REST API Skill

Portable Jira & Confluence integration via REST APIs. Works in any agent environment with Node.js 18+ — zero dependencies, no MCP server required.

First-Use Setup

<skill-path> throughout this document refers to the directory where this skill is installed. Resolve it from the skill invocation context (e.g., the path shown by claude plugin list or the skill's directory in .claude/plugins/).

Before any operation, verify the user has credentials configured. Run:

node <skill-path>/scripts/setup.mjs

If it fails, guide the user through the setup — the script prints step-by-step instructions.

Required Environment Variables

Variable	Description	Example
`ATLASSIAN_API_TOKEN`	API token	(generated at Atlassian)
`ATLASSIAN_EMAIL`	Account email	`user@company.com`
`ATLASSIAN_DOMAIN`	Atlassian site domain	`company.atlassian.net`

How to Use This Skill

When the user asks you to do something with Jira or Confluence, follow these principles:

Resolve ambiguity first. If the user says "create a ticket" but hasn't specified a project, run node <skill-path>/scripts/jira.mjs projects to list available projects, then ask which one. Same for issue types — run node <skill-path>/scripts/jira.mjs issue-types <projectKey> if unsure.
Confirm before mutating. Before creating issues, transitioning tickets, or publishing Confluence pages, show the user what you're about to do and get confirmation. Read operations (search, get, list) don't need confirmation.
Never delete. This skill does not support delete operations (issues, pages, attachments, boards, projects, accounts, etc.). If the user asks to delete something, direct them to the Atlassian web UI. This restriction is intentional and must not be bypassed.
Compose operations naturally. Many user requests require multiple script calls. For example, "assign PROJ-123 to Sarah" requires: (a) lookup-user "Sarah" to get the account ID, then (b) edit PROJ-123 --assignee <accountId>.
Prefer sync.mjs for document-based operations. When creating Jira issues from a local markdown file (story docs, specs, epics), use sync.mjs instead of raw jira.mjs create — it handles field mapping, link tracking, and sync state automatically. See the Document Sync Operations section below for details. Only use jira.mjs create for ad-hoc issues not backed by a local document.
Use workflows for complex tasks. If the user's request matches one of the workflows below, read the corresponding file and follow its step-by-step process.
Read reference docs when needed. Before writing JQL/CQL queries, consult references/query-languages.md. Before creating tickets, consult references/ticket-writing-guide.md. The reference docs exist to help you produce high-quality output — use them.

Passing Long Content to Scripts

For descriptions, comments, or page bodies longer than ~200 characters or containing special characters (backticks, quotes, $, newlines), write the content to a temp file and use the file-based flag:

Inline Flag	File Flag	Commands
`--description "text"`	`--description-file /tmp/desc.md`	jira create, jira edit
`<body>` (positional)	`--body-file /tmp/body.md`	jira comment, confluence comment
`--body "text"`	`--body-file /tmp/body.md`	confluence create-page, update-page
`--comment "text"`	`--comment-file /tmp/comment.md`	jira worklog

Write plain markdown to the file — scripts handle conversion to ADF (Jira) or storage format (Confluence) automatically. Prefer file-based input to avoid shell escaping issues.

Jira Operations

Script: node <skill-path>/scripts/jira.mjs <command> [args]

Search Issues

jira.mjs search 'project = PROJ AND status = "In Progress"' --max 20

Get Issue Details

jira.mjs get PROJ-123
jira.mjs get PROJ-123 --fields summary,status,assignee

Create Issue

jira.mjs create --project PROJ --type Task --summary "Implement feature X" \
  --description "Details here" --priority High --assignee <accountId> \
  --labels "backend,urgent" --components "API,Auth"
jira.mjs create --project PROJ --type Story --summary "User login" --parent PROJ-100
# For long descriptions, use a file:
jira.mjs create --project PROJ --type Task --summary "Feature X" \
  --description-file /tmp/desc.md --priority High

When creating child stories under an Epic, include --priority Medium unless the user specifies a different priority.

Edit Issue

jira.mjs edit PROJ-123 --summary "Updated title" --priority Medium
jira.mjs edit PROJ-123 --labels "backend,v2" --components "API"
# For long descriptions, use a file:
jira.mjs edit PROJ-123 --description-file /tmp/desc.md

Comments

jira.mjs comment PROJ-123 "Fixed in PR #456"
# For long comments, use a file:
jira.mjs comment PROJ-123 --body-file /tmp/comment.md

Transitions (move ticket status)

jira.mjs transitions PROJ-123          # List available transitions first
jira.mjs transition PROJ-123 31        # Then transition by ID

Always list transitions first to get the correct ID — don't guess.

Projects & Issue Types

jira.mjs projects                      # List all visible projects
jira.mjs issue-types PROJ              # List issue types for a project

Issue Links

jira.mjs link-types                    # List available link types first
jira.mjs link PROJ-1 PROJ-2 --type "relates to"

User Lookup

jira.mjs lookup-user "john"            # Returns account ID needed for --assignee

Worklog

jira.mjs worklog PROJ-123 --time 2h --comment "Code review"

Document Sync Operations

Script: node <skill-path>/scripts/sync.mjs <command> [args]

When creating Jira/Confluence items from local markdown documents, prefer sync.mjs over raw jira.mjs/confluence.mjs — it auto-updates the source document with links and maintains sync state.

Setup Field Mapping (first time per doc type)

sync.mjs setup-mapping --type story --sample PROJ-200   # Auto-detect fields from existing ticket
sync.mjs setup-mapping --type epic --sample PROJ-100    # Creates memory/jira-epic-field-mapping.json

Field mappings are stored in <skill-path>/memory/ and define how markdown sections map to Jira fields. See references/sync-mapping-guide.md for the full schema.

Link & Create from Document

sync.mjs link <file> --type story --project PROJ --create    # Create Jira issue + update doc
sync.mjs link <file> --type epic --project PROJ --create     # Create epic + child stories
sync.mjs link <file> --type story --ticket PROJ-123          # Link to existing ticket

Push/Pull Changes

sync.mjs push <file>                    # Push local changes to Jira/Confluence
sync.mjs push <file> --delete-orphans   # Push + prompt to delete orphaned Sub-* subtasks
sync.mjs pull <file>                    # Pull remote changes to local
sync.mjs diff <file>                    # Show per-section diff
sync.mjs status <file>                  # Show sync status

When push reports orphaned subtasks (sections removed from local doc), ask the user if they want to delete them, then run with --delete-orphans. Only Sub-* issue types can be deleted — parent issues are skipped.

Custom Instructions in Mapping Config

The field mapping JSON (memory/jira-<docType>-field-mapping.json) supports an instructions field for additional agent guidance:

{
  "instructions": "Always set priority to High. Add label 'team-alpha'. Use Sub-Imp type for child items."
}

When present, instructions are printed to stdout during push and link operations so the calling agent can follow them.

Batch Operations

sync.mjs batch                # Scan all linked docs and report status

Confluence Operations

Script: node <skill-path>/scripts/confluence.mjs <command> [args]

Search Pages

confluence.mjs search 'type = page AND text ~ "architecture"' --max 10

Get Page

confluence.mjs get-page 12345
confluence.mjs get-page 12345 --format view

Create Page

confluence.mjs create-page --space TEAM --title "Sprint Report" --body "Report content"
confluence.mjs create-page --space TEAM --title "Sub Page" \
  --body "<h2>Heading</h2><p>Content</p>" --parent 12345
confluence.mjs create-page --space TEAM --title "Full Doc" --body-file /tmp/body.md

The --body flag accepts markdown (recommended), plain text, or raw HTML storage format (if it starts with <). The script automatically converts markdown to Confluence storage format — headings, lists, tables, and code blocks (converted to ac:structured-macro ac:name="code" with language detection) are all handled. Prefer writing markdown and letting the script handle conversion rather than manually constructing storage format XHTML. Use --body-file for long documents that would exceed shell argument limits.

Update Page

confluence.mjs update-page 12345 --title "Updated Title" --body "New content"
confluence.mjs update-page 12345 --title "Updated Title" --body-file /tmp/body.md

Version is auto-incremented — no need to track it manually. Use --body-file for large page updates.

Comments

confluence.mjs comment 12345 "Reviewed and approved"
# For long comments, use a file:
confluence.mjs comment 12345 --body-file /tmp/comment.md

Attachments

confluence.mjs attach 12345 ./screenshot.png --comment "Architecture diagram"
confluence.mjs list-attachments 12345 --max 10

Use attach to upload local files (images, PDFs, etc.) to a page. After uploading, embed images in the page body using <ac:image><ri:attachment ri:filename="screenshot.png" /></ac:image> — see references/confluence-formatting.md for sizing guidelines.

Sync Confluence Space to Local Markdown

# Download an entire page tree to local markdown with attachments
node <skill-path>/scripts/sync-confluence-space.mjs --root <pageId> --output ./docs

# Preview without writing files
node <skill-path>/scripts/sync-confluence-space.mjs --root <pageId> --output ./docs --dry-run

# Skip attachment downloads (faster, markdown only)
node <skill-path>/scripts/sync-confluence-space.mjs --root <pageId> --output ./docs --skip-attachments

Downloads an entire Confluence page tree to local markdown files with hierarchy, images, and linked titles. Rewrites both image references and file attachment links to point to local assets. See workflows/sync-confluence-space.md for full details and customization options.

Spaces & Navigation

confluence.mjs spaces --max 20
confluence.mjs descendants 12345       # Get child pages

Format Conversion Utilities

Script: <skill-path>/scripts/confluence-format.mjs

This module provides bidirectional markdown ↔ Confluence storage format conversion. It's used internally by confluence.mjs but can also be imported directly for custom sync scripts.

Exported Functions

import { markdownToStorage, storageToMarkdown, htmlInlineToMarkdown } from '<skill-path>/scripts/confluence-format.mjs';

Function	Direction	Use case
`markdownToStorage(md)`	Markdown → XHTML	Publishing to Confluence (auto-used by `confluence.mjs --body-file`)
`storageToMarkdown(html)`	XHTML → Markdown	Downloading/syncing Confluence pages to local markdown files
`htmlInlineToMarkdown(html)`	Inline HTML → Markdown	Converting snippets (table cells, list items) that may contain `<strong>`, `<em>`, `<a>`, `<code>`

What `storageToMarkdown` Handles

The converter handles real-world Confluence storage format patterns including:

Structured macros: code blocks (with/without language), panels (info/tip/warning/note → GitHub alerts), expand → <details><summary> collapsible sections, jira references, view-file → attachment links, toc/children (stripped)
Unknown macros: Any unrecognized ac:structured-macro types have their body content preserved (not silently dropped)
Tables: <colgroup>, <tbody>, <thead> wrappers stripped; attributes on <table>, <tr>, <th>, <td> handled
Task lists: <ac:task-list> with <ac:task-id> → markdown checkboxes
Images: URL and attachment images → ![alt](url) with filename as fallback alt text; parentheses and spaces in filenames URL-encoded
Code blocks: Protected from HTML tag stripping via placeholder system — generic types like Array<string> preserved inside fenced blocks
Expand/collapsible bodies: Full content support inside expand macros — code blocks, images, tables, panels, task lists, and nested macros all convert correctly
Entities: Full HTML entity decoding (’, “, →,  , numeric {)
Block separation: \n\n around headings, images, lists, <hr>, tables, code blocks
Attribute tolerance: All HTML tag regexes accept optional attributes (handles Confluence's local-id, data-layout, breakoutWidth, etc.)
Bold/italic cleanup: Trailing spaces inside markers fixed (**text ** → **text**)
Stray angle brackets: Escaped outside code blocks to prevent markdown renderer confusion

Syncing a Confluence Space

For most use cases, use the built-in sync script directly:

node <skill-path>/scripts/sync-confluence-space.mjs --root <pageId> --output ./docs

For custom sync scripts, import storageToMarkdown and follow this pattern:

import { storageToMarkdown } from '<skill-path>/scripts/confluence-format.mjs';

// Fetch page via Confluence v2 API
const page = await apiGet(`/wiki/api/v2/pages/${pageId}`, { 'body-format': 'storage' });
const html = page.body.storage.value;

// Convert to markdown
let markdown = storageToMarkdown(html);

// Add linked title using page._links.base + page._links.webui
const pageUrl = `${page._links.base}${page._links.webui}`;
markdown = `# [${page.title}](${pageUrl})\n\n${markdown}`;

Key gotchas discovered in production use:

The v2 API _links.webui is a relative path (e.g., /spaces/BTH/pages/123/Title). Combine with _links.base (e.g., https://company.atlassian.net/wiki) for the full URL — do NOT use env.domain + _links.webui directly (missing /wiki prefix).
Attachment filenames with spaces and parentheses must be URL-encoded in markdown links: ![alt](Screenshot%202025-11-05%20at%2016.50.02.png).
When writing a hierarchical sync, use getChildrenTree() (recursive children API) to build the tree, then decide per-node: pages with children → directory/index.md, leaf pages → flat PageName.md.
Keep attachments in a shared assets/imgs/ and assets/pdfs/ directory. Use depth-aware relative paths (../assets/imgs/ at depth 1, ../../assets/imgs/ at depth 2, etc.).
The sync script must rewrite both image references (![alt](filename)) and file attachment links ([filename](filename)) to local paths — Confluence view-file macros produce regular links, not image references.
Confluence adds attributes (local-id, breakoutWidth, data-layout) to most HTML tags. Any regex matching tags must use [^>]* for optional attributes.
Expand macro bodies can contain any content (code blocks, images, tables). The inner HTML converter must handle the same set of elements as the main converter.

Running Tests

node <skill-path>/scripts/test-format.mjs

100+ tests covering forward conversion, reverse conversion, round-trip preservation, block element spacing, code block protection, image URL encoding, entity decoding, expand macros with nested content, view-file macros, unknown macro catch-all, and attribute tolerance on HTML tags.

Workflows

For complex multi-step operations that require user interaction across several turns, read the corresponding workflow file and follow its step-by-step process. For simple one-shot commands, use the operations sections above directly.

Workflow	When to use	File
Capture Tasks from Meeting Notes	User provides meeting notes and wants Jira tasks created from action items	`workflows/capture-tasks-from-meeting-notes.md`
Generate Status Report	User wants a project status report, sprint summary, or weekly update	`workflows/generate-status-report.md`
Search Company Knowledge	User wants to find information across Confluence pages and Jira issues	`workflows/search-company-knowledge.md`
Spec to Backlog	User has a Confluence spec and wants it broken into an Epic + child tickets	`workflows/spec-to-backlog.md`
Triage Issue	User reports a bug and wants duplicate checking before filing	`workflows/triage-issue.md`
Create Confluence Document	User wants a professional Confluence page with macros, images, and structured formatting	`workflows/create-confluence-document.md`
Sync BMAD Documents	User wants to sync local BMAD docs (epics, tech specs, PRDs, architecture) with Jira or Confluence, or link a document to a ticket/page	`workflows/sync-bmad-documents.md`
Sync Confluence Space	User wants to download an entire Confluence space to local markdown files with hierarchy, images, and linked titles	`workflows/sync-confluence-space.md`

Error Handling

Error	Likely Cause	Resolution
`401 Unauthorized`	Bad or expired API token	Regenerate at Atlassian security settings
`403 Forbidden`	Insufficient permissions	Check project/space permissions for the user's account
`404 Not Found`	Wrong issue key, page ID, or domain	Verify the resource exists and `ATLASSIAN_DOMAIN` is correct
`429 Too Many Requests`	Rate limited	Wait briefly and retry; reduce batch sizes
Missing env vars	Not configured	Run `node <skill-path>/scripts/setup.mjs`

Reference Documentation

Load these as needed — don't read them all upfront:

Reference	When to consult
`references/jira-api.md`	Need details on Jira API endpoints or request shapes
`references/confluence-api.md`	Need details on Confluence API endpoints or storage format
`references/confluence-formatting.md`	Building professional pages with macros, layouts, images, and document templates
`references/query-languages.md`	Writing JQL or CQL queries
`references/jql-patterns.md`	Need common JQL patterns for reports, searches, filters
`references/action-item-patterns.md`	Parsing meeting notes for action items
`references/report-templates.md`	Generating status reports
`references/bug-report-templates.md`	Creating well-structured bug reports
`references/search-patterns.md`	Multi-source search strategies
`references/epic-templates.md`	Writing epic descriptions
`references/ticket-writing-guide.md`	Writing clear ticket summaries and descriptions
`references/breakdown-examples.md`	Breaking specs into stories and tasks
`references/sync-mapping-guide.md`	Before first document sync, when mapping fields fail, or configuring custom field mappings

同梱ファイル

※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。

📄 SKILL.md (20,856 bytes)
📎 references/action-item-patterns.md (3,049 bytes)
📎 references/breakdown-examples.md (4,021 bytes)
📎 references/bug-report-templates.md (3,454 bytes)
📎 references/confluence-api.md (3,588 bytes)
📎 references/confluence-formatting.md (13,034 bytes)
📎 references/epic-templates.md (3,714 bytes)
📎 references/jira-api.md (3,043 bytes)
📎 references/jql-patterns.md (3,574 bytes)
📎 references/query-languages.md (3,614 bytes)
📎 references/report-templates.md (2,768 bytes)
📎 references/search-patterns.md (3,508 bytes)
📎 references/sync-mapping-guide.md (13,072 bytes)
📎 references/ticket-writing-guide.md (3,920 bytes)
📎 scripts/.gitignore (12 bytes)
📎 scripts/confluence-format.mjs (23,422 bytes)
📎 scripts/confluence.mjs (13,245 bytes)
📎 scripts/jira.mjs (12,548 bytes)
📎 scripts/package-lock.json (1,492 bytes)
📎 scripts/package.json (289 bytes)
📎 scripts/setup.mjs (3,660 bytes)
📎 scripts/sync-confluence-space.mjs (16,486 bytes)
📎 scripts/sync.mjs (54,589 bytes)
📎 scripts/test-format.mjs (25,113 bytes)

atlassian-rest

🇯🇵 日本人クリエイター向け解説

🎯 このSkillでできること

📦 インストール方法 (3ステップ)

📖 Skill本文(日本語訳)

Atlassian REST API スキル

初回セットアップ

必須環境変数

このスキルの使い方

スクリプトに長いコンテンツを渡す

Jira 操作

課題の検索

課題の詳細を取得

課題の作成

課題の編集

コメント

トランジション (チケットステータスの移動)

プロジェクトと課題タイプ

課題リンク

ユーザー検索

作業ログ

ドキュメント同期操作

Atlassian REST API Skill

First-Use Setup

Required Environment Variables

How to Use This Skill

Passing Long Content to Scripts

Jira Operations

Search Issues

Get Issue Details

Create Issue

Edit Issue

Comments

Transitions (move ticket status)

Projects & Issue Types

Issue Links

User Lookup

Worklog

Document Sync Operations

Setup Field Mapping (first time per doc type)

Link & Create from Document

Push/Pull Changes

Custom Instructions in Mapping Config

Batch Operations

Confluence Operations

Search Pages

Get Page

Create Page

Update Page

Comments

Attachments

Sync Confluence Space to Local Markdown

Spaces & Navigation

Format Conversion Utilities

Exported Functions

What storageToMarkdown Handles

Syncing a Confluence Space

Running Tests

Workflows

Error Handling

Reference Documentation

同梱ファイル

What `storageToMarkdown` Handles