PromoSync Skill for Claude Code
PromoSync publishes a free skill for Claude Code, Anthropic’s coding assistant. With it installed, Claude knows every PromoSync metafield, how the theme app blocks work, how decoration pricing is encoded, which Shopify themes suit promotional products, and what each PromoSync notification email means. Ask it to add volume pricing to a product page, price decorations in the cart, or explain why a product did not import, and it answers from the same reference PromoSync’s own team uses.
The skill is documentation, not code. It never touches your store, your PromoSync account or PSRESTful. It only gives Claude the facts it needs to write correct Liquid and give correct advice.
Install
In a Claude Code session, run these two commands once:
/plugin marketplace add GallardoSolutions/promosync-skills
/plugin install promosync@psrestfulThen open your Shopify theme folder and ask, for example:
- “Add a tier pricing table to the product page using PromoSync data”
- “Show the decoration setup fee and run charge in the cart”
- “Which theme should I start from for a promotional products store?”
- “A merchant got a ‘Product Import Results’ email with failed products. What does this error mean?”
Claude loads the skill on its own when a request is about PromoSync. You can also call it directly with
/promosync:theme-integration.
Keep it up to date
PromoSync adds metafields and blocks regularly, and the skill is updated with them. Each release bumps the
plugin’s version, and the repository’s CHANGELOG.md lists what changed. Marketplaces added by hand do not
auto-update, so refresh it from time to time. In a terminal:
claude plugin update promosync@psrestfulOr, inside Claude Code, open /plugin, go to Installed, and choose Update now. The Marketplaces
tab has an auto-update switch for the psrestful marketplace.
Pair it with Shopify’s tooling
The skill knows PromoSync. Shopify’s own tooling knows Liquid, section schemas and the GraphQL APIs, and can validate the code Claude writes before you ship it. Install both:
/plugin install shopify-ai-toolkit@claude-plugins-officialWith both installed, Claude sends Shopify-platform questions to Shopify’s tools and keeps the
PromoSync-specific parts (metafield shapes, pricing rules, block behaviour) for itself. Finish each change
with shopify theme check. Details on Shopify’s side are at
shopify.dev/docs/apps/build/ai-toolkit.
Without Claude Code
- claude.ai: download the repository, zip the
skills/theme-integrationfolder and upload it as a custom skill under Customize → Skills. Each person uploads their own copy. - Any theme repository: copy
skills/theme-integrationinto your theme at.claude/skills/theme-integration/. Everyone who clones the theme gets the skill with no install step. This also works for agencies that keep one repository per client store.
What the skill covers
| Reference | Covers |
|---|---|
| Metafield catalog | Every psrestful.* metafield with its namespace, key, type and JSON shape, including gated ones such as the variant gallery, blank and sample pricing, MSRP and marketing points |
| Theme app blocks | The pricing engine embed, tier pricing, location decorations, minimum quantity notice and the volume pricing Shopify Function |
| Integration patterns | Ready-to-adapt Liquid and JavaScript for product pages, cart, cart drawer, variant switching, color swatches, shipping weight and list price |
| Decoration pricing | Turning the enriched location_decorations metafield into setup fees, run charges and surcharges as cart lines |
| Theme workflow | Which themes fit promotional products, the order to set up a store, the Shopify CLI loop, keeping theme code in GitHub, and how PSRESTful rate limits size a plan |
| Notifications | What each PromoSync result email means and who fixes it |
The source is public at github.com/GallardoSolutions/promosync-skills. Issues and pull requests are welcome there; questions go to support@psrestful.com.