scan

Inventory pages, layouts, sections, and settings across Shopify themes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cfagerlin/theme-forge --skill scan-cfagerlin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scan
Source: https://github.com/cfagerlin/theme-forge/tree/main/scan
Command: npx skills add https://github.com/cfagerlin/theme-forge --skill scan-cfagerlin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inventory all pages, layouts, sections, and settings across base and target Shopify themes to enable reliable migration planning.

Core Features & Use Cases

  • Comprehensive inventory: enumerate layouts, templates, sections, blocks, and global settings in both themes.
  • Migration planning: produce a detailed plan and dependency graph that guides mapping and pull operations.
  • Diff awareness: identify gaps between base and target themes and surface risk indicators.
  • Output for downstream steps: emit a structured inventory (JSON) consumable by template-map, pull-page, and related workflows.

Quick Start

Run the scan workflow to inventory base and target themes and generate a migration plan.

Frequently Asked Questions about scan

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

FAQPage Schema
How do I inventory Shopify theme files to plan a migration?

Inventorying Shopify theme files requires parsing layouts, templates, sections, and config files like settings_schema.json from both base and target themes. This produces a structured JSON inventory that drives reliable migration planning and template mapping.

What is the best way to detect diffs between base and target Shopify themes?

Detecting diffs between Shopify themes involves enumerating all layouts, sections, blocks, and global settings in both versions. The scan workflow identifies configuration gaps and surfaces risk indicators to guide your migration strategy and template mapping operations.

How do I map sections and templates when migrating between Shopify themes?

Mapping sections and templates during Shopify migration requires a comprehensive inventory of both themes. Parsing theme files generates a structured dependency graph and migration plan that clearly maps corresponding templates and surfaces structural risks.

Do I need to parse settings_data.json to migrate Shopify theme settings?

Yes, parsing config/settings_data.json and settings_schema.json is required to inventory global settings during Shopify migration. Extracting these configuration files ensures all theme settings are mapped correctly and included in the downstream migration plan.

Can I generate a dependency graph for a Shopify theme migration?

Generating a dependency graph for Shopify theme migration involves parsing all theme layouts, templates, and sections. The scan workflow analyzes these files to produce a structured inventory with dependency graphs and risk notes for reliable downstream pulls.

What limitations should I consider when scanning Shopify themes for migration?

Scanning Shopify themes for migration is limited to parsing static theme files like layouts, templates, sections, and config JSON. It does not migrate dynamic content or storefront data, focusing solely on producing a structured inventory for migration planning.