refine-section

Automate a one-change-per-iteration loop to close CSS and setting variances on a pulled Shopify section.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Close extracted variances on a pulled Shopify section using a disciplined, one-change-per-iteration loop that ensures verifiable progress.

Core Features & Use Cases

  • Orchestrates an autoresearch-style experiment loop modeled after Karpathy's approach to iteratively fix CSS and setting discrepancies.
  • Supports per-page and per-case scoping, with hypotheses generated, applied, and verified in a deterministic sequence.
  • Integrates with a git-backed state machine to track changes, commits, and reverts as needed, and handles cascade checks to avoid conflicts.

Quick Start

Run refine-section after pull-section reports open variances to iteratively fix each variance with a single, atomic change and immediate verification.

Frequently Asked Questions about refine-section

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

FAQPage Schema
How do I fix CSS variances on a pulled Shopify section?

Fix CSS variances on a pulled Shopify section by running an autoresearch-style experiment loop that applies one atomic change per iteration and immediately verifies the result against the target.

What is an autoresearch-style loop for closing frontend variances?

An autoresearch-style loop for frontend variances iteratively generates hypotheses, applies deterministic file edits, and verifies each change to systematically close CSS and setting discrepancies.

Do I need to pull a Shopify section before fixing CSS discrepancies?

Yes, you need to pull a Shopify section first using a pull-section workflow, which reports open variances and provides the baseline files required to start the refinement loop.

Can I scope CSS variance fixes to specific pages or breakpoints on Shopify?

Yes, you can scope CSS variance fixes using per-page and per-case scoping, allowing you to isolate breakpoint-specific discrepancies and run cascade checks to avoid conflicts.

How does the git-backed state machine manage CSS variance iterations?

The git-backed state machine tracks changes, commits, and reverts for each variance iteration, ensuring verifiable progress and safe recovery if a hypothesized CSS edit fails verification.

What is the best way to ensure verifiable progress when fixing Shopify settings?

The best way to ensure verifiable progress is enforcing a strict one-change-per-iteration discipline, which applies a single setting edit, verifies it, and queues remaining variances deterministically.