skills.rest
cfagerlin
cfagerlinCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/cfagerlin/theme-forge --skill map-section
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Design & Creative Skills→
sarojpundesarojpunde
4

Shopify Workflow & Tools

Automate Shopify theme development tasks using Shopify CLI workflows.

Community
Intermediate
i3ringiti3ringit
3

spec-flow-analyzer

Analyze specifications to map user flows, edge cases, and gaps.

Community
Advanced
thoreinsteinthoreinstein
5

file-organizer

Analyze directory structures, detect duplicates, and automate file organization with approval.

Community
Basic
ousiassousiass

stitch-shopify

Convert Stitch mock ZIPs into Shopify Online Store 2.0 themes with Liquid templates.

Community
Advanced