CtrlK
BlogDocsLog inGet started
Tessl Logo

shopify-partner

The Partner API lets you programmatically access data about your Partner Dashboard, including your apps, themes, and affiliate referrals.

59

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

85%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 body delivers a crisp, well-sequenced workflow with concrete executable commands, an explicit validation feedback loop, and clean externalization of API detail to the bundled search corpus. Its only real weakness is redundancy from restating the mandatory search/validate workflow and privacy notices multiple times.

DimensionReasoningScore

Conciseness

The body is action-oriented with no basic-concept padding, but the search→validate workflow is restated across the 'Required Tool Calls' and both 'MANDATORY' sections, and the flag explanations and two privacy notices are duplicated, so it could be tightened.

2 / 3

Actionability

It provides concrete, executable commands ('scripts/search_docs.mjs "transactions query"', 'scripts/validate.mjs' with a full flag set), a specific example query, and an explicit retry loop; the referenced scripts are real and the placeholders are explained, so it is copy-paste ready.

3 / 3

Workflow Clarity

A clear numbered sequence (search → write → validate → on failure search/fix/revalidate, max 3 retries → return only when valid) with an explicit validation checkpoint and a validate→fix→retry feedback loop matches the top anchor.

3 / 3

Progressive Disclosure

The body is a lean overview-plus-workflow with clearly signaled one-level-deep references to the real scripts (full paths in code blocks), and the bulk API detail is appropriately externalized to the bundled searchable corpus rather than inlined.

3 / 3

Total

11

/

12

Passed

Description

50%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 clearly identifies the Shopify Partner API domain and its data objects but stops short of listing multiple concrete actions and omits any explicit 'Use when...' trigger guidance. It is competent but generic, leaving Claude without clear invocation cues.

Suggestions

Add an explicit 'Use when...' trigger clause, e.g. 'Use when the user asks about Shopify Partner Dashboard data — apps, themes, affiliate referrals, or partner-level GraphQL queries.'

Replace the generic 'access data' with concrete actions ('query app revenue', 'list theme versions', 'retrieve affiliate referrals and payouts') to lift specificity.

Broaden trigger term coverage to include natural variations users would say: 'Shopify Partner API', 'Partner Dashboard', 'partner GraphQL', 'affiliate referrals'.

DimensionReasoningScore

Specificity

It names a concrete domain ('Partner Dashboard') and data objects ('apps, themes, and affiliate referrals') but the only action is the generic 'access data' rather than a list of multiple specific concrete actions, so it is not comprehensive enough for a 3.

2 / 3

Completeness

It clearly states what the skill does ('programmatically access data about your Partner Dashboard') but has no 'Use when...' clause or equivalent explicit trigger guidance, which per the guidelines caps completeness at 2.

2 / 3

Trigger Term Quality

'Partner API', 'Partner Dashboard', 'apps', 'themes', and 'affiliate referrals' are natural terms a developer might say, but common variations like 'Shopify Partner', 'GraphQL', or 'partner dashboard queries' are missing.

2 / 3

Distinctiveness Conflict Risk

'affiliate referrals' and 'Partner Dashboard' form a fairly distinct niche, but without explicit differentiating triggers it could still overlap with general Shopify Admin/Store API skills.

2 / 3

Total

8

/

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.