shopify-polaris-app-home — Codex skill: what it does, how to install
Builds embedded Shopify admin user interfaces using Polaris web components. It searches component docs and validates code via CLI scripts before returning snippets.
npx skills add openai/plugins --skill shopify-polaris-app-home -a codexWhat shopify-polaris-app-home does
This skill guides Codex when building primary embedded interfaces for the Shopify admin. It focuses on modern Polaris web components such as s-page, s-section, s-table, and form controls. Whenever Polaris is mentioned without explicit framework details, the assistant targets this App Home specification.
The workflow enforces automated verification through the bash tool. Codex first searches reference material using scripts/search_docs.mjs, drafts the UI markup, and tests it with scripts/validate.mjs. If checks fail, the assistant inspects the error and retries up to three times.
Node.js is mandatory on the host machine. Without terminal execution permissions, validation scripts fail immediately and the agent will refuse to hand over the generated layout.
What it helps with
- Scaffold an embedded Shopify admin homepage using Polaris web components
- Generate settings views with date pickers, switches, and color inputs
- Assemble metric cards, empty states, and resource tables
- Validate UI component properties before pasting into your codebase
Example prompts for the agent
- Build an app settings screen with an email field, toggle switch, and primary save button using Polaris components.
- Create a resource list layout with
s-table, search inputs, and pagination controls. - Add an empty state card with an illustration, callout text, and an action modal.
How to install shopify-polaris-app-home
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-polaris-app-home -a codex2Manually: put the files in place
.agents/skills/shopify-polaris-app-home/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill shopify-polaris-app-home -a claude-code2Manually: put the files in place
~/.claude/skills/shopify-polaris-app-home/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shopify-polaris-app-home/
Manually: put the files in place
.cursor/skills/shopify-polaris-app-home/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins shopify-polaris-app-home2Manually: put the files in place
.github/skills/shopify-polaris-app-home/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-polaris-app-homeManually: put the files in place
.devin/skills/shopify-polaris-app-home/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-polaris-app-home
How do I install shopify-polaris-app-home in Codex?
Run npx skills add openai/plugins --skill shopify-polaris-app-home in your terminal.
What does shopify-polaris-app-home do?
It teaches Codex how to write UI layouts for embedded Shopify apps using Polaris web components. Every code block is checked against local validation scripts before being output.
What are the system requirements?
The environment needs Node.js installed and bash execution privileges. The skill relies on bundled .mjs scripts to search documentation and validate component attributes.