Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →bankrbot/bankr-shopify
Shopify Admin & Storefront GraphQL APIs via curl, with Bankr-native bridges. Manage products, orders, customers, inventory, metafields, webhooks, and bulk ops, then wire merchant data to onchain primitives — store a Bankr-resolvable handle (ENS, Twitter, Farcaster, wallet) on each customer as a metafield, expose Shopify draft orders behind x402 endpoints Bankr settles in USDC, and turn ORDERS_PAID webhooks into Bankr agent jobs for loyalty drops or royalty splits. Triggers: "Shopify products", "
Passed 18 of 21 test cases with the skill, and 12 of 21 without it.
and 6 more in the full report
6 fixed13 passed either way3 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 5 test cases the skill fixed. Same model, same prompt, with and without the skill.
We want to drop loyalty tokens to a customer on Base. Can you query Shopify customer `gid://shopify/Customer/987654` for their custom handle metafield, and if found, submit a prompt to Bankr to send them 50 LOYALTY tokens, polling the job until completion to report the final status?
| Checked | Without skill | With skill |
|---|---|---|
| queries the customer metafield with namespace custom and key handle | Missed | Passed |
| submits the prompt to the endpoint https://api.bankr.bot/agent/prompt | Missed | Passed |
| polls for job completion using the endpoint https://api.bankr.bot/agent/job/{id} | Missed | Passed |
The instructions your model reads when the skill loads.
The core Shopify sections of this skill are adapted from the upstream
NousResearch/hermes-agentskill (MIT,author: community). The four "Bankr Bridges" sections at the end are new and specific to the Bankr ecosystem.
Work with Shopify stores directly through curl: list products, manage inventory, pull orders, update customers, read metafields. No SDK, no app framework — just the GraphQL endpoint and a custom-app access token. Then bridge the merchant data to onchain primitives via Bankr.
The REST Admin API is legacy since 2024-04 and only receives security fixes. Use GraphQL Admin for all admin work. Use Storefront GraphQL for read-only customer-facing queries (products, collections, cart).
shpat_.SHOPIFY_ACCESS_TOKEN — admin token (starts with shpat_)SHOPIFY_STORE_DOMAIN — my-store.myshopify.com (the permanent myshopify domain, not your custom one)SHOPIFY_API_VERSION — default 2026-01BANKR_API_KEY — for the Bankr bridge sections; generate at https://bankr.bot/api-keysHeads up: As of January 1, 2026, new "legacy custom apps" created in the Shopify admin are gone. New setups should use the Dev Dashboard (
shopify.dev/docs/apps/build/dev-dashboard). Existing admin-created apps keep working. If the user's shop has no existing custom app and it's after 2026-01-01, direct them to Dev Dashboard instead of the admin flow.
Common scopes by task:
read_products, write_productsread_inventory, write_inventory, read_locationsread_orders, write_orders (30 most recent without read_all_orders)read_customers, write_customersread_draft_orders, write_draft_ordersread_fulfillments, write_fulfillmentshttps://$SHOPIFY_STORE_DOMAIN/admin/api/$SHOPIFY_API_VERSION/graphql.jsonX-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN (NOT Authorization: Bearer)POST, always Content-Type: application/json, body is {"query": "...", "variables": {...}}errors array and per-field userErrors. Always check both.gid://shopify/Product/10079467700516, gid://shopify/Variant/..., gid://shopify/Order/.... Pass these verbatim — don't strip the prefix.extensions.cost with requestedQueryCost, actualQueryCost, throttleStatus.{currentlyAvailable, maximumAvailable, restoreRate}. Back off when currentlyAvailable drops below your next query's cost. Standard shops = 100 points bucket, 50/s restore; Plus = 1000/100.Base curl pattern (reusable):
test cases passed, vs 12 / 21 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.