reconcile

Detect completed work in an in-progress Shopify theme migration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects and reports already completed work in an in-progress Shopify theme migration. Diffs the target theme against its baseline to identify custom sections, evaluate completeness, and create report stubs so status and review reflect reality.

Core Features & Use Cases

  • Inventory and compare: loads base and target templates, identifies modified settings and custom sections.
  • Section provenance and references: tracks where sections are used and which pages reference them, guiding impact analysis.
  • Report generation: writes structured JSON reports under .theme-forge/reports/sections for review and progress tracking.
  • Flexible scope: supports per-page reconciliation via --page and dry-run mode to preview changes.

Quick Start

Onboard a migration, then run /theme-forge reconcile [--page <template>] [--dry-run].

Frequently Asked Questions about reconcile

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

FAQPage Schema
How do I track completed work in an in-progress Shopify theme migration?

To track completed work in a Shopify theme migration, run a reconciliation process that diffs the target theme against its baseline. This inventories templates, detects custom sections, parses CSS overrides, and generates JSON status reports reflecting real progress.

What are custom sections and how do I identify them during a Shopify migration?

Custom sections are unique theme components added during a Shopify migration. Identify them by diffing target templates against baseline templates to detect modified settings and inventory new additions, which helps evaluate migration completeness and track section provenance.

Can I preview migration changes before generating Shopify theme reports?

Yes, you can preview migration changes before generating Shopify theme reports by using a dry-run mode. This allows you to evaluate detected custom sections and CSS overrides without writing structured JSON report files to your reports directory.

How do I reconcile Shopify theme migration progress for a specific page template?

You can reconcile Shopify theme migration progress for a specific page template by running the reconciliation process with a page-specific scope. This targets individual templates to identify modified settings, custom sections, and CSS overrides for that particular page.

Where are Shopify migration status reports stored and what format do they use?

Shopify migration status reports are stored as structured JSON files under the .theme-forge/reports/sections directory. These reports document detected custom sections, modified settings, and CSS overrides to guide impact analysis and review.

What configuration is needed to detect already-completed work in a Shopify migration?

To detect already-completed work in a Shopify migration, the process reads configuration from .theme-forge/config.json. It uses this baseline data to inventory templates, parse CSS overrides, and identify custom sections modified in prior scans.