[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7E7WR3S5GDZSPFR7TXBYMHJ":3,"skill-same:01M7E7WR3S5GDZSPFR7TXBYMHJ":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":14,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M7E7WR3S5GDZSPFR7TXBYMHJ","shopify-custom-data",null,"MUST be used first when prompts mention Metafields or Metaobjects. Use Metafields and Metaobjects to model and store custom data for your app. Metafields extend built-in Shopify data types like products or customers, Metaobjects are custom data types that can be used to store bespoke data structures. Metafield and Metaobject definitions provide a schema and configuration for values to follow.","wxdwu\u002Fnew-api","wxdwu","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F80968397?v=4","01M7E6AEMB59N90BKXD77EC83D","Xudong Wu","01M7E6AEMY2BXCDVZ9MJJHFQ4C",0,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fshopify\u002Fskills\u002Fshopify-custom-data\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: shopify-custom-data\ndescription: \"MUST be used first when prompts mention Metafields or Metaobjects. Use Metafields and Metaobjects to model and store custom data for your app. Metafields extend built-in Shopify data types like products or customers, Metaobjects are custom data types that can be used to store bespoke data structures. Metafield and Metaobject definitions provide a schema and configuration for values to follow.\"\ncompatibility: Requires Node.js\nmetadata:\n  author: Shopify\n  version: \"1.9.1\"\n---\n\n\u003Ccritical-instructions>\n# Best Practise for working with Metafields and Metaobjects\n\n# ESSENTIAL RULES\n\n- **ALWAYS** show creating metafield\u002Fmetaobject definitions, then writing values, then retrieving values.\n- **NEVER** show or offer alternate approaches to the same problem if not explicitly requested. It will only increase the user's confusion.\n- Keep examples minimal -- avoid unnecessary prose and comments\n- Remember the audience for this guidance is app developers -- they do not have access to the Shopify Admin site\n- Follow this guidance meticulously and thoroughly\n\nREMEMBER!!! Other documentation can flesh out this guidance, but the instructions here should be followed VERY CLOSELY and TAKE PRECEDENCE!\n\n# ALWAYS: First, create definitions\n\n## with TOML (99.99% of apps)\n\n```toml\n# shopify.app.toml\n\n# Metafield definition -- owner type is PRODUCT, namespace is $app, key is care_guide\n[product.metafields.app.care_guide]\ntype = \"single_line_text_field\"\nname = \"Care Guide\"\naccess.admin = \"merchant_read_write\"\n\n# Metaobject definition -- type is $app:author\n[metaobjects.app.author]\nname = \"Author\"\ndisplay_name_field = \"name\"\naccess.storefront = \"public_read\"\n\n[metaobjects.app.author.fields.name]\nname = \"Author Name\"\ntype = \"single_line_text_field\"\nrequired = true\n\n# Link metaobject to product\n[product.metafields.app.author]\ntype = \"metaobject_reference\u003C$app:author>\"\nname = \"Book Author\"\n```\n\nWhy: Version controlled, auto-installed, type-safe. GraphQL (Admin\u002FStorefront) is used for reading or writing values after the TOML definitions already exist. Fields\u002Fobjects can be edited by merchants when `access.admin = \"merchant_read_write\"` is set.\n\n**NEVER** include `metafieldDefinitionCreate`, `metaobjectDefinitionCreate` GraphQL if TOML is the correct fit.\n\n### Exceptions (0.01% of apps)\n\n**NEVER, EVER** show these unless strictly required:\n\n- Apps that **REQUIRE** creating definitions at **runtime** (i.e. types are configured dynamically by merchants) should use `metafieldDefinitionCreate`, `metaobjectDefinitionCreate`\n- Apps that want **other apps** to read\u002Fwrite their data should use the above GraphQL, and \"merchant-owned\" namespace\n\n# CRITICAL: App-Owned Metaobject and Metafield identification\n\n- Metaobjects defined with `[metaobjects.app.example...]` in `shopify.app.toml`, MUST be accessed using `type: $app:example`\n- Metafields defined with `[product.metafields.app.example]` MUST be accessed using `namespace: $app` and `key: example`\n  - The same applies to other owner types, like customers, orders, etc.\n- Avoid customizing namespaces for metafields.\n- Avoid the common mistake of using `namespace: app`. This is profoundly incorrect.\n\n# NEXT: demonstrate writing metafield and metaobject values via Admin API\n\n## Writing metafields\n\n**ALWAYS** use `metafieldsSet` to write metafields. `namespace` should normally be excluded as the default is $app.\n\n```graphql\nmutation {\n  metafieldsSet(metafields:[{\n    ownerId: \"gid:\u002F\u002Fshopify\u002FProduct\u002F1234\",\n    key: \"example\",\n    value: \"Hello, World!\"\n  }]) { ... }\n}\n```\n\n## Writing metaobjects\n\n**ALWAYS** use `metaobjectUpsert` to write metaobjects.\n\n```graphql\nmutation {\n  metaobjectUpsert(handle: {\n    type: \"$app:author\",\n    handle: \"my-metaobject\",\n  }, metaobject: {\n    fields: [{\n      key: \"example\",\n      value: \"Hello, world!\"\n    }]\n  }) { ... }\n}\n```\n\n# FINALLY: demonstrate reading metafield and metaobject values\n\n## Loading metafields\n\nMetafields are accessed via their owning type (e.g. a Product). `namespace` should normally be excluded as the default is $app.\n\n- Always prefer `jsonValue` where possible as it better serialises complex types\n- Always alias metafield loads for easy reference\n\n```graphql\n# Admin API\nquery {\n  product(id: \"gid:\u002F\u002Fshopify\u002FProduct\u002F1234\") {\n    example: metafield(key: \"example\") {\n      jsonValue\n    }\n  }\n}\n# Storefront API\nquery {\n  product(handle: \"wireless-headphones-1\") {\n    example: metafield(key: \"example\") {\n      value\n    }\n  }\n}\n```\n\n## Loading metaobjects\n\n```graphql\n# Admin API\nquery {\n  metaobjects(type: \"$app:author\", first: 10) {\n    nodes {\n      handle\n      example: field(key: \"example\") {\n        jsonValue\n      }\n    }\n  }\n}\n# Storefront API\nquery {\n  metaobjects(type: \"$app:author\", first: 10) {\n    nodes {\n      handle\n      example: field(key: \"example\") {\n        value\n      }\n    }\n  }\n}\n```\n\n### Access Metafields directly in checkout extensions\n\n**DO**: Access app-owned metafields directly (NO network call):\n\n```tsx\nfunction Extension() {\n  \u002F\u002F ESSENTIAL: Register this metafield in `shopify.extension.toml`\n  const [energyRating] = useAppMetafields({\n    namespace: \"$app\",\n    key: \"energy-rating\",\n    type: \"product\",\n  }).filter((entry) => entry.target.id === productVariantId);\n}\n```\n\n**DON'T**: Make network calls for app-owned metafields.\n\n### Access Metafields in Shopify Functions\n\nUse the GraphQL input query to select metafields to load:\n\n```graphql\nquery Input {\n  cart {\n    lines {\n      merchandise {\n        __typename\n        ... on ProductVariant {\n          example: metafield(namespace: \"$app\", key: \"example\") {\n            jsonValue\n          }\n        }\n      }\n    }\n  }\n}\n```\n\nDocs: [Metafields & Metaobjects](https:\u002F\u002Fshopify.dev\u002Fdocs\u002Fapps\u002Fbuild\u002Fcustom-data)\n\u003C\u002Fcritical-instructions>\n\n### Always use Shopify CLI\n\n- **CLI:** ALWAYS use Shopify CLI to scaffold apps and extensions. Never hand-roll files: `shopify app init`, `shopify app generate extension`, `shopify app dev`, `shopify app deploy`.\n- For CLI installation, setup, upgrade, or troubleshooting, use `shopify-use-shopify-cli`.\n","\u003Ccritical-instructions>\n# Best Practise for working with Metafields and Metaobjects\n\n# ESSENTIAL RULES\n\n- **ALWAYS** show creating metafield\u002Fmetaobject definitions, then writing values, then retrieving values.\n- **NEVER** show or offer alternate approaches to the same problem if not explicitly requested. It will only increase the user's confusion.\n- Keep examples minimal -- avoid unnecessary prose and comments\n- Remember the audience for this guidance is app developers -- they do not have access to the Shopify Admin site\n- Follow this guidance meticulously and thoroughly\n\nREMEMBER!!! Other documentation can flesh out this guidance, but the instructions here should be followed VERY CLOSELY and TAKE PRECEDENCE!\n\n# ALWAYS: First, create definitions\n\n## with TOML (99.99% of apps)\n\n```toml\n# shopify.app.toml\n\n# Metafield definition -- owner type is PRODUCT, namespace is $app, key is care_guide\n[product.metafields.app.care_guide]\ntype = \"single_line_text_field\"\nname = \"Care Guide\"\naccess.admin = \"merchant_read_write\"\n\n# Metaobject definition -- type is $app:author\n[metaobjects.app.author]\nname = \"Author\"\ndisplay_name_field = \"name\"\naccess.storefront = \"public_read\"\n\n[metaobjects.app.author.fields.name]\nname = \"Author Name\"\ntype = \"single_line_text_field\"\nrequired = true\n\n# Link metaobject to product\n[product.metafields.app.author]\ntype = \"metaobject_reference\u003C$app:author>\"\nname = \"Book Author\"\n```\n\nWhy: Version controlled, auto-installed, type-safe. GraphQL (Admin\u002FStorefront) is used for reading or writing values after the TOML definitions already exist. Fields\u002Fobjects can be edited by merchants when `access.admin = \"merchant_read_write\"` is set.\n\n**NEVER** include `metafieldDefinitionCreate`, `metaobjectDefinitionCreate` GraphQL if TOML is the correct fit.\n\n### Exceptions (0.01% of apps)\n\n**NEVER, EVER** show these unless strictly required:\n\n- Apps that **REQUIRE** creating definitions at **runtime** (i.e. types are configured dynamically by merchants) should use `metafieldDefinitionCreate`, `metaobjectDefinitionCreate`\n- Apps that want **other apps** to read\u002Fwrite their data should use the above GraphQL, and \"merchant-owned\" namespace\n\n# CRITICAL: App-Owned Metaobject and Metafield identification\n\n- Metaobjects defined with `[metaobjects.app.example...]` in `shopify.app.toml`, MUST be accessed using `type: $app:example`\n- Metafields defined with `[product.metafields.app.example]` MUST be accessed using `namespace: $app` and `key: example`\n  - The same applies to other owner types, like customers, orders, etc.\n- Avoid customizing namespaces for metafields.\n- Avoid the common mistake of using `namespace: app`. This is profoundly incorrect.\n\n# NEXT: demonstrate writing metafield and metaobject values via Admin API\n\n## Writing metafields\n\n**ALWAYS** use `metafieldsSet` to write metafields. `namespace` should normally be excluded as the default is $app.\n\n```graphql\nmutation {\n  metafieldsSet(metafields:[{\n    ownerId: \"gid:\u002F\u002Fshopify\u002FProduct\u002F1234\",\n    key: \"example\",\n    value: \"Hello, World!\"\n  }]) { ... }\n}\n```\n\n## Writing metaobjects\n\n**ALWAYS** use `metaobjectUpsert` to write metaobjects.\n\n```graphql\nmutation {\n  metaobjectUpsert(handle: {\n    type: \"$app:author\",\n    handle: \"my-metaobject\",\n  }, metaobject: {\n    fields: [{\n      key: \"example\",\n      value: \"Hello, world!\"\n    }]\n  }) { ... }\n}\n```\n\n# FINALLY: demonstrate reading metafield and metaobject values\n\n## Loading metafields\n\nMetafields are accessed via their owning type (e.g. a Product). `namespace` should normally be excluded as the default is $app.\n\n- Always prefer `jsonValue` where possible as it better serialises complex types\n- Always alias metafield loads for easy reference\n\n```graphql\n# Admin API\nquery {\n  product(id: \"gid:\u002F\u002Fshopify\u002FProduct\u002F1234\") {\n    example: metafield(key: \"example\") {\n      jsonValue\n    }\n  }\n}\n# Storefront API\nquery {\n  product(handle: \"wireless-headphones-1\") {\n    example: metafield(key: \"example\") {\n      value\n    }\n  }\n}\n```\n\n## Loading metaobjects\n\n```graphql\n# Admin API\nquery {\n  metaobjects(type: \"$app:author\", first: 10) {\n    nodes {\n      handle\n      example: field(key: \"example\") {\n        jsonValue\n      }\n    }\n  }\n}\n# Storefront API\nquery {\n  metaobjects(type: \"$app:author\", first: 10) {\n    nodes {\n      handle\n      example: field(key: \"example\") {\n        value\n      }\n    }\n  }\n}\n```\n\n### Access Metafields directly in checkout extensions\n\n**DO**: Access app-owned metafields directly (NO network call):\n\n```tsx\nfunction Extension() {\n  \u002F\u002F ESSENTIAL: Register this metafield in `shopify.extension.toml`\n  const [energyRating] = useAppMetafields({\n    namespace: \"$app\",\n    key: \"energy-rating\",\n    type: \"product\",\n  }).filter((entry) => entry.target.id === productVariantId);\n}\n```\n\n**DON'T**: Make network calls for app-owned metafields.\n\n### Access Metafields in Shopify Functions\n\nUse the GraphQL input query to select metafields to load:\n\n```graphql\nquery Input {\n  cart {\n    lines {\n      merchandise {\n        __typename\n        ... on ProductVariant {\n          example: metafield(namespace: \"$app\", key: \"example\") {\n            jsonValue\n          }\n        }\n      }\n    }\n  }\n}\n```\n\nDocs: [Metafields & Metaobjects](https:\u002F\u002Fshopify.dev\u002Fdocs\u002Fapps\u002Fbuild\u002Fcustom-data)\n\u003C\u002Fcritical-instructions>\n\n### Always use Shopify CLI\n\n- **CLI:** ALWAYS use Shopify CLI to scaffold apps and extensions. Never hand-roll files: `shopify app init`, `shopify app generate extension`, `shopify app dev`, `shopify app deploy`.\n- For CLI installation, setup, upgrade, or troubleshooting, use `shopify-use-shopify-cli`.\n",{"name":5,"metadata":24,"description":7,"compatibility":27},{"author":25,"version":26},"Shopify","1.9.1","Requires Node.js","main","dde9a06ab10bce3fe52058c783826590231f7df3","plugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fshopify\u002Fskills\u002Fshopify-custom-data","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api","https:\u002F\u002Fgithub.com\u002Fwxdwu","24120128@bjtu.edu.cn","I am Xudong Wu，a student in beijing jiaotong University, \"I am eager to learn on GitHub and contribute my part to this community.","2026-10-05 17:26:50",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add wxdwu\u002Fnew-api --skill shopify-custom-data",{"tool":42,"command":43},"bunx","bunx skills add wxdwu\u002Fnew-api --skill shopify-custom-data",{"tool":45,"command":46},"pnpm","pnpm dlx skills add wxdwu\u002Fnew-api --skill shopify-custom-data","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fshopify\u002Fskills\u002Fshopify-custom-data\u002FSKILL.md",true,[50],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"agents\u002Fopenai.yaml","REFERENCE","参考文档",220,"https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fshopify\u002Fskills\u002Fshopify-custom-data\u002Fagents\u002Fopenai.yaml",[57,64,71,78,85,92],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7E8SVA2N0JA09RW1XJYXCWX","Zotero","Use Zotero Desktop from Codex to enable\u002Fprobe the local API, search a local Zotero library, list items\u002Fcollections\u002Ftags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX\u002FRIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzotero\u002Fskills\u002Fzotero\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7E8ST1FJAD5PWTW2FN1NSK0","zoom-apps-sdk","Use when using Apps SDK.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7E8SRW074NNNCZRCZA5T3Z1","setup-zoom-websockets","Use when building Zoom WebSockets.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fwebsockets\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7E8SPCFMD3YVPRX2MW8X3RA","setup-zoom-webhooks","Use when building Zoom webhooks.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fwebhooks\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7E8SMCH4RPCX8YSBNGWQCMP","zoom-virtual-agent-web","Zoom Virtual Agent SDK for web embeds. Use for campaign or entry ID chat launch, event-driven controls, user context updates, and CSP-safe deployment.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fvirtual-agent\u002Fweb\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7E8SJCAY323E36Z8SAP8H4M","zoom-virtual-agent-ios","Zoom Virtual Agent iOS integration via WKWebView. Use for Swift\u002FObjective-C script injection, message handlers, support_handoff relay, and URL routing policies.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fvirtual-agent\u002Fios\u002FSKILL.md",[],[]]