AgentSkillsCN

adf-json-example

从Confluence页面URL获取原始ADF JSON数据。当您需要查看真实世界ADF示例、理解Confluence如何表示特定元素、调试ADF解析，或创建测试样本时使用此技能。

SKILL.md
--- frontmatter
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:

bash
.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

bash
.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.