[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79FTG7J419PBVVWRE6ZPYAF":3,"skill-same:01M79FTG7J419PBVVWRE6ZPYAF":55},{"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":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M79FTG7J419PBVVWRE6ZPYAF","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.","zfifteen\u002Fskills-catalog","zfifteen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F221906715?v=4","01M79CQFXDZM5J5CJTCECPFA66","Dionisio Alberto Lopez III","01M79CQFY4C62PN8A2T5KDAHGA",1,"MIT","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\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","d9535210da9af28aa76bca80de80355197e1b6d6","skills\u002Fshopify-custom-data","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog","https:\u002F\u002Fgithub.com\u002Fzfifteen","I like to measure things.","2026-07-19 23:41:54",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add zfifteen\u002Fskills-catalog --skill shopify-custom-data",{"tool":41,"command":42},"bunx","bunx skills add zfifteen\u002Fskills-catalog --skill shopify-custom-data",{"tool":44,"command":45},"pnpm","pnpm dlx skills add zfifteen\u002Fskills-catalog --skill shopify-custom-data","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fshopify-custom-data\u002FSKILL.md",true,[49],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"agents\u002Fopenai.yaml","REFERENCE","参考文档",220,"https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fshopify-custom-data\u002Fagents\u002Fopenai.yaml",[56,63,70,77,86,93],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M79GXQ2PWPT2E4CJYHXVJ0YE","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\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzotero\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M79GXN85NETKBE06865CWK6Z","zoom-apps-sdk","Use when using Apps SDK.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M79GXCYD7FGYS932J9N9RFFY","youtube","Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript.  Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or \"what does this video actually say\".  The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content.  Triggers: \"youtube transcript\", \"get the transcript of this video\", \"summarize this youtube video\", \"what did they say in https:\u002F\u002Fyoutube.com\u002F...\", \"key claims from this talk\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":81,"licenseFileUrl":82,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M79GX8EXHHYM566BKR7MS778","yeet","Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M79GX2HFJPX84NMRE5VBTYX9","x-post-creator","Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, \u002Fx-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs\u002Fx-posts\u002F[story-name]\u002F.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-post-creator\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M79GWXQT4HBT6QME6QSBZJFA","x-api","Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X\u002Fx.com, reading threads and replies, creating lists, staging\u002Fpublishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions \u002Fx-api or \"search X\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-api\u002FSKILL.md",[],[]]