skills.rest
williamsforeal
williamsforealCOMMUNITY
Explore all skills by this author →
GitHub

shopify-shrine

Edit Shopify Shrine theme files with schema-aligned structure and GraphQL updates.

1|Updated Feb 6, 2026
Search Tags:#graphql#liquid#shopify#theme editing#settings schema#pdp customization#template json
One-click install
npx skills add https://github.com/williamsforeal/Cyclone-SS --skill shopify-shrine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shopify-shrine
Source: https://github.com/williamsforeal/Cyclone-SS/tree/main/claude-workspaces/_modes/shopify-store-build/.claude/skills/shopify-shrine
Command: npx skills add https://github.com/williamsforeal/Cyclone-SS --skill shopify-shrine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents errors and wasted cycles when updating a Shopify Shrine theme by teaching Claude the exact theme file layout, section/block relationships, and schema-driven settings so it can make correct changes instead of guessing filenames or JSON structures.

Core Features & Use Cases

  • Shrine theme file structure guidance: Directs edits to the correct locations across config/, layout/, sections/, templates/, assets/, and snippets/.
  • Brand-specific template workflow: Helps create templates/product.<brand>.json from templates/product.json to customize PDP section ordering and visibility per brand without forking the whole theme.
  • settings_data.json correctness: Enforces token and font naming rules that align with settings_schema.json, including the required font format like oswald_n7.
  • main-product section block targeting: Clarifies which PDP elements are driven by blocks in sections/main-product.liquid and which are controlled by template JSON ordering.
  • Safe GraphQL update process: Guides template updates via themeFilesUpsert with a read-before-write workflow to avoid missing or malformed updates.

Quick Start

Use the shopify-shrine skill to update your Shrine theme by creating a templates/product.<brand>.json template that reorders and configures the main-product blocks, then apply it to your products in Shopify.

Frequently Asked Questions about shopify-shrine

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

FAQPage Schema
How do I edit Shopify Shrine theme files without guessing file locations?▼

To customize a Shopify Shrine PDP, create a brand-specific template like templates/product.<brand>.json from the base product.json. This allows you to reorder main-product blocks and configure section visibility without forking the entire theme.

What is the correct way to update settings_data.json in a Shopify theme?▼

Updating settings_data.json requires enforcing token and font naming rules that align with settings_schema.json, such as using the required oswald_n7 font format. This ensures schema correctness and prevents malformed theme settings.

How do I reorder main-product section blocks on a Shopify PDP?▼

Reordering main-product section blocks is driven by template JSON ordering rather than editing sections/main-product.liquid directly. This separates block visibility configuration from section structural editing for deterministic PDP updates.

Can I use Shopify GraphQL to safely update theme files?▼

Yes, you can safely update Shopify theme files using the themeFilesUpsert GraphQL mutation. A read-before-write workflow is required to avoid missing or malformed updates and to validate results through userErrors validation.

Why are my Shopify Shrine theme updates failing or malformed?▼

Shopify Shrine theme updates fail when file guesses are incorrect or settings_data.json tokens mismatch the schema. Enforcing schema-aligned structures and deterministic themeFilesUpsert updates with userErrors validation prevents these malformed updates.

Related Skills

Explore More Design & Creative Skills→
MatheusrlrMatheusrlr
1

shopify-developer

Document Shopify development with Liquid, GraphQL APIs, and Hydrogen.

Community
Advanced
ShopifyShopify
491

shopify-admin-execution

Execute validated Shopify Admin GraphQL operations via Shopify CLI commands.

Official
Advanced
lengo0951lengo0951

ck:shopify

Develop Shopify apps, themes, and extensions using Shopify CLI and APIs.

Community
Advanced
Niccos-Shopify-WorkspaceNiccos-Shopify-Workspace
2

theme-shopify-section-structure

Organize Shopify theme sections with standardized file structure and schema requirements.

Official
Basic