compose-page-blocks

Convert rendered HTML content into structured WordPress block markup.

31|3|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/Automattic/data-liberation-agent --skill compose-page-blocks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compose-page-blocks
Source: https://github.com/Automattic/data-liberation-agent/tree/main/skills/compose-page-blocks
Command: npx skills add https://github.com/Automattic/data-liberation-agent --skill compose-page-blocks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Manages the creation of WordPress block markup for content derived from rendered HTML, enhancing efficiency in content migration and transformation processes.

Core Features & Use Cases

  • Automated Markup Creation: Generates valid block markup for WordPress based on HTML and screenshots, facilitating efficient page migration.
  • Visual-to-Code Conversion: Maps visual layout to core WordPress blocks for better content consistency across different platforms.
  • Use Case: When transitioning a webpage to WordPress, use this skill to convert the rendered HTML into corresponding block structure.

Quick Start

Utilize the compose-page-blocks skill by running compose-page-blocks extract --html <htmlPath> --screenshot <screenshotPath> for input files.

Frequently Asked Questions about compose-page-blocks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert HTML to WordPress block markup for content migration?

To convert HTML to WordPress block markup for content migration, this Skill transforms rendered HTML content into structured block markup using predefined templates and styling rules. It parses the provided HTML and maps the visual layout to corresponding core WordPress blocks.

What is the best way to map visual HTML layouts to core WordPress blocks?

Mapping visual HTML layouts to core WordPress blocks is achieved through visual-to-code conversion within this Skill. It aligns visual content across web platforms by translating the visual layout from the rendered HTML and screenshots into a valid WordPress block structure.

Can I use a screenshot along with HTML to generate WordPress block markup?

Yes, you can use a screenshot alongside HTML to generate WordPress block markup. The Skill accepts both an HTML file path and a screenshot path as inputs, utilizing the visual reference to facilitate accurate layout transformation and block composition.

Does this HTML to blocks conversion tool require any specific WordPress plugins?

No specific WordPress plugins are required as dependencies for this HTML to blocks conversion. The Skill operates independently using scripts and references to parse the rendered HTML and generate valid block markup based on predefined styling rules.

How do I run the compose-page-blocks script to extract WordPress blocks from HTML?

To run the compose-page-blocks script and extract WordPress blocks from HTML, execute the command `compose-page-blocks extract --html <htmlPath> --screenshot <screenshotPath>`. This initiates the parsing process to transform your input files into structured block markup.

Are there limitations when transforming complex HTML structures into WordPress blocks?

Limitations when transforming complex HTML structures into WordPress blocks exist due to the reliance on predefined templates and styling rules. The parsing and styling manipulation operate within provided constraints, meaning highly customized or non-standard HTML elements may not map perfectly to core blocks.