CtrlK
BlogDocsLog inGet started
Tessl Logo

shopify-dev

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

72

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-3

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

The content is a tight, single-purpose skill that gives an executable search command with clear scope and privacy guidance, respecting Claude's competence without padding.

DimensionReasoningScore

Conciseness

The body is lean and avoids explaining concepts Claude already knows; every line (overview, the mandatory search command, scope guard, and privacy notice) earns its place, with only a brief purposeful behavioral nudge rather than padding.

3 / 3

Actionability

It provides a fully executable, copy-paste-ready command with concrete arguments ('scripts/search_docs.mjs "<topic or feature name>" --model ... --client-name ...') plus specific guidance to search for the topic rather than the full prompt.

3 / 3

Workflow Clarity

This is a simple single-step skill whose one action (search before answering) is unambiguous and explicitly framed, which the rubric allows to score 3 for simple skills; no destructive or batch operation requires validation checkpoints.

3 / 3

Progressive Disclosure

At under 50 lines with no need for nested external references, the body is well organized into clear sections and references a real script (scripts/search_docs.mjs) one level deep, meeting the bar for simple skills.

3 / 3

Total

12

/

12

Passed

Description

75%Weight 40%Scale 1-3

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 is clear, third-person, and complete with an explicit 'Use when' clause, but it is light on concrete actions and natural trigger-term variation.

Suggestions

Name more concrete actions or outcomes (e.g., 'find field definitions, code examples, and API patterns') to lift specificity.

Add natural trigger phrasings users would say, such as 'Shopify docs', 'developer docs', or 'API reference', to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the action 'Search Shopify developer documentation' and the domain 'across all APIs', but only a single action is specified, matching the anchor for naming a domain and some actions without being comprehensive.

2 / 3

Completeness

It states what it does ('Search Shopify developer documentation across all APIs') and when to use it via an explicit 'Use only when no API-specific skill applies' clause, satisfying both what and when.

3 / 3

Trigger Term Quality

'Shopify developer documentation' and 'API-specific skill' are relevant terms but lean technical; common natural variations like 'Shopify docs', 'API reference', or 'developer docs' are missing.

2 / 3

Distinctiveness Conflict Risk

The 'Use only when no API-specific skill applies' trigger carves out a clear fallback niche and explicitly defers to API-specific skills, making conflicts unlikely.

3 / 3

Total

10

/

12

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.