CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

shopify-use-shopify-cli

Choose when the user needs **Shopify CLI** to run or fix something now: validate app or extension config on disk (`shopify.app.toml`, `shopify.app.<name>.toml`, `shopify.extension.toml`); run or troubleshoot store workflows (`shopify store auth`, `shopify store execute`); inventory or product changes by handle, SKU, or location name; or CLI setup, auth, upgrade issues. Emphasize **commands and operational steps**, not only authoring GraphQL. Skip for API-only understanding or codegen with no CLI execution. Examples: validate configuration before deploy; run an existing query via CLI; list products; missing `shopify store execute`.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong operational skill body: copy-paste-ready commands, clear command-discovery guidance, and well-scoped workflows with explicit constraints. Weak points are minor redundancy in the prohibition lists, a missing fix-and-retry loop for failed config validation, and no offloading of the long store-execution contract to a reference file.

Suggestions

Add an explicit error-recovery step after `shopify app config validate --json` (read the JSON errors, fix the named TOML fields, re-run) to close the validation feedback loop.

Deduplicate the upgrade guidance and the repeated prohibition lists (e.g., merge the description-echo paragraph's 'not validate_graphql_codeblocks' with the Constraints section) to tighten conciseness.

Move the detailed store-execution bullet contract to a references/ file (e.g., STORE-EXECUTION.md) and keep a short summary plus the primary command pair in SKILL.md.

DimensionReasoningScore

Conciseness

The body is dense operational guidance with concrete commands and almost no concept explanation Claude already knows, but there are minor trimmable redundancies — "Upgrade to the latest version: `shopify upgrade`" followed immediately by "If a command is missing or unrecognized, the user may need to upgrade... by running `shopify upgrade`", and several prohibitions repeated across the description-echo paragraph and the Constraints/Store execution constraints lists. That matches 'Efficient; minor instances of over-explanation that could be trimmed' rather than the 5 anchor's every-token-earns-its-place.

4 / 5

Actionability

Fully executable, copy-paste-ready commands cover the common cases: `npm install -g @shopify/cli@latest`, `shopify app config validate --json` (with `--path`/`--config` handling), `shopify store auth --store <store-domain> --scopes <scopes>`, `shopify store execute --store <store-domain> --query '...'`, and a complete env-prefixed attribution example — matching the 5 anchor.

5 / 5

Workflow Clarity

The "Order of operations" section gives a numbered sequence for config validation, and the store execution flow is explicitly sequenced (auth before execute, validate the query, inspect `Required scopes:` output). However, there is no explicit fix-and-retry feedback loop — e.g., what to do when `shopify app config validate --json` reports errors — which keeps it at 'clear sequence with most checkpoints present; minor validation gaps' rather than the 5 anchor's explicit error-recovery loops.

4 / 5

Progressive Disclosure

The body is well-organized with clear section headers (Setup, CLI Usage, analytics attribution, App configuration validation, Store execution contract) and points to the external Shopify CLI docs rather than inlining them. At ~126 lines with no bundle files, some content (e.g., the long store-execution bullet contract) is inlined where a separate reference file could carry it, matching the 4 anchor's 'most content appropriately placed; minor organization gaps' rather than a clean one-level-deep split.

4 / 5

Total

17

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capabilities, natural trigger phrases, and explicit boundaries including a skip clause. The only deduction is the imperative/second-person opening, which costs one specificity point under the rubric's voice rule.

Suggestions

Convert the opening to third person (e.g., "Runs and troubleshoots Shopify CLI workflows: ...") to satisfy the voice rule and recover the specificity point.

DimensionReasoningScore

Specificity

Phrases like "validate app or extension config on disk (`shopify.app.toml`, `shopify.app.<name>.toml`, `shopify.extension.toml`)", "run or troubleshoot store workflows (`shopify store auth`, `shopify store execute`)", and "inventory or product changes by handle, SKU, or location name" list multiple concrete, comprehensive actions — a 5 anchor — but the opening imperative "Choose when the user needs..." is second-person voice rather than the required third person, so the rubric's 1-point specificity penalty applies (4).

4 / 5

Completeness

"Choose when the user needs **Shopify CLI** to run or fix something now" plus the enumerated capabilities explicitly answers 'what', and the trigger clause, "Examples:" list, and explicit skip boundary ("Skip for API-only understanding or codegen with no CLI execution") answer 'when' with concrete trigger phrases — the 5 anchor.

5 / 5

Trigger Term Quality

Natural user-facing phrases ("validate configuration before deploy", "list products", "missing `shopify store execute`") plus concrete file names (`shopify.app.toml`, `shopify.extension.toml`), commands, and synonyms (setup, auth, upgrade, run, troubleshoot) give comprehensive coverage including file extensions, matching the 5 anchor; it is not a 4 because no common phrasing for this need is obviously missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche (CLI execution vs. API work) with explicit carve-outs — "Emphasize **commands and operational steps**, not only authoring GraphQL" and "Skip for API-only understanding or codegen" — minimizes conflict with adjacent skills, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/shopify/skills/shopify-use-shopify-cli/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.