wordpress-theme-to-emdash

Convert WordPress themes into EmDash CMS themes through a six-phase porting workflow.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/Thigh-Food/emdash --skill wordpress-theme-to-emdash-thigh-food
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wordpress-theme-to-emdash
Source: https://github.com/Thigh-Food/emdash/tree/main/skills/wordpress-theme-to-emdash
Command: npx skills add https://github.com/Thigh-Food/emdash --skill wordpress-theme-to-emdash-thigh-food

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Porting a WordPress theme to a modern CMS requires manually extracting design tokens, rewriting PHP templates, and recreating menus, taxonomies, and widgets, which is slow and error-prone without a structured process. ## Core Features & Use Cases - Six-Phase Porting Workflow: Guides discovery (screenshots, demo capture), design extraction (CSS variables, fonts), PHP-to-Astro template conversion, dynamic features (menus, taxonomies, widgets), seed file creation, and visual verification. - WordPress-to-EmDash Concept Mapping: Reference docs map WP template hierarchy, template tags, hooks, shortcodes, and widgets to EmDash equivalents like getEmDashCollection, getMenu, and PortableText. - Ready-to-Use Theme Scaffold: A working EmDash theme scaffold with correct API patterns for image fields, site settings, and seed files that you copy as the starting point. - Use Case: Given the Twenty Twenty-Four WordPress theme, follow the phases to screenshot the demo, extract its design tokens, convert its templates to Astro, seed demo content, and verify visual parity. ## Quick Start Port the WordPress theme 'twentytwentyfour' to an EmDash theme, starting by copying the scaffold and capturing screenshots of the demo site.

Frequently Asked Questions about wordpress-theme-to-emdash

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

FAQPage Schema
How do I convert a WordPress theme to Astro?

Follow the six-phase workflow: capture demo screenshots, extract CSS variables and fonts, map PHP templates to Astro routes, implement menus and taxonomies via the EmDash API, create a seed file, then compare output screenshots against the original demo.

How do WordPress template tags map to EmDash?

The Loop maps to getEmDashCollection, the_content maps to the PortableText component, bloginfo maps to getSiteSettings, and wp_nav_menu maps to getMenu. The concept-mapping reference covers the full template tag and taxonomy function equivalents.

Can I use getStaticPaths for EmDash content pages?

No. EmDash content pages must be server-rendered because content changes at runtime through the admin UI. Never use getStaticPaths or prerender for pages displaying CMS content; configure Astro with output set to server.

Why does my EmDash image field render as [object Object]?

Image fields are objects with src and alt properties, not strings. Access post.data.featured_image.src for the URL and post.data.featured_image.alt for alt text instead of using the field directly.

What license applies to a ported WordPress theme?

WordPress themes are GPL-licensed, so ported themes need a GPL-2.0 LICENSE file, a README crediting the original theme, and license set to GPL-2.0-or-later in package.json.