Skip to content
Back to search

shopify-hydrogen-skills

Dedicated agent skills for building, upgrading, and maintaining Shopify Hydrogen storefronts — works with Claude, Cursor, Copilot, and more.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/weaverse--shopify-hydrogen-skills/badge.svg)](/listings/weaverse--shopify-hydrogen-skills)

HTML

<a href="/listings/weaverse--shopify-hydrogen-skills"><img src="/api/listings/weaverse--shopify-hydrogen-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code: Skills and Store Connection

Run this in your terminal with [Claude Code 2.1.292 or later](https://code.claude.com/docs/en/plugins/install#add-and-install-from-your-shell):

claude plugin install weaverse --marketplace Weaverse/shopify-hydrogen-skills

This adds our repository-hosted marketplace and installs the `weaverse` plugin for your Claude Code user. The plugin includes every skill in `skills/` and registers the hosted `weaverse` MCP server at `https://mcp.weaverse.io/mcp`. No Content API key is needed.

Start a new Claude Code session, open `/mcp`, and authenticate the Weaverse server. Sign in with your Shopify store and review the requested access; leave optional permissions unchecked for read-only use. Ask the agent to call `list_projects` to check which store it can see. Plugin skills use names such as `/weaverse:setup-weaverse-project`.

Update with `claude plugin update weaverse@weaverse`; auto-update is off by default for third-party marketplaces. Enable it in `/plugin` → **Marketplaces** → **weaverse** → **Enable auto-update** ([guide](https://code.claude.com/docs/en/plugins/install#keep-plugins-updated)).

Already installed the skills with `npx skills add`? Keep them and add just the store connection instead:

claude mcp add --transport http weaverse https://mcp.weaverse.io/mcp

Codex, Cursor, and Other Agents

The skills-only installation is unchanged:

npx skills add Weaverse/shopify-hydrogen-skills

Select your agent and installation scope when prompted. Powered by [skills.sh](https://skills.sh).

For store access, Codex, Cursor, and other MCP clients use the local `npx -y @weaverse/mcp` server with `WEAVERSE_API_KEY`. Create a Content API key in [Dashboard → Account → API Keys](https://studio.weaverse.io/dashboard/account), then follow the [per-agent connection steps](https://docs.weaverse.io/developer-tools/weaverse-mcp#client-configuration). Keep keys private and out of version control.

Review or disconnect hosted access in [Dashboard → Account → Connected AI apps](https://studio.weaverse.io/dashboard/account). Revoke local-server API keys under **API Keys** on the same page. For older Claude Code versions and manual per-agent setup, see [INSTALL.md](INSTALL.md).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "weaverse",
  3. "owner": {
  4. "name": "Weaverse",
  5. "url": "https://weaverse.io"
  6. },
  7. "description": "Skills and store connection for Shopify Hydrogen development with Weaverse.",
  8. "plugins": [
  9. {
  10. "name": "weaverse",
  11. "source": "./"
  12. }
  13. ]
  14. }
README.md · README · 203 lines
  1. # Shopify Hydrogen Skills
  2. Agent skills for building, maintaining, and upgrading Shopify Hydrogen storefronts with [Weaverse](https://weaverse.io). Works with **Claude Code, Cursor, GitHub Copilot, Windsurf, OpenCode, OpenClaw, Gemini CLI**, and any agent that supports markdown skill files.
  3. > **Why skills, not docs?** Skills are concise, agent-optimized knowledge that your coding agent loads before working on a task — structured for LLMs, not humans. Pair them with live doc search for the best results.
  4. > **Versions.** The skills target **Hydrogen 2026.10** (`@shopify/hydrogen` as a request-handler library), React Router 7 and **`@weaverse/hydrogen` 6** (imports from `@weaverse/hydrogen/react-router`), with [Pilot](https://github.com/Weaverse/pilot) `main` as the reference implementation. Classic Hydrogen (2026.4 and earlier) and `@weaverse/hydrogen` 5 appear only in the upgrade and migration guides.
  5. ## Quick Install
  6. ### Claude Code: Skills and Store Connection
  7. Run this in your terminal with [Claude Code 2.1.292 or later](https://code.claude.com/docs/en/plugins/install#add-and-install-from-your-shell):
  8. ```bash
  9. claude plugin install weaverse --marketplace Weaverse/shopify-hydrogen-skills
  10. ```
  11. This adds our repository-hosted marketplace and installs the `weaverse` plugin
  12. for your Claude Code user. The plugin includes every skill in `skills/` and
  13. registers the hosted `weaverse` MCP server at `https://mcp.weaverse.io/mcp`.
  14. No Content API key is needed.
  15. Start a new Claude Code session, open `/mcp`, and authenticate the Weaverse
  16. server. Sign in with your Shopify store and review the requested access; leave
  17. optional permissions unchecked for read-only use. Ask the agent to call
  18. `list_projects` to check which store it can see. Plugin skills use names such as
  19. `/weaverse:setup-weaverse-project`.
  20. Update with `claude plugin update weaverse@weaverse`; auto-update is off by default
  21. for third-party marketplaces. Enable it in `/plugin` → **Marketplaces** →
  22. **weaverse** → **Enable auto-update** ([guide](https://code.claude.com/docs/en/plugins/install#keep-plugins-updated)).
  23. Already installed the skills with `npx skills add`? Keep them and add just the
  24. store connection instead:
  25. ```bash
  26. claude mcp add --transport http weaverse https://mcp.weaverse.io/mcp
  27. ```
  28. ### Codex, Cursor, and Other Agents
  29. The skills-only installation is unchanged:
  30. ```bash
  31. npx skills add Weaverse/shopify-hydrogen-skills
  32. ```
  33. Select your agent and installation scope when prompted. Powered by [skills.sh](https://skills.sh).
  34. For store access, Codex, Cursor, and other MCP clients use the local
  35. `npx -y @weaverse/mcp` server with `WEAVERSE_API_KEY`. Create a Content API key
  36. in [Dashboard → Account → API Keys](https://studio.weaverse.io/dashboard/account),
  37. then follow the [per-agent connection steps](https://docs.weaverse.io/developer-tools/weaverse-mcp#client-configuration).
  38. Keep keys private and out of version control.
  39. Review or disconnect hosted access in
  40. [Dashboard → Account → Connected AI apps](https://studio.weaverse.io/dashboard/account).
  41. Revoke local-server API keys under **API Keys** on the same page.
  42. For older Claude Code versions and manual per-agent setup, see [INSTALL.md](INSTALL.md).
  43. ---
  44. ## Skills
  45. | Skill | What the agent learns | When to load |
  46. |-------|----------------------|--------------|
  47. | [`setup-weaverse-project`](./skills/setup-weaverse-project/SKILL.md) | Fast new-project onboarding — CLI-first scaffold, demo-store boot before credentials, generated `SESSION_SECRET`, GitHub repo, Builder preview connection | Starting a brand-new Weaverse Hydrogen storefront or running a theme locally for the first time |
  48. | [`shopify-hydrogen`](./skills/shopify-hydrogen/SKILL.md) | Core Hydrogen 2026.10 APIs — `server.ts` request lifecycle, `handleShopifyRoutes`, `storefront.graphql(gql())` with explicit cache, cart store, Customer Account handlers | Working with `@shopify/hydrogen` APIs |
  49. | [`weaverse-hydrogen`](./skills/weaverse-hydrogen/SKILL.md) | Weaverse components, schemas, loaders, theming, deployment | Any Hydrogen + Weaverse project |
  50. | [`hydrogen-cookbooks`](./skills/hydrogen-cookbooks/SKILL.md) | Step-by-step guides — bundles, combined listings, 3D models, customer accounts, performance | Building specific features |
  51. | [`hydrogen-upgrades`](./skills/hydrogen-upgrades/SKILL.md) | Breaking changes and migration steps for Hydrogen framework versions | Upgrading Hydrogen framework |
  52. | [`theme-update`](./skills/theme-update/SKILL.md) | Safe Pilot theme updates — detect version, plan changes, preserve customizations, verify build | Updating a customer's Pilot theme |
  53. | [`weaverse-integration`](./skills/weaverse-integration/SKILL.md) | Integrate Weaverse into an existing Hydrogen project — analyze codebase, convert components, set up SDK, configure routes | Adding Weaverse to a project that doesn't use it yet |
  54. | [`cloning-websites-to-weaverse`](./skills/cloning-websites-to-weaverse/SKILL.md) | Recreate reference websites as Hydrogen + Weaverse pages with preview checkpoints and section mapping | Cloning a site or brand hub into Weaverse |
  55. | [`figma-to-weaverse`](./skills/figma-to-weaverse/SKILL.md) | Turn a Figma design into Weaverse sections via Figma MCP — token mapping, component-state-driven interactions, content manifest, preview checkpoint, Playwright visual + hover/click check against Figma until PASS | Building a storefront from a Figma file |
  56. | [`generating-weaverse-project-json`](./skills/generating-weaverse-project-json/SKILL.md) | Generate import-ready Weaverse project export JSON from section plans, specs, or existing exports | Building Weaverse import files |
  57. | [`weaverse-content-api`](./skills/weaverse-content-api/SKILL.md) | Read/update Weaverse content over the REST Content API — live item edits, drafts and explicit publish/schedule/restore, translations, project lifecycle, Shopify resource upload | Updating a project's content, publishing flow, or translations via API |
  58. | [`hydrogen-analytics-tracking`](./skills/hydrogen-analytics-tracking/SKILL.md) | End-to-end tracking on Hydrogen — GTM, GA4 (browser + Measurement Protocol), Meta Pixel + CAPI, Google Ads, Consent Mode v2, CSP, Oxygen FPC, Weaverse webhook forwarding | Implementing analytics/conversion tracking on a Hydrogen storefront |
  59. | [`hydrogen-markets-localization`](./skills/hydrogen-markets-localization/SKILL.md) | End-to-end Shopify Markets localization — canonical market config, locale routing, Weaverse translations, RTL, cart/account/checkout continuity, SEO, and production readback | Adding or reviewing markets, locales, translations, hreflang, or localized commerce flows |
  60. ### Weaverse build pipeline
  61. The site-building skills chain from a source (website or Figma) to a live, maintainable Weaverse project:
  62. ```
  63. INPUT ADAPTERS GENERATE DELIVER
  64. cloning-websites-to-weaverse ┐
  65. ├─→ generating-weaverse-project-json ─→ import once into Studio (creates structure)
  66. figma-to-weaverse ┘ └─→ weaverse-content-api (updates content after,
  67. bulk edits, Shopify resource upload)
  68. ```
  69. Initial structure is created by importing the generated JSON, page-by-page via `POST /projects/:projectId/pages`, or as a whole project via the Content API's project lifecycle. Everything after — copy, images, localization, bulk edits, staged draft→publish flows — goes through the Content API, which updates existing items, adds new typed items, relinks children, creates/deletes pages, and restores versions.
  70. ---
  71. ## Live Docs
  72. Instead of baking static API docs into skill files (which go stale), this repo ships **live doc fetching scripts** that query official sources at runtime:
  73. ```bash
  74. # Search Shopify Hydrogen docs (shopify.dev)
  75. node skills/shopify-hydrogen/scripts/search_shopify_docs.mjs "handleShopifyRoutes"
  76. node skills/shopify-hydrogen/scripts/search_shopify_docs.mjs "createCartServerHandlers"
  77. # Search Weaverse docs (docs.weaverse.io)
  78. node skills/shopify-hydrogen/scripts/search_weaverse_docs.mjs "component schema"
  79. # Fetch a specific Weaverse doc page
  80. node skills/shopify-hydrogen/scripts/get_weaverse_page.mjs "development-guide/component-schema"
  81. # Check for Pilot theme updates
  82. node skills/theme-update/scripts/check_pilot_updates.mjs
  83. ```
  84. The `references/` folders in each skill serve as **offline fallback** — cached snapshots for when live search is unavailable.
  85. | Script | Source | Endpoint |
  86. |--------|--------|----------|
  87. | `shopify-hydrogen/scripts/search_shopify_docs.mjs` | shopify.dev | Hydrogen API search |
  88. | `shopify-hydrogen/scripts/search_weaverse_docs.mjs` | weaverse.io/docs | Weaverse docs search (Mintlify MCP) |
  89. | `shopify-hydrogen/scripts/get_weaverse_page.mjs` | weaverse.io/docs | Full page fetch by path |
  90. | `shopify-hydrogen/scripts/check_docs_helpers.mjs` | none | Helper boundary checks (offline) |
  91. | `theme-update/scripts/check_pilot_updates.mjs` | github.com | Pilot release version check |
  92. All scripts are **zero-dependency** — Node.js 18+ built-ins only.
  93. ---
  94. ## Repo Structure
  95. ```
  96. ├── skills/
  97. │ ├── setup-weaverse-project/ # New project setup from zero to local preview
  98. │ │ └── SKILL.md
  99. │ │
  100. │ ├── shopify-hydrogen/ # Core Hydrogen APIs
  101. │ │ ├── SKILL.md
  102. │ │ └── references/ # Setup, caching, cart patterns
  103. │ │
  104. │ ├── weaverse-hydrogen/ # Weaverse CMS integration
  105. │ │ ├── SKILL.md
  106. │ │ ├── references/ # 15 deep-dive guides
  107. │ │ └── examples/ # Production-ready component code
  108. │ │
  109. │ ├── hydrogen-cookbooks/ # Feature recipes
  110. │ │ ├── SKILL.md
  111. │ │ └── references/ # Bundles, combined listings, 3D, etc.
  112. │ │
  113. │ ├── hydrogen-upgrades/ # Framework version migrations
  114. │ │ ├── SKILL.md
  115. │ │ └── references/ # 2024.4.7 → … → 2026.10.2
  116. │ │
  117. │ ├── theme-update/ # Pilot theme updater
  118. │ ├── SKILL.md
  119. │ └── scripts/
  120. │ └── check_pilot_updates.mjs
  121. │
  122. │ ├── weaverse-integration/ # Integrate into existing Hydrogen
  123. │ └── SKILL.md
  124. │
  125. │ ├── cloning-websites-to-weaverse/ # Clone sites into Weaverse
  126. │ │ └── SKILL.md
  127. │
  128. │ ├── figma-to-weaverse/ # Figma design → Weaverse sections
  129. │ │ ├── SKILL.md
  130. │ │ └── references/ # Figma MCP extraction + token mapping
  131. │
  132. │ ├── generating-weaverse-project-json/ # Weaverse import JSON generator
  133. │ │ ├── SKILL.md
  134. │ │ ├── references/
  135. │ │ └── scripts/
  136. │
  137. │ ├── weaverse-content-api/ # Live content read/update over REST
  138. │ │ ├── SKILL.md
  139. │ │ ├── references/ # Endpoints + Portable Text
  140. │ │ └── scripts/
  141. │ │ └── weaverse_content_api.mjs
  142. │ │
  143. │ └── hydrogen-markets-localization/ # Markets and localization workflow
  144. │ ├── SKILL.md
  145. │ └── references/ # Verification checklist
  146. │
  147. ├── .cursorrules # Cursor agent rules
  148. ├── AGENTS.md # Repo guidance for AI agents
  149. ├── INSTALL.md # Manual per-agent install guide
  150. └── package.json
  151. ```
  152. ---
  153. ## Contributing
  154. PRs welcome — especially for:
  155. - New cookbooks (feature implementation guides)
  156. - Upgrade guides for newer Hydrogen versions
  157. - Improved offline references
  158. - New live doc scripts for other sources
  159. ## License
  160. MIT — [Weaverse](https://weaverse.io)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.