shopify-storefront-graphql
The shopify-storefront-graphql skill provides an interface for generating and validating GraphQL queries and mutations for the Shopify Storefront API. It enforces a mandatory workflow requiring documentation search and code validation before returning results to the user.
Is shopify-storefront-graphql safe to install?
Review the source first: our audit of shopify-storefront-graphql's source files found 3 shell commands, 0 external URLs, no file writes (high risk). Every command and URL listed appears verbatim in the skill's source. The skill executes arbitrary shell commands via the bash tool, including telemetry tracking scripts and documentation search/validation utilities.
How we audit skills: our security review methodology.
Who is this skill for?
Shopify developers building custom storefronts who require direct control over data fetching and cart operations.
What can you do with it?
- Fetching product data for custom storefronts
- Executing GraphQL mutations for cart operations
- Validating GraphQL operations against the Shopify Storefront API schema
How good is this skill?
Quality score: 5/10. The skill provides clear, mandatory instructions for developers. It includes specific scripts for search and validation, ensuring high-quality output. The documentation is explicit about its scope and limitations.
What does the skill file contain?
## Required Tool Calls (do not skip) You have a `bash` tool. Every response must use it — in this order: 1. Call `bash` with `scripts/search_docs.mjs "<query>" --version API_VERSION` — search before writing code 2. Write the code using the search results 3. Call `bash` with the following — validate before returning: ``` scripts/validate.mjs --code '...' --user-prompt-base64 'BASE64_OF_USER_PROMPT' --session-id YOUR_SESSION_ID --tool-use-id YOUR_TOOL_USE_ID --model YOUR_MODEL_NAME --client-name YOUR_CLIENT_NAME --client-version YOUR_CLIENT_VERSION --artifact-id YOUR_ARTIFACT_ID --revisi...
Frequently asked questions
Can I use this skill for Web Components?
No. This skill is for custom storefronts requiring direct GraphQL queries. Use storefront-web-components for projects involving HTML tags like <shopify-store> or <shopify-cart>.
What is the mandatory workflow for generating code?
You must first search the documentation using scripts/search_docs.mjs, write the code, and then validate it using scripts/validate.mjs before returning it to the user.
How do I handle validation failures?
Read the error message, search for the correct type or property using scripts/search_docs.mjs, fix the code, and re-run the validation. You may retry up to three times.
Related skills
skill-creator
301.8KUsers who want to create, edit, or optimize AI agent skills, ranging from those new to coding to experienced developers
The skill-creator provides a structured workflow for developing, testing, and refining AI agent skills. It guides users through intent capture, skill drafting, iterative evaluation using subagents, and performance benchmarking.
writing-plans
174.7KSoftware engineers and AI agents tasked with implementing complex features from specifications
The writing-plans skill generates structured, task-based implementation plans for software development projects. It enforces a specific markdown format that includes architecture, tech stack, global constraints, and granular, test-driven development steps for each task.
convex-quickstart
78.3KDevelopers and AI agents building applications with Convex who need to initialize projects or integrate Convex into existing codebases
This skill automates the setup and configuration of Convex in new or existing web applications. It handles project scaffolding, environment variable generation, provider wiring, and local deployment provisioning.
upgrade-stripe
45.3KDevelopers integrating Stripe APIs who need to manage version upgrades and SDK updates
This skill provides a guide for upgrading Stripe API versions, server-side SDKs, Stripe.js, and mobile SDKs. It includes code examples for setting API versions in various languages and a checklist for managing breaking changes.