verify-section

Execute saved regression contracts for a single Shopify section across breakpoints.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read-only regression runner for a single Shopify section. It executes saved assertions against the dev site and reports PASS / FAIL / STALE / ERROR per check. It never mutates code and never invokes refine or pull commands.

Core Features & Use Cases

  • Run a frozen regression contract against a single section to detect visual or layout regressions.
  • Group assertions by breakpoint and generate a compact per-breakpoint report, with optional case-scoping.
  • Produce per-run run logs and a generated markdown companion for auditing, while keeping user-authored notes intact.

Quick Start

Run verify-section for a specific section and page to execute its assertions against the dev site and view the results.

Frequently Asked Questions about verify-section

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

FAQPage Schema
How do I run regression checks for a Shopify section without modifying the code?

Regression checks for a Shopify section can be run read-only by executing saved assertions against the dev site. This Skill validates assertions.json, reports PASS/FAIL/STALE/ERROR per check, and strictly enforces a policy of never mutating source materials.

Can I test Shopify sections across different device breakpoints?

Yes, Shopify section regression checks support testing across desktop, tablet, and mobile breakpoints. The Skill groups saved assertions by breakpoint and generates a compact per-breakpoint report to isolate layout or visual regressions.

What's the best way to isolate layout regressions on a single Shopify page?

To isolate layout regressions on a single Shopify page, apply case-scoping to run frozen regression contracts against a specific section. This process identifies regressions per-section or per-page without invoking refine or pull commands.

How do assertion contracts handle stale entries during section testing?

Assertion contracts handle stale entries by reporting them as STALE during section testing. The Skill supports optional rebaseline for STALE entries, requiring explicit user prompts before updating the baseline, ensuring controlled regression management.

Does the section verification process generate logs for auditing?

Yes, the section verification process generates per-run logs and a markdown companion for auditing. It executes saved regression contracts while keeping user-authored notes completely intact throughout the read-only validation process.