{
  "id": "skl_3e0b49174d3c",
  "slug": "skill-shopify-storefront-graphql",
  "asset_type": "skill",
  "name": "Shopify Storefront GraphQL Playbook",
  "tagline": "Use for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over da",
  "description_md": "### Overview & Capability Scope\n**Shopify Storefront GraphQL Playbook** (`skill-shopify-storefront-graphql`) is a verified, portable `SKILL.md` playbook curated with **@househackerjon** for Grok Bot (`x.ai/bot/`), Claude Code (`~/.claude/skills/`), and Cursor (`.cursor/skills/`).\n\nUse for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over data fetching and rendering your own UI\n\n### Required Stack & Tooling\n- **Primary Stack:** Shopify Admin GraphQL, Shopify CLI, Storefront API\n- **Category:** `sales-gtm`\n- **Source & Reference:** [https://shopify.dev/docs](https://shopify.dev/docs)\n\n### Quickstart Installation\nInstall this `SKILL.md` playbook directly into your agent workspace:\n```bash\nnpx lightstate install skill-shopify-storefront-graphql\n```\nOr copy the complete `SKILL.md` specification below into `.cursor/skills/skill-shopify-storefront-graphql/SKILL.md` or `~/.claude/skills/skill-shopify-storefront-graphql/SKILL.md`.\n\n### Verification Commands\n```bash\nshopify app info\nshopify app dev\nshopify app deploy\n```\n",
  "primary_category": "sales-gtm",
  "categories_json": "[\"sales-gtm\", \"skills\"]",
  "tags_json": "[\"shopify-admin-graphql\", \"shopify-cli\", \"storefront-api\", \"skill-md\", \"sales-gtm\"]",
  "compatible_agents_json": "[\"grok-bot\", \"claude-code\", \"cursor\"]",
  "integrations_json": "[\"Shopify Admin GraphQL\", \"Shopify CLI\", \"Storefront API\"]",
  "includes_json": "[]",
  "safety_level": "Read-Only / Ask-First",
  "safety_summary": "Verified capability blueprint by @househackerjon.",
  "share_url": "",
  "deep_link_uri": "",
  "mcp_endpoint": "",
  "mcp_transport": "http",
  "install_command": "npx lightstate install skill-shopify-storefront-graphql",
  "skill_markdown": "---\nname: shopify-storefront-graphql\ndescription: Use for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over data fetching and rendering your own UI Use when working with Shopify Admin GraphQL, Shopify CLI, Storefront API.\ntriggers:\n  - shopify storefront graphql\n  - shopify admin graphql\n  - shopify cli\n---\n\n# Shopify Storefront GraphQL Playbook\n\n## 1. When to Use This Skill\nLoad `skill-shopify-storefront-graphql` whenever an engineering, architecture, or operations task involves **Shopify Admin GraphQL, Shopify CLI, Storefront API**. Specifically:\n- Use for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over data fetching and rendering your own UI\n- Designing, reviewing, refactoring, or debugging production configurations without guesswork or deprecated flags.\n- Running deterministic pre-flight validation and post-execution verification checks before reporting completion.\n\n## 2. Prerequisites & Required Environment\n- **Target Stack:** Shopify Admin GraphQL, Shopify CLI, Storefront API\n- **Permissions Boundary:** Read-only inspection by default; ask for explicit human confirmation before executing destructive mutations or production deployments.\n- **Reference Specification:** `https://shopify.dev/docs`\n\n## 3. Step-by-Step Execution Playbook\n1. **Context & Configuration Discovery:**\n   Inspect existing project manifests (`package.json`, `tsconfig.json`, `pyproject.toml`, `Cargo.toml`, `wrangler.jsonc`, or schema declarations) before proposing changes. Never overwrite existing bindings or credentials blindly.\n2. **Deterministic Implementation:**\n   Apply the canonical production patterns for **Shopify Admin GraphQL**:\n   - Enforce strict schema and type validation at every external boundary.\n   - Include explicit error handling, structured telemetry, and idempotency keys on all mutating calls.\n   - Keep secrets in environment variables or managed secret stores—never hardcode tokens in source files.\n3. **Verification & Regression Gate:**\n   Run the verification commands below and inspect both exit codes and output payloads before marking the task complete.\n\n## 4. Reference Commands & CLI Workflow\n```bash\nshopify app info\nshopify app dev\nshopify app deploy\n```\n\n## 5. Edge Cases & Anti-Hallucination Guardrails\n- **Zero Unverified Claims:** Never claim a build, migration, test run, or API call succeeded without inspecting the command output or HTTP status code.\n- **Rollback Readiness:** Always record the previous state or migration version so changes can be reverted cleanly if downstream health checks fail.\n",
  "starter_prompt": "Load the Shopify Storefront GraphQL Playbook (skill-shopify-storefront-graphql) playbook. First inspect our current configuration and codebase for Shopify Admin GraphQL, Shopify CLI, Storefront API. Then propose a concrete, step-by-step implementation plan following the skill-shopify-storefront-graphql guardrails, run the non-destructive verification commands (shopify app info), and summarize any findings, risks, or required environment variables before making production changes.",
  "project_url": "https://shopify.dev/docs",
  "repo_url": "https://shopify.dev/docs",
  "creator_handle": "househackerjon",
  "creator_name": "Jon O'Neill (@HouseHackerJon)",
  "creator_avatar_url": null,
  "creator_url": "https://x.com/househackerjon",
  "creator_platform": "x",
  "creator_cal_url": null,
  "claimed_by_user_id": null,
  "scouted_by_handle": null,
  "source_url": "https://shopify.dev/docs",
  "source_tweet_id": null,
  "source_origin": "certified_builder",
  "source_posted_at": null,
  "x_likes": 218,
  "x_bookmarks": 364,
  "x_retweets": 91,
  "x_views": 3052,
  "human_upvotes": 218,
  "human_installs": 218,
  "bot_pulls": 364,
  "pulse_score": 85,
  "gravity_rank_score": 1630.5,
  "is_featured": 0,
  "is_verified": 1,
  "is_sponsored": 0,
  "sponsor_tier": "free",
  "sponsor_label": "",
  "sponsor_cta_url": "",
  "sponsor_expires_at": null,
  "commercial_intent_score": 0,
  "status": "active",
  "created_at": "2026-10-24T22:25:00Z",
  "updated_at": "2026-10-24T22:25:00Z",
  "verified_at": null,
  "primitive": "skill",
  "title": "Shopify Storefront GraphQL Playbook",
  "description": "Use for custom storefronts requiring direct GraphQL queries/mutations for data fetching and cart operations. Choose this when you need full control over da",
  "category": "sales-gtm",
  "tags": "[\"shopify-admin-graphql\", \"shopify-cli\", \"storefront-api\", \"skill-md\", \"sales-gtm\"]",
  "agent_compatibility": "[\"grok-bot\", \"claude-code\", \"cursor\"]",
  "author_handle": "househackerjon",
  "author_name": "Jon O'Neill (@HouseHackerJon)",
  "author_avatar": null,
  "source_tweet_url": "https://shopify.dev/docs",
  "github_url": "https://shopify.dev/docs",
  "external_url": "https://shopify.dev/docs",
  "upvotes_count": 218,
  "installs_count": 218
}