add commerce api skill

[pbennett1-godaddy]

Summary

Add TanStack Intent skill for GoDaddy Commerce GraphQL APIs

Summary

Adds a TanStack Intent (https://tanstack.com/intent/latest) skill to @godaddy/react that teaches AI coding agents how to authenticate with the GoDaddy Commerce Platform and interact with its four
GraphQL subgraph APIs.

What's included

packages/react/skills/commerce-api/SKILL.md (407 lines)

A validated Intent skill covering:

• OAuth2 authentication — client credentials grant via /v2/oauth2/token with form parameters
• Four GraphQL subgraph endpoints:
  • Orders (/v1/commerce/order-subgraph)
  • Catalog (/v2/commerce/stores/{storeId}/catalog-subgraph)
  • Taxes (/v2/commerce/stores/{storeId}/tax-subgraph)
  • Price Adjustments (/v2/commerce/stores/{storeId}/price-adjustment-subgraph)
• Schema introspection — pattern for discovering available queries and mutations
• Core usage patterns — querying orders, catalog SKUs, calculating taxes, and calculating price adjustments
• Common mistakes — 6 documented failure modes (wrong token URL, missing Bearer prefix, missing storeId in path, omitting scopes, expired tokens, mutating non-draft orders)

packages/react/package.json

• Added skills to files array so the skill ships with the npm package
• Added tanstack-intent keyword for discoverability

Verified claims

All skill content was validated against live APIs via introspection:

Subgraph	Queries	Mutations
Orders	11	17
Catalog	29	110
Taxes	8	39
Price Adjustments	8	36

Common mistake scenarios (wrong URL → 405, missing Bearer → 401, missing storeId → 404, invalid scope → 400) were each confirmed.

Validation

  $ npx @tanstack/intent@latest validate                                                                                                                                                                  
  ✅ Validated 1 skill files — all passed                                                                                                                                                                 

How agents use this

After installing @godaddy/react, agents can discover and load this skill via:

  npx @tanstack/intent@latest install                                                                                                                                                                     

Changeset

• Changeset added (docs)

Test Plan

[changeset-bot]

🦋 Changeset detected

Latest commit: 56b8fb3

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@godaddy/react	Patch
nextjs	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR