# woocommerce-store-api

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 251 installs · ★ 10608 repo stars
- Author: woocommerce
- License: GPL-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/woocommerce/woocommerce/tree/HEAD/.ai/skills/woocommerce-store-api/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/woocommerce-store-api

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/woocommerce-store-api/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/woocommerce-store-api/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install woocommerce/woocommerce .ai/skills/woocommerce-store-api
```

2. **Manually: put the files in place**
- File: `.github/skills/woocommerce-store-api/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/woocommerce/woocommerce --path .ai/skills/woocommerce-store-api
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/woocommerce-store-api/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-store-api -a opencode
```

### 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/woocommerce/woocommerce/tree/HEAD/.ai/skills/woocommerce-store-api/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [woocommerce](https://affpapa.org/en/nevibecode/skills/woocommerce.md) — skill · 886 installs
- [WooCommerce Store Manager](https://affpapa.org/en/nevibecode/mcp/woocommerce-store-manager.md) — MCP server · 654 installs
- [e-commerce](https://affpapa.org/en/nevibecode/skills/e-commerce.md) — skill · 377 installs
- [woocommerce-webhooks](https://affpapa.org/en/nevibecode/skills/woocommerce-webhooks.md) — skill · 213 installs
- [woocommerce-copy-guidelines](https://affpapa.org/en/nevibecode/skills/woocommerce-copy-guidelines.md) — skill · 381 installs
- [WooCommerce Automation](https://affpapa.org/en/nevibecode/skills/woocommerce-automation.md) — skill · 4900 installs

From the same set: [woocommerce/woocommerce](https://affpapa.org/en/nevibecode/by/woocommerce/woocommerce.md) — 9 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
