# shopify-polaris-customer-account-extensions

This skill helps build Shopify customer account UI extensions for order and profile pages. Use it when you need a scaffold, target selection, or Polaris component guidance.

- skill · `type=skill` · Codex, ChatGPT · 1 install · ★ 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-customer-account-extensions/SKILL.md
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/skills/shopify-polaris-customer-account-extensions

## What it does

This skill supports Shopify Customer Account UI extension work across order index, order status, and profile surfaces. It also covers footer, order actions, and full-page targets. A new extension can be scaffolded with `shopify app generate extension --template=customer_account_ui --name=my_customer_account_ui_extension`.

The material maps extension targets to available APIs and Polaris web components. It also describes a workflow that searches documentation with `scripts/search_docs.mjs` and validates generated code with `scripts/validate.mjs`. Node.js is required for the skill to run.

The usable interfaces include customer account, navigation, localization, storage, session token, and other APIs. Component availability depends on the selected target, so validation should use the same target as the extension configuration.

## Install

### Codex (native platform)

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

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

### Claude Code

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

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

### Cursor

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

### GitHub Copilot

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

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

### Gemini CLI

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/shopify-polaris-customer-account-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-customer-account-extensions/SKILL.md

## When to use it
- scaffold a Shopify customer account extension
- place a block on an order status page
- add an action to an order menu
- build a profile-page customer UI
- select APIs for a specific extension target

## Example prompts
- Create a customer account extension for `customer-account.order-status.block.render` and validate the generated code.
- Scaffold a new Customer Account UI Extension with `shopify app generate extension --template=customer_account_ui --name=my_customer_account_ui_extension`.
- Add a profile block using Polaris web components and configure its target in `shopify.extension.toml`.

## 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

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
