theme-forge

Orchestrate Shopify theme migrations across discovery, mapping, pulling, and verification sub-skills.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Migrate Shopify themes efficiently by orchestrating discovery, mapping, pulling, and regression verification across a suite of sub-skills, ensuring pixel-accurate results and a smooth go-live transition.

Core Features & Use Cases

  • End-to-end migration of a live theme to a target theme, with automatic inventory, mapping, pulling, and patch generation.
  • Parallel-session coordination via git for resuming work across team members or bots.
  • Pixel-perfect pulling with screenshot diffs and computed-style verifications to ensure visual parity.
  • Automated onboarding and global maps to standardize migrations and reduce drift.

Quick Start

Onboard a project, scan both themes, map sections, pull sections/pages, then verify results.

Frequently Asked Questions about theme-forge

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

FAQPage Schema
How do I migrate a Shopify theme from a live store to a dev environment?

Migrate a Shopify theme by orchestrating discovery, mapping, pulling, and regression verification across sub-skills. This toolkit handles end-to-end live-to-dev migrations, using automated onboarding and global maps to standardize the process and reduce drift.

What is the best way to ensure pixel-perfect Shopify theme migrations?

Ensure pixel-perfect Shopify theme migrations by using screenshot diffs and computed-style verifications during the pulling process. This visual regression verification checks section mappings against the target theme to guarantee visual parity before go-live.

Can I run parallel Shopify theme migration sessions with my team?

Yes, you can run parallel Shopify theme migration sessions. The toolkit coordinates parallel sessions via git, allowing team members or bots to resume work seamlessly across shared global maps without overwriting each other's progress.

How do I resolve variances when pulling Shopify theme sections?

Resolve variances when pulling Shopify theme sections by applying the find-variances and refine-section sub-skills. These tools compute style differences and generate patches to align the target theme sections with the live inventory automatically.

Do I need browser tooling for automated Shopify theme migrations?

Browser tooling is optional but recommended for automated Shopify theme migrations. A capable execution environment handles the core orchestration, while browser tools enable the screenshot diffs and visual verifications needed for pixel-accurate results.

What steps are involved in an end-to-end Shopify theme migration?

End-to-end Shopify theme migration involves onboarding a project, scanning both themes, mapping sections, pulling sections and pages, and then verifying the results. This workflow uses sub-skills like map-section, pull-section, and verify-section to complete the transition.