← Back to Skills Marketplace
127
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install shopify-ai-toolkit-skill
Description
Search Shopify developer docs and validate GraphQL, Liquid, Hydrogen, and other Shopify code for app, theme, or storefront development tasks.
Usage Guidance
This skill is functionally coherent with its description, but it includes telemetry that will send your search queries and validation results (and likely any code you pass to the validators) to a Shopify endpoint by default. Before installing or using it:
- If you do not want telemetry, set OPT_OUT_INSTRUMENTATION=true in the environment (the scripts honor this). Consider also overriding SHOPIFY_DEV_INSTRUMENTATION_URL only if you control the receiver.
- Do not submit private credentials, secrets, or proprietary store code to the skill unless you are comfortable that data will be sent to shopify.dev.
- Be aware of a metadata inconsistency: SKILL.md declares the instrumentation vars under requires.env (suggesting they are required), but the README and scripts treat them as optional — confirm desired behavior.
- If you need stronger guarantees, inspect or remove the reportValidation calls in the scripts (they are easy to find: instrumentation.ts → reportValidation) or run the scripts in an isolated environment (air-gapped or with telemetry disabled) after reviewing the code.
I mark this as 'suspicious' (medium confidence) because the telemetry behavior is explicit in the scripts and could leak user-supplied code, and because the skill's metadata/documentation about the env vars is inconsistent. If you can confirm you will always opt out of instrumentation (or host the telemetry receiver yourself) and you review the validate scripts to ensure no other unexpected exfiltration exists, the remaining concerns are largely mitigable.
Capability Analysis
Type: OpenClaw Skill
Name: shopify-ai-toolkit-skill
Version: 1.1.0
The Shopify AI Toolkit skill bundle provides a legitimate set of tools for Shopify development, including documentation search and code validation for various APIs (Admin, Storefront, Liquid, Hydrogen, etc.). The bundle includes an instrumentation feature in the `reportValidation` function (found in multiple scripts like `search_docs.mjs` and `validate.mjs`) that sends usage data, including search queries and code snippets, to `https://shopify.dev/`. This behavior is clearly aligned with the stated purpose of a developer toolkit, is explicitly documented in the `README.md` and `SKILL.md` files, and provides a documented opt-out mechanism via the `OPT_OUT_INSTRUMENTATION` environment variable. No malicious intent, unauthorized exfiltration to third-party domains, or persistence mechanisms were detected.
Capability Tags
Capability Assessment
Purpose & Capability
The name/description match the repository contents: many sub-skill scripts implement search_docs and validate workflows for Admin, Storefront, Liquid, Hydrogen, Functions, etc. The large validate/search scripts align with the stated purpose of searching docs and validating code.
Instruction Scope
The included scripts perform two external actions: (1) POST to https://shopify.dev/assistant/search to fetch doc results, and (2) POST telemetry to /mcp/usage on the SHOPIFY_DEV_BASE_URL. The telemetry call (reportValidation) transmits 'remainingContext' (which in search includes the user query) and the validation/search result. The validate scripts accept --code / other inputs; those inputs appear to flow into the same reporting mechanism, so user-submitted code or queries can be sent to an external endpoint. The SKILL.md and README show an opt-out (OPT_OUT_INSTRUMENTATION) but the skill's metadata lists the two instrumentation env names under requires.env (inconsistent with README's 'optional' wording).
Install Mechanism
There is no install spec (instruction-only), so nothing is automatically downloaded during install — lowest-risk install model. The package contains many JS files (some bundled deps embedded in validate.mjs) and an install-deps.sh and package.json recommending npm install for Liquid validation. No remote archive downloads or URL shorteners are present in install steps. Build/dependency material is self-contained or resolved via normal npm if the user chooses to run npm install.
Credentials
The skill does not request any secrets/credentials for Shopify APIs, which is appropriate. However: (a) SKILL.md metadata lists SHOPIFY_DEV_INSTRUMENTATION_URL and OPT_OUT_INSTRUMENTATION under requires.env whereas the README and scripts treat them as optional configuration. (b) The telemetry/reporting functionality will send user queries and validation/search results (and likely any '--code' payloads passed into validators) to the SHOPIFY_DEV_BASE_URL unless OPT_OUT_INSTRUMENTATION is set — this is disproportionate if the user expects offline/local validation or if they will pass private store data, tokens, or proprietary code to the validator.
Persistence & Privilege
The skill does not request always:true, does not require persistent system modifications, and does not modify other skills or system-wide agent settings. It runs as a normal user-invoked (or autonomously-invokable) skill, which is the platform default.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install shopify-ai-toolkit-skill - After installation, invoke the skill by name or use
/shopify-ai-toolkit-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
- Added required environment variables metadata for OpenClaw integration: `SHOPIFY_DEV_INSTRUMENTATION_URL` and `OPT_OUT_INSTRUMENTATION`
- No changes to user-facing setup or documentation content
v1.0.0
Shopify AI Toolkit for OpenClaw – Initial Release
- Search Shopify developer documentation and validate code for app, theme, or storefront development.
- Includes specialized sub-skills: shopify-admin, shopify-storefront-graphql, shopify-liquid, shopify-hydrogen, shopify-functions, shopify-custom-data, shopify-customer, and shopify-polaris-extensions.
- Enforces a “search → validate → return” workflow for accuracy and reliability.
- Supports both Node.js script execution and optional integration with the Shopify Dev MCP server via Codex CLI.
- Guidance provided for choosing the right sub-skill for specific Shopify development tasks.
Metadata
Frequently Asked Questions
What is Shopify AI Toolkit?
Search Shopify developer docs and validate GraphQL, Liquid, Hydrogen, and other Shopify code for app, theme, or storefront development tasks. It is an AI Agent Skill for Claude Code / OpenClaw, with 127 downloads so far.
How do I install Shopify AI Toolkit?
Run "/install shopify-ai-toolkit-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Shopify AI Toolkit free?
Yes, Shopify AI Toolkit is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Shopify AI Toolkit support?
Shopify AI Toolkit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Shopify AI Toolkit?
It is built and maintained by John Chan (@jtcchan); the current version is v1.1.0.
More Skills