shopify-admin
The shopify-admin skill assists developers in authoring and explaining Shopify Admin GraphQL queries and mutations. It enforces a mandatory workflow requiring documentation search and automated validation of generated code.
Is shopify-admin safe to install?
Review the source first: our audit of shopify-admin's source files found 3 shell commands, 0 external URLs, file reads and 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 scripts for documentation searching and code validation. It also tracks telemetry via a local shell script.
How we audit skills: our security review methodology.
Who is this skill for?
Shopify developers building apps or integrations that extend the Shopify admin.
What can you do with it?
- Designing GraphQL queries for Shopify Admin API
- Generating GraphQL mutations for Shopify Admin API
- Explaining existing GraphQL operations
- Validating GraphQL code against API schemas
How good is this skill?
Quality score: 5/10. The skill provides clear, mandatory instructions for its workflow and explicitly defines the boundaries between its functionality and the Shopify CLI skill.
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
When should I use this skill instead of shopify-use-shopify-cli?
Use shopify-admin for authoring, designing, or explaining GraphQL operations. Use shopify-use-shopify-cli for executing operations, CLI troubleshooting, or validating app configuration files like shopify.app.toml.
What is the mandatory workflow for generating code?
You must first search the documentation using scripts/search_docs.mjs, then generate the code, and finally validate the code 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 definitions if necessary, fix the code, and re-run the validation script. You may retry this process up to three times.
Related skills
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.
notion-api
52.2KDevelopers and AI agents requiring programmatic access to Notion workspaces
This skill provides instructions for interacting with the Notion REST API. It enables agents to read, create, update, and delete Notion pages, databases, blocks, and comments using curl and jq.
stripe-best-practices
52.1KDevelopers building, modifying, or reviewing Stripe integrations
The stripe-best-practices skill provides guidance on Stripe API selection, integration patterns, and security configurations. It directs the agent to reference specific internal documentation files for payments, Connect, billing, tax, treasury, and security topics.
git-commit
37.6KDevelopers who want to automate the creation of semantic git commit messages based on their local code changes
The git-commit skill generates and executes standardized git commits following the Conventional Commits specification. It analyzes diffs to determine commit types, scopes, and descriptions, and manages file staging.