adf-json-example
Fetch raw ADF JSON data from a Confluence page URL. Use this skill when you need to see real-world ADF examples, understand how Confluence represents specific elements, debug ADF parsing, or create test samples.
When & Why to Use This Skill
This Claude skill enables developers to fetch and inspect raw Atlassian Document Format (ADF) JSON data directly from Confluence page URLs. It streamlines the development and debugging of Atlassian-based integrations by providing immediate access to real-world document structures, helping users understand how complex elements like tables, macros, and marks are represented in the underlying JSON.
Use Cases
- Debugging ADF Parsing: Inspect the raw JSON structure of specific Confluence pages to identify and resolve issues in custom document parsers or rendering engines.
- Integration Development: Use real-world ADF examples as a reference to build and test applications that interact with the Confluence Cloud API.
- Test Data Generation: Quickly retrieve the complete JSON body of existing pages to create realistic mock data for unit tests and quality assurance.
- Content Structure Analysis: Analyze how nested nodes and marks are organized within a document to plan data migrations or content transformations.
| name | adf-json-example |
|---|---|
| description | Fetch raw ADF JSON data from a Confluence page URL. Use this skill when you need to see real-world ADF examples, understand how Confluence represents specific elements, debug ADF parsing, or create test samples. |
ADF JSON Example Query Skill
This skill fetches the raw Atlassian Document Format (ADF) JSON data from a Confluence page. Use this when you need to understand the actual ADF structure of a real Confluence page, inspect how specific elements are represented in ADF, or debug ADF parsing issues.
Purpose
When working with ADF data, you often need to see real-world examples of how Confluence represents content. This skill:
- Fetches the complete ADF JSON body from any accessible Confluence page
- Displays the raw JSON structure with proper formatting
- Caches results locally to avoid repeated API calls
Prerequisites
The Confluence API credentials must be configured. See atlas_doc_parser/tests/data/client.py for authentication setup.
Command
Fetch ADF JSON from a Confluence page URL:
.venv/bin/python .claude/skills/adf-json-example/scripts/adf_json_example_cli.py get_example "<confluence_page_url>"
Parameters
confluence_page_url: Full URL to a Confluence page (e.g.,https://your-domain.atlassian.net/wiki/spaces/SPACE/pages/123456/Page+Title)
Example
.venv/bin/python .claude/skills/adf-json-example/scripts/adf_json_example_cli.py get_example "https://sanhehu.atlassian.net/wiki/spaces/GitHubMacHuGWU/pages/654049306/Mark+-+strong"
This outputs the full ADF JSON structure of the page, showing how nodes and marks are organized.
Output
The command prints formatted JSON to stdout, containing the full ADF document structure with:
version: ADF format version (typically 1)type: Document type (typically "doc")content: Array of top-level nodes (paragraphs, headings, tables, etc.)
Each node contains its type, attributes, and nested content/marks.