convez.ai
SkillDesenvolvimento WebIntermediário
Weaverse

Shopify Hydrogen Skills

Weaverse/shopify-hydrogen-skills

Skills para desenvolvimento de storefronts Hydrogen + Weaverse com agentes IA

Ver no GitHub
BomPluginScore · de 0 a 100

Conjunto de skills otimizadas para agentes de IA construírem, manterem e atualizarem storefronts Shopify Hydrogen com Weaverse. Funciona com Claude, Cursor, Copilot e outros agentes, fornecendo guias estruturados para APIs core, integração Weaverse, migrações e implementação de analytics.

Instalação

$npx convez-ai Weaverse/shopify-hydrogen-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
44
Forks
2
Acompanhando
0
Saúde
25%
Último commit
há 2 dias
Versão
v2026.6.12
Issues abertas
12
Contribuidores
3

Casos de uso

  • Construir storefronts Shopify Hydrogen com APIs core e componentes Weaverse
  • Migrar e atualizar projetos Hydrogen entre versões
  • Integrar Weaverse em projetos Hydrogen existentes
  • Implementar tracking de analytics (GTM, GA4, Meta Pixel) em storefronts
  • Clonar websites e criar páginas customizadas em Hydrogen + Weaverse

Veredito

Skill bem-estruturada e prática para agentes trabalharem com o stack Shopify Hydrogen + Weaverse. Aborda casos reais (migrations, analytics, integrações) com referências dinâmicas que evitam desatualização. Ideal para desenvolvedores que trabalham com commerce headless.

README

A tradução para o português deste README ainda está na fila.

Shopify Hydrogen Skills

Agent skills for building, maintaining, and upgrading Shopify Hydrogen storefronts with Weaverse. Works with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenCode, OpenClaw, Gemini CLI, and any agent that supports markdown skill files.

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.

Quick Install

npx skills add Weaverse/shopify-hydrogen-skills

Auto-detects your coding agents and installs to all of them. Powered by skills.sh.

For manual per-agent setup, see INSTALL.md.


Skills

SkillWhat the agent learnsWhen to load
shopify-hydrogenCore Hydrogen APIs — createHydrogenContext, cart handler, caching, pagination, SEO, CSPWorking with @shopify/hydrogen APIs
weaverse-hydrogenWeaverse components, schemas, loaders, theming, deploymentAny Hydrogen + Weaverse project
hydrogen-cookbooksStep-by-step guides — bundles, combined listings, 3D models, customer accounts, performanceBuilding specific features
hydrogen-upgradesBreaking changes and migration steps for Hydrogen framework versionsUpgrading Hydrogen framework
theme-updateSafe Pilot theme updates — detect version, plan changes, preserve customizations, verify buildUpdating a customer's Pilot theme
weaverse-integrationIntegrate Weaverse into an existing Hydrogen project — analyze codebase, convert components, set up SDK, configure routesAdding Weaverse to a project that doesn't use it yet
cloning-websites-to-weaverseRecreate reference websites as Hydrogen + Weaverse pages with preview checkpoints and section mappingCloning a site or brand hub into Weaverse
generating-weaverse-project-jsonGenerate import-ready Weaverse project export JSON from section plans, specs, or existing exportsBuilding Weaverse import files
hydrogen-analytics-trackingEnd-to-end tracking on Hydrogen — GTM, GA4 (browser + Measurement Protocol), Meta Pixel + CAPI, Google Ads, Consent Mode v2, CSP, Oxygen FPC, Weaverse webhook forwardingImplementing analytics/conversion tracking on a Hydrogen storefront

Live Docs

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:

# Search Shopify Hydrogen docs (shopify.dev)
node scripts/search_shopify_docs.mjs "createHydrogenContext"
node scripts/search_shopify_docs.mjs "CartForm actions"

# Search Weaverse docs (docs.weaverse.io)
node scripts/search_weaverse_docs.mjs "component schema"

# Fetch a specific Weaverse doc page
node scripts/get_weaverse_page.mjs "development-guide/component-schema"

# Check for Pilot theme updates
node skills/theme-update/scripts/check_pilot_updates.mjs

The references/ folders in each skill serve as offline fallback — cached snapshots for when live search is unavailable.

ScriptSourceEndpoint
search_shopify_docs.mjsshopify.devHydrogen API search
search_weaverse_docs.mjsdocs.weaverse.ioWeaverse docs search (Mintlify MCP)
get_weaverse_page.mjsdocs.weaverse.ioFull page fetch by path
check_pilot_updates.mjsgithub.comPilot release version check

All scripts are zero-dependency — Node.js 18+ built-ins only.


Repo Structure

├── skills/
│   ├── shopify-hydrogen/          # Core Hydrogen APIs
│   │   ├── SKILL.md
│   │   └── references/            # Setup, caching, cart patterns
│   │
│   ├── weaverse-hydrogen/         # Weaverse CMS integration
│   │   ├── SKILL.md
│   │   ├── references/            # 13 deep-dive guides
│   │   └── examples/              # Production-ready component code
│   │
│   ├── hydrogen-cookbooks/        # Feature recipes
│   │   ├── SKILL.md
│   │   └── references/            # Bundles, combined listings, 3D, etc.
│   │
│   ├── hydrogen-upgrades/         # Framework version migrations
│   │   ├── SKILL.md
│   │   └── references/            # 2024.4.7 → … → 2026.1.0
│   │
│   ├── theme-update/              # Pilot theme updater
│       ├── SKILL.md
│       └── scripts/
│           └── check_pilot_updates.mjs
│
│   ├── weaverse-integration/      # Integrate into existing Hydrogen
│       └── SKILL.md
│
│   ├── cloning-websites-to-weaverse/      # Clone sites into Weaverse
│   │   └── SKILL.md
│
│   └── generating-weaverse-project-json/  # Weaverse import JSON generator
│       ├── SKILL.md
│       ├── references/
│       └── scripts/
│
├── scripts/                       # Live doc fetching (shared)
│   ├── search_shopify_docs.mjs
│   ├── search_weaverse_docs.mjs
│   └── get_weaverse_page.mjs
│
├── .cursorrules                   # Cursor agent rules
├── AGENTS.md                      # Repo guidance for AI agents
├── INSTALL.md                     # Manual per-agent install guide
└── package.json

Contributing

PRs welcome — especially for:

  • New cookbooks (feature implementation guides)
  • Upgrade guides for newer Hydrogen versions
  • Improved offline references
  • New live doc scripts for other sources

License

MIT — Weaverse

Ver o original no GitHub

Bom para

Relacionados