# shopify-polaris-admin-extensions

A skill that steers Claude through building Shopify admin UI extensions: look up the docs, write Polaris code, then validate it before you get an answer.

- skill · `type=skill` · Codex, ChatGPT · ★ 7604
- Author: Shopify · official OpenAI repository
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-polaris-admin-extensions/SKILL.md
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/skills/shopify-polaris-admin-extensions

## What it does

The skill covers the four extension types Shopify apps can add to the admin: action, block, link and print action. Before writing anything the agent searches the docs with `scripts/search_docs.mjs`. The generated code is then checked by `scripts/validate.mjs`, which expects `--model`, `--client-name`, `--client-version`, `--artifact-id`, `--revision` and `--target`; leave out the target and validation fails.

Scaffolding goes through Shopify CLI, one template per type: `admin_action`, `admin_block`, `admin_link`, `admin_print`. Hand-written boilerplate is off the table, since the CLI template tracks the current API version.

The validator rejects HTML comments in the code, so `<!-- ... -->` has to go. Node.js is required for the scripts. To get the skill into Claude, run the `npx skills add` line with `-a codex`; the file lands at `.agents/skills/shopify-polaris-admin-extensions/SKILL.md`.

## Install

### Codex (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-polaris-admin-extensions -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/shopify-polaris-admin-extensions/SKILL.md` — For all projects use ~/.agents/skills/

### Claude Code

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-polaris-admin-extensions -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/shopify-polaris-admin-extensions/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/shopify-polaris-admin-extensions/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/shopify-polaris-admin-extensions/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins shopify-polaris-admin-extensions
```

2. **Manually: put the files in place**
- File: `.github/skills/shopify-polaris-admin-extensions/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-polaris-admin-extensions
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/shopify-polaris-admin-extensions/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-polaris-admin-extensions/SKILL.md

## When to use it
- scaffold an admin action extension with Shopify CLI
- build a product page block out of Polaris web components
- run validation on extension code before handing it over
- find which API fits a given extension target
- add a print action for order documents

## Example prompts
- Generate an admin block for the product page and validate it with `--target admin.product-details.block.render`
- Look up in the docs how to add a resource picker to an admin action, then write the code
- Build a print action for an invoice and run `scripts/validate.mjs` before returning

## Similar
- [frontend-design](https://affpapa.org/en/nevibecode/skills/frontend-design.md) — skill · 1025790 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 678700 installs
- [prototype](https://affpapa.org/en/nevibecode/skills/prototype.md) — skill · 986201 installs
- [hyperframes](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes.md) — skill · 1200000 installs
- [hyperframes-cli](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — skill · 1300000 installs
- [webapp-testing](https://affpapa.org/en/nevibecode/skills/webapp-testing.md) — skill · 186758 installs

## Other versions with the same name
- [shopify-polaris-admin-extensions · shopify](https://affpapa.org/en/nevibecode/skills/shopify-shopify-polaris-admin-extensions.md) — 9700 installs

From the same set: [openai/plugins](https://affpapa.org/en/nevibecode/by/openai/plugins.md) — 528 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md