Skip to content

feat(skills): add Shopify optional skill (Admin + Storefront GraphQL)#18116

Merged
teknium1 merged 1 commit into
mainfrom
hermes/hermes-8121abd0
Apr 30, 2026
Merged

feat(skills): add Shopify optional skill (Admin + Storefront GraphQL)#18116
teknium1 merged 1 commit into
mainfrom
hermes/hermes-8121abd0

Conversation

@teknium1
Copy link
Copy Markdown
Contributor

Summary

New optional skill: optional-skills/productivity/shopify — curl-based guide to the Shopify Admin GraphQL API and Storefront GraphQL API.

What's in it

  • Setup: custom-app flow, shpat_ token handling, X-Shopify-Access-Token header, env-var prompts for SHOPIFY_ACCESS_TOKEN / SHOPIFY_STORE_DOMAIN / SHOPIFY_API_VERSION (default 2026-01)
  • Reusable shop_gql() bash helper
  • Products (search/paginate/read/create/update, productVariantsBulkCreate/Update)
  • Orders (list with filters, single order + shipping/transactions)
  • Customers (search, create)
  • Inventory (inventoryAdjustQuantities, inventorySetQuantities, per-location reads)
  • Metafields (metafieldsSet)
  • Storefront API (public + private token headers, correct endpoint)
  • Bulk operations (start/poll/download JSONL)
  • Webhooks (subscribe, HMAC verification)
  • Pitfalls section: REST-is-frozen, token prefixes, scope 403s, userErrors traps, GID format, query-cost rate limiting, read_all_orders silent cap
  • Safety note on destructive mutations

Why optional-skills

Niche/heavy SaaS integration, same category as siyuan/canvas/telephony — not needed for most users. Installed via hermes skills install official/productivity/shopify.

Deprecation heads-up

Mentions the Jan 1, 2026 cutoff for admin-created custom apps and points at Dev Dashboard for new setups after that — existing apps continue to work.

Validation

  • hermes skills inspect official/productivity/shopify — frontmatter parses, description/tags render
  • hermes skills install official/productivity/shopify --yes — installs cleanly to $HERMES_HOME/skills/productivity/shopify/SKILL.md (security scanner flags the .env mention as 'exfiltration', allowed for builtin source as designed)

Adds optional-skills/productivity/shopify — curl-based guide for the
Shopify Admin GraphQL API (products, orders, customers, inventory,
metafields, bulk operations, webhooks) and the Storefront GraphQL API.

- API version 2026-01 (current stable)
- Custom-app access tokens (shpat_...) with X-Shopify-Access-Token header
- Notes the 2026-01-01 deprecation of admin-created custom apps, points
  users at Dev Dashboard for new setups after that date
- Includes a reusable shop_gql() bash helper, cursor pagination,
  rate-limit cost inspection, GID conventions, userErrors check
- Safety section warns on destructive mutations (delete/refund/cancel)

Installs cleanly via: hermes skills install official/productivity/shopify
@teknium1 teknium1 merged commit 180a703 into main Apr 30, 2026
7 checks passed
@teknium1 teknium1 deleted the hermes/hermes-8121abd0 branch April 30, 2026 22:58
@alt-glitch alt-glitch added type/feature New feature or request P3 Low — cosmetic, nice to have tool/skills Skills system (list, view, manage) labels Apr 30, 2026
donald131 pushed a commit to donald131/hermes-agent that referenced this pull request May 2, 2026
…NousResearch#18116)

Adds optional-skills/productivity/shopify — curl-based guide for the
Shopify Admin GraphQL API (products, orders, customers, inventory,
metafields, bulk operations, webhooks) and the Storefront GraphQL API.

- API version 2026-01 (current stable)
- Custom-app access tokens (shpat_...) with X-Shopify-Access-Token header
- Notes the 2026-01-01 deprecation of admin-created custom apps, points
  users at Dev Dashboard for new setups after that date
- Includes a reusable shop_gql() bash helper, cursor pagination,
  rate-limit cost inspection, GID conventions, userErrors check
- Safety section warns on destructive mutations (delete/refund/cancel)

Installs cleanly via: hermes skills install official/productivity/shopify
nickdlkk pushed a commit to nickdlkk/hermes-agent that referenced this pull request May 11, 2026
…NousResearch#18116)

Adds optional-skills/productivity/shopify — curl-based guide for the
Shopify Admin GraphQL API (products, orders, customers, inventory,
metafields, bulk operations, webhooks) and the Storefront GraphQL API.

- API version 2026-01 (current stable)
- Custom-app access tokens (shpat_...) with X-Shopify-Access-Token header
- Notes the 2026-01-01 deprecation of admin-created custom apps, points
  users at Dev Dashboard for new setups after that date
- Includes a reusable shop_gql() bash helper, cursor pagination,
  rate-limit cost inspection, GID conventions, userErrors check
- Safety section warns on destructive mutations (delete/refund/cancel)

Installs cleanly via: hermes skills install official/productivity/shopify
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low — cosmetic, nice to have tool/skills Skills system (list, view, manage) type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants