intake-cases

Ingest Shopify template artifacts and output canonical cases JSON files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ingest a screenshot, CSV, markdown table, or prose description of a template's dynamic renderings ("cases") and produce .theme-forge/cases/<page>.json. This is the first command in the multi-case workflow — run it before --cases on any verify/refine/find-variances command. Shared sections (header, footer) live in _shared.json.

Core Features & Use Cases

  • Ingest diverse artifacts to build a comprehensive cases matrix for Shopify templates (product, collection, page, _shared).
  • Normalize case keys, validate required fields, and generate per-page or shared-case JSON files for downstream workflows like refine-page, verify-page, and find-variances.
  • Supports interactive mode when no artifact is provided and handles multi-artifact inputs for migration workflows.

Quick Start

Run /theme-forge intake-cases <page> with an artifact to generate the cases file.

Frequently Asked Questions about intake-cases

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

FAQPage Schema
How do I generate test cases for Shopify templates from a screenshot or CSV?

Generate Shopify template test cases from screenshots, CSVs, markdown tables, or prose by ingesting artifact-based archetypes. The process validates inputs, normalizes case keys, and outputs a canonical JSON file at .theme-forge/cases/<page>.json for downstream workflows.

Can I build a cases matrix for Shopify templates without providing an artifact?

Yes, you can build a Shopify template cases matrix without an artifact by using interactive mode. The system will prompt you directly to input the necessary dynamic renderings and normalize the data into the required JSON structure.

Does intake-cases support migrating Shopify templates with multiple input formats?

Yes, intake-cases supports Shopify template migration workflows by handling multi-artifact inputs. It can ingest diverse formats like screenshots, CSVs, markdown tables, and plain text simultaneously to build a comprehensive cases matrix.

How do I create shared header and footer cases for Shopify theme verification?

Create shared header and footer cases for Shopify theme verification by generating a dedicated _shared.json file. The tool ingests artifact-based archetypes for these shared sections and normalizes them into the same canonical JSON format used for individual pages.

What downstream workflows require the .theme-forge/cases JSON file?

The .theme-forge/cases JSON file is required for downstream refine-page, verify-page, and find-variances workflows. You must generate this canonical cases file first before running any verification or refinement commands on your Shopify templates.

What Shopify template types are supported when generating per-page cases?

Supported Shopify template types for per-page case generation include product, collection, page, and shared header/footer sections. The tool validates required fields and enforces path formats for each specific template archetype.