GuidesClaude Code Skill

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@psrestful

Then 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@psrestful

Or, 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-official

With 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-integration folder and upload it as a custom skill under Customize → Skills. Each person uploads their own copy.
  • Any theme repository: copy skills/theme-integration into 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

ReferenceCovers
Metafield catalogEvery 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 blocksThe pricing engine embed, tier pricing, location decorations, minimum quantity notice and the volume pricing Shopify Function
Integration patternsReady-to-adapt Liquid and JavaScript for product pages, cart, cart drawer, variant switching, color swatches, shipping weight and list price
Decoration pricingTurning the enriched location_decorations metafield into setup fees, run charges and surcharges as cart lines
Theme workflowWhich 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
NotificationsWhat 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.