How do I install the Adf Format JSON Schema skill?

Run npx skillmds@latest add tomevault-io/adf-format-json-schema in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Adf Format JSON Schema safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Adf Format JSON Schema?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Adf Format JSON Schema free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Adf Format JSON Schema?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Adf Format JSON Schema by tomevault-io

Name: Adf Format JSON Schema
Author: tomevault-io

Adf Format JSON Schema

Query Atlassian Document Format (ADF) JSON schema definitions to understand ADF node and mark types. Use this skill when implementing ADF dataclass nodes/marks, or when user asks about ADF structure, ADF nodes, ADF marks, or Atlassian Document Format implementation. Use when this capability is needed.

tomevault-io 7d3b885 2 files · 2.7 KB Updated Sep 17, 2026

File contents

ADF JSON Schema Query Skill

This skill provides tools to query the Atlassian Document Format (ADF) JSON schema, which defines the structure of all node and mark types used in Confluence pages and Jira issue fields.

Purpose

When implementing ADF nodes or marks as Python dataclasses, you need to understand:

What properties each type has
Which properties are required vs optional
The allowed values for each property

This skill helps you query the schema to get this information.

Commands

List All Definitions

Lists all available node and mark definitions in the ADF schema:

.venv/bin/python ./.claude/skills/adf-format-json-schema/scripts/adf_schema_cli.py list_def

Output format: name = <definition_name>, properties = [<property_list>]

Definitions follow naming conventions:

*_node - Node types (e.g., paragraph_node, heading_node)
*_mark - Mark types (e.g., strong_mark, em_mark, link_mark)

Get Definition Details

Gets the full JSON schema for a specific definition:

.venv/bin/python ./.claude/skills/adf-format-json-schema/scripts/adf_schema_cli.py get_def <definition_name>

Example:

.venv/bin/python ./.claude/skills/adf-format-json-schema/scripts/adf_schema_cli.py get_def strong_mark

Workflow

When implementing an ADF node or mark:

List definitions to find the exact definition name
Get definition details to understand the schema structure
Implement the dataclass based on the schema properties and requirements

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: adf-format-json-schemadescription: Query Atlassian Document Format (ADF) JSON schema definitions to understand ADF node and mark types. Use this skill when implementing ADF dataclass nodes/marks, or when user asks about ADF structure, ADF nodes, ADF marks, or Atlassian Document Format implementation. Use when this capability is needed.---# ADF JSON Schema Query SkillThis skill provides tools to query the Atlassian Document Format (ADF) JSON schema, which defines the structure of all node and mark types used in Confluence pages and Jira issue fields.## PurposeWhen implementing ADF nodes or marks as Python dataclasses, you need to understand:- What properties each type has- Which properties are required vs optional- The allowed values for each propertyThis skill helps you query the schema to get this information.## Commands### List All DefinitionsLists all available node and mark definitions in the ADF schema:```bash.venv/bin/python ./.claude/skills/adf-format-json-schema/scripts/adf_schema_cli.py list_def```Output format: `name = <definition_name>, properties = [<property_list>]`Definitions follow naming conventions:- `*_node` - Node types (e.g., `paragraph_node`, `heading_node`)- `*_mark` - Mark types (e.g., `strong_mark`, `em_mark`, `link_mark`)### Get Definition DetailsGets the full JSON schema for a specific definition:```bash.venv/bin/python ./.claude/skills/adf-format-json-schema/scripts/adf_schema_cli.py get_def <definition_name>```Example:```bash.venv/bin/python ./.claude/skills/adf-format-json-schema/scripts/adf_schema_cli.py get_def strong_mark```## WorkflowWhen implementing an ADF node or mark:1. **List definitions** to find the exact definition name2. **Get definition details** to understand the schema structure3. **Implement the dataclass** based on the schema properties and requirements---> Converted and distributed by [TomeVault](https://tomevault.io/claim/machu-gwu) — claim your Tome and manage your conversions.

Frequently asked questions