CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

shopify-polaris-admin-extensions

Add custom actions and blocks from your app at contextually relevant spots throughout the Shopify Admin. Admin UI Extensions also supports scaffolding new adminextensions using Shopify CLI commands.

57

Quality

72%

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-polaris-admin-extensions/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 delivers highly actionable, fully executable guidance with an excellent validation-first workflow and error-recovery loop, but it is padded: the mandatory search/validate instructions are duplicated nearly verbatim and the entire component prop reference is inlined rather than split into a bundle file. A deduplicated, reference-offloaded version would be both leaner and easier to navigate.

Suggestions

State the search/validate workflow once — fold the "MANDATORY: Search" and "MANDATORY: Validate" sections into the top "Required Tool Calls" list and drop the duplicated flag/artifact-ID/revision explanations.

Move the full per-component prop catalog into a references/ file (e.g. references/components.md), keeping only a few representative examples inline in the body.

Place the bare "version: 2026-01" line into a proper frontmatter or "Version / deprecations" section so time-sensitive information is clearly framed.

DimensionReasoningScore

Conciseness

The search-then-validate workflow is stated twice almost verbatim (the "Required Tool Calls" numbered list vs. the "MANDATORY: Search Before Writing Code" / "MANDATORY: Validate Before Returning Code" sections, including duplicated artifact-ID and revision explanations), a stray "version: 2026-01" line sits mid-document with no deprecated/old-patterns framing, and ~50 lines inline every prop of every component. This is noticeably verbose with several padded sections (anchor 2); not 1 because the component props and target lists are information Claude does not already know.

2 / 5

Actionability

Everything is executable: exact CLI scaffold commands ("shopify app generate extension --template admin_action --name my-admin-action"), exact script invocations with every flag and placeholder-substitution rule, full component examples with concrete prop values, and an explicit error-fix-revalidate loop. Copy-paste ready and covers the common cases.

5 / 5

Workflow Clarity

The sequence is explicit and repeated consistently: search docs → write code → validate with required flags (including --target) → on failure, read the error, search for the named type, fix, re-validate (max 3 retries) → return code only after validation passes. An explicit validation checkpoint and a feedback loop for error recovery are both present, matching the anchor-5 example.

5 / 5

Progressive Disclosure

The body has clear section headers and both bundled scripts (scripts/search_docs.mjs, scripts/validate.mjs) are real and correctly referenced, but the full per-component prop catalog (~50 lines of every prop for every s-* component) is exactly the reference material that belongs in a separate file — anchor 3 (some structure, but content that should be separate is inline). Not 4 because no reference file offloads this bulk; not 2 because navigation via headers is straightforward.

3 / 5

Total

15

/

20

Passed

Description

61%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 states a concrete, well-scoped capability in the Shopify Admin extension domain but completely lacks any "when to use this" trigger guidance, which caps completeness at 3 and weakens its value for skill routing. Keyword coverage is otherwise good and the niche is fairly distinct. There is also a typo ("adminextensions") that slightly degrades readability.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks about Shopify admin extensions, admin actions, admin blocks, or building/embedding app UI in the Shopify admin."

Mention the other supported extension types (admin links, print actions) so the description's capability list matches what the skill actually covers.

Fix the "adminextensions" typo (missing space) and keep the description in third-person voice throughout.

DimensionReasoningScore

Specificity

"Add custom actions and blocks from your app at contextually relevant spots throughout the Shopify Admin" and "supports scaffolding new adminextensions using Shopify CLI commands" name the domain and two concrete actions, but coverage is incomplete — print actions, link extensions, and validation/search workflows supported by the skill are never mentioned. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, where gaps would be minor.

3 / 5

Completeness

The "what" is clear (add actions/blocks in Shopify Admin; scaffold extensions via CLI), but there is no "Use when..." clause or any equivalent explicit trigger guidance — the rubric explicitly caps this dimension at 3 in that case. Not 2 because the "what" is concrete rather than vague.

3 / 5

Trigger Term Quality

Includes natural user terms like "Shopify Admin", "Admin UI Extensions", "custom actions", "blocks", "scaffolding", and "Shopify CLI" — good keyword coverage. Not 5 because a few natural terms users would say are missing ("polaris", "admin block", "print action", "merchant").

4 / 5

Distinctiveness Conflict Risk

"Shopify Admin" plus "Admin UI Extensions" carves out a fairly distinct niche with low conflict risk against non-Shopify skills. Not 5, since anchor 5 expects explicit distinct trigger phrases (a "Use when..." clause), and there is minor overlap risk with closely related Shopify skills (e.g., checkout extensions or general Polaris design guidance).

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/shopify/skills/shopify-polaris-admin-extensions/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.