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.
Best use case
adf-format-json-schema is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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.
Teams using adf-format-json-schema should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/adf-format-json-schema/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How adf-format-json-schema Compares
| Feature / Agent | adf-format-json-schema | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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: ```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 Details Gets 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 ``` ## Workflow When implementing an ADF node or mark: 1. **List definitions** to find the exact definition name 2. **Get definition details** to understand the schema structure 3. **Implement the dataclass** based on the schema properties and requirements
Related Skills
json-yaml
Process JSON, YAML, CSV, and XML data (jq, yq, awk).
json-visualization-dev
Develop and maintain the JSON Visualization web application - a Next.js tool for visualizing JSON/YAML/CSV/XML data as interactive graphs. Use when working with this codebase, adding features, fixing bugs, or understanding the graph visualization, data conversion, or type generation systems.
dbt-transformation-patterns
Master dbt (data build tool) for analytics engineering with model organization, testing, documentation, and incremental strategies. Use when building data transformations, creating data models, or ...
verify-information-rule
This rule ensures that the AI always verifies information before presenting it, avoiding assumptions and speculation.
Schema Migration
Create safe, zero-downtime schema migrations with rollback procedures
Schema Evolution Impact Analysis
Analyze the impact of model/schema changes on downstream code — affected repositories, services, handlers, tests, and migration requirements
Schema Design
Migration-ready database schema design with normalization and indexing strategies
lint-and-format
Runs linting and formatting checks before committing. Use this skill after writing or modifying code to ensure it passes all linters and formatters before creating a commit.
json-canvas
Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions Canvas files in Obsidian.
file-to-json-parsing
Use AgentPMT external API to run the File To JSON Parsing tool with wallet signatures, credits purchase, or credits earned from jobs.
aws-cloudformation-rds
AWS CloudFormation patterns for Amazon RDS databases. Use when creating RDS instances (MySQL, PostgreSQL, Aurora), DB clusters, multi-AZ deployments, parameter groups, subnet groups, and implementing template structure with Parameters, Outputs, Mappings, Conditions, and cross-stack references.
ash-json-api
AshJsonApi guidelines for exposing Ash resources as JSON:API compliant REST endpoints. Use when adding JSON:API extensions to domains/resources, configuring routes, or implementing filtering, sorting, pagination, and includes. Supports full JSON:API specification.