CtrlK
BlogDocsLog inGet started
Tessl Logo

shopify-dev

Search Shopify developer documentation across all APIs. Use only when no API-specific skill applies.

63

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./plugins/shopify/skills/shopify-dev/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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.

The body is an efficient, actionable, well-structured single-purpose skill that points correctly to its one bundle script, with only minor room to tighten phrasing and make the answer step explicit.

DimensionReasoningScore

Conciseness

The body is lean — a one-line purpose, an executable command, and a brief privacy notice — with only mild over-explanation in "You cannot trust your trained knowledge" that could be trimmed, matching the efficient-with-minor-trim anchor.

4 / 5

Actionability

It provides a complete, copy-paste-ready command with the real script path and all required arguments, covering the single common case, matching the fully-executable anchor.

5 / 5

Workflow Clarity

As a simple single-action skill the search step is unambiguous and correctly instructs searching the topic name rather than the full prompt, but it does not explicitly sequence the follow-on 'use the results to answer' step, fitting clear-with-a-minor-gap.

4 / 5

Progressive Disclosure

Under 50 lines and well-organized with a clear section header, it references the real one-level-deep script (scripts/search_docs.mjs, verified present) inline via a code block, matching the well-organized simple-skill anchor.

5 / 5

Total

18

/

20

Passed

Description

62%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.

The description clearly communicates purpose and includes an explicit use-condition with named sibling skills, but its single-action scope and sparse natural trigger terms keep it from the top tier.

Suggestions

Add concrete user-stated trigger phrases to the 'when' clause (e.g., 'Use when the user asks about Shopify APIs and no single API matches').

Include natural synonyms such as 'Shopify docs' or 'API reference' alongside 'developer documentation' to improve trigger term coverage.

Consider naming a second concrete capability (e.g., retrieving field/type definitions or valid values) to raise specificity beyond the single 'Search' action.

DimensionReasoningScore

Specificity

The phrase "Search Shopify developer documentation across all APIs" names the domain and one concrete action (search), but offers no further actions, matching the anchor for a clear-but-not-comprehensive single action.

3 / 5

Completeness

It states both what ("Search Shopify developer documentation across all APIs") and when ("Use only when no API-specific skill applies"), but the when clause could tie more explicitly to concrete user-stated trigger phrases rather than a fallback condition.

4 / 5

Trigger Term Quality

It surfaces relevant terms like "Shopify developer documentation" and "API" but omits natural synonyms users would actually say (e.g., "Shopify docs", "API reference"), fitting the anchor for some relevant keywords with missing variations.

3 / 5

Distinctiveness Conflict Risk

The explicit "Use only when no API-specific skill applies" carve-out plus named alternatives (shopify-admin-graphql, shopify-liquid, etc.) make it mostly distinct, though the broad "across all APIs" scope leaves minor overlap risk with those closely related skills.

4 / 5

Total

14

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
openai/plugins
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.