woocommerce-store-api — Claude Code skill: API and setup
This skill guides WooCommerce Store API route work, from schema design to cart and checkout integrations. Use it when adding or changing /wc/store/v1/ endpoints.
GPL-2.0 251 installs ★ 10,608 updated 2026-10-25
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a claude-codeWhat woocommerce-store-api does
The skill focuses on WooCommerce Store API routes under /wc/store/v1/. It covers route paths, parameter placement, response and schema alignment, status codes, and resource design for blocks or other clients. The guidance applies when creating an endpoint or changing an existing contract.
Its reference material covers authentication, nonce handling, cart sessions, idempotency, product variations, and response preparation. A route that changes cookie-backed user state needs AbstractCartRoute or equivalent CSRF protection; AbstractRoute alone is not enough. Variation identity must be resolved from the product on the server.
It complements woocommerce-backend-dev and woocommerce-performance. The skill is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.
What it helps with
- add a route under
/wc/store/v1/ - design a resource schema for a frontend client
- align an API response with its declared schema
- resolve product variations on the server
- protect cart mutations from CSRF
Example prompts for the agent
- Add a WooCommerce Store API route under
/wc/store/v1/for coupon data and define its response schema. - Review the cart route and check its path, parameters, status codes, and schema together.
- Connect the checkout block to a Store API route and verify nonce handling and variation resolution.
How to install woocommerce-store-api
1Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a claude-code2Manually: put the files in place
~/.claude/skills/woocommerce-store-api/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/woocommerce-store-api/
1Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a codex2Manually: put the files in place
.agents/skills/woocommerce-store-api/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a cursor2Manually: put the files in place
.cursor/skills/woocommerce-store-api/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install woocommerce/woocommerce .ai/skills/woocommerce-store-api2Manually: put the files in place
.github/skills/woocommerce-store-api/SKILL.md1Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a gemini-cli2Platform CLI
gemini skills install https://github.com/woocommerce/woocommerce --path .ai/skills/woocommerce-store-apiManually: put the files in place
.devin/skills/woocommerce-store-api/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about woocommerce-store-api
How do I install woocommerce-store-api in Claude Code?
Run npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a claude-code, then check ~/.claude/skills/woocommerce-store-api/SKILL.md.
What does woocommerce-store-api do?
It guides route design and changes for WooCommerce Store API, including schemas, responses, authentication, cart state, and product variations.
Which base class should a cart-changing route use?
Use AbstractCartRoute for nonce and cart-session handling, or provide equivalent CSRF protection. AbstractRoute is intended for routes without that machinery.