shopify-pos-ui — Codex skill: what it does, how to install
Generates Preact components and extensions for Shopify retail point-of-sale systems. Helps developers scaffold modules through the CLI and validate code against UI targets.
npx skills add openai/plugins --skill shopify-pos-ui -a codexWhat shopify-pos-ui does
This skill guides the agent through creating Shopify POS UI extensions. The assistant uses the official Shopify CLI to scaffold extensions using templates like pos_action, pos_block, or pos_smart_grid. Direct file creation without the CLI is blocked by the skill rules to preserve the expected app structure.
Before returning any code, the agent runs mandatory internal scripts. It calls scripts/search_docs.mjs to look up component properties, generates type-safe Preact code, and tests it with scripts/validate.mjs. If checks fail, the assistant attempts up to 3 repair retries.
Node.js must be installed on your machine. Validation fails outright if the --target flag is omitted, because every POS component requires a defined extension surface.
What it helps with
- Scaffold POS extensions with the Shopify CLI
- Build customer details blocks using Preact components
- Add custom modal actions to cart line items
- Verify extension code against 34 point-of-sale targets
Example prompts for the agent
- Create a customer loyalty details block for Shopify POS
- Scaffold a new cart line item action extension using Shopify CLI
- Validate our Preact code for target pos.customer-details.block.render
How to install shopify-pos-ui
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-pos-ui -a codex2Manually: put the files in place
.agents/skills/shopify-pos-ui/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-pos-ui -a claude-code2Manually: put the files in place
~/.claude/skills/shopify-pos-ui/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shopify-pos-ui/
Manually: put the files in place
.cursor/skills/shopify-pos-ui/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-pos-ui2Manually: put the files in place
.github/skills/shopify-pos-ui/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-pos-uiManually: put the files in place
.devin/skills/shopify-pos-ui/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: Codex skills: how to install, where they live, how to call them
Questions about shopify-pos-ui
How do I install shopify-pos-ui in Codex?
Run npx skills add openai/plugins --skill shopify-pos-ui -a codex in your project terminal. This registers the skill for Codex.
What does shopify-pos-ui do?
It automates building retail point-of-sale extensions for Shopify. The skill queries POS documentation, scaffolds Preact code, and validates it before output.
What dependencies are required for shopify-pos-ui?
You need Node.js and the Shopify CLI installed in your development environment. Every code validation call also requires a specific --target parameter.