map-section

Map Shopify theme sections and generate compatibility reports.

Updated Aug 27, 2026

Search Tags:#reporting #shopify #schema-analysis #css-analysis #section-mapping #theme-compatibility

Ready to run

npx skills add https://github.com/cfagerlin/theme-forge --skill map-section

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: map-section
Source: https://github.com/cfagerlin/theme-forge/tree/main/map-section
Command: npx skills add https://github.com/cfagerlin/theme-forge --skill map-section

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Assess compatibility between a live/base theme section and the target theme. Finds the best match, compares schemas, and produces a compatibility report.

Core Features & Use Cases

Load the base-theme section and parse its section schema to extract settings, blocks, and presets.
Identify candidate sections in the target theme by exact name, prefixed name, or fuzzy similarity, then perform deep comparisons of schema, HTML, and CSS.
Generate a structured compatibility report and persist it to .theme-forge/mappings/sections/{section-name}.json for review.

Quick Start

Onboard the base and target themes, then run /theme-forge map-section <section-name> to generate the compatibility report.

Frequently Asked Questions about map-section

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

FAQPage Schema

How do I assess Shopify section compatibility during a theme migration?▼

Shopify section compatibility is assessed by parsing the base-theme section schema to extract settings, blocks, and presets, then comparing it against target-theme candidates using exact name, prefixed name, or fuzzy similarity matching. The tool evaluates schema, HTML, and CSS to identify the best match.

What does a Shopify section mapping report include?▼

A Shopify section mapping report contains a structured compatibility assessment generated from deep comparisons of section schemas, HTML, and CSS. It identifies the best target-theme match for a base-theme section and writes the results as a JSON mapping file.

Can I compare section schemas between two different Shopify themes?▼

Yes, you can compare section schemas between two different Shopify themes. Load the base-theme section to extract its settings, blocks, and presets, then perform deep comparisons against candidate sections identified in the target theme.

How do I generate a compatibility report for a specific Shopify section?▼

To generate a compatibility report for a specific Shopify section, onboard the base and target themes, then run the map-section command with the section name. The structured compatibility report is written to the mappings directory as a JSON file.

Do I need access to both base and target themes to map Shopify sections?▼

Yes, you need access to both base and target themes to map Shopify sections. The process requires parsing the base-theme section schema and comparing it against candidate sections within the target theme to produce the compatibility assessment.