Agentic Organization Schema — Shopify Admin Skills

Inject an Organization JSON-LD block (name, logo, sameAs social links, contactPoint) into the theme so AI agents can verify the store is a real, trusted brand and link it to its public identity.

Purpose

AI assistants check a site's schema.org/Organization JSON-LD to confirm it's the real brand (not a counterfeit or reseller) and to connect it to its public identity via sameAs (official socials, Wikipedia/Wikidata) and a machine-readable contactPoint. Without it, agents hesitate to recommend the store or send buyers to it. This skill builds an Organization JSON-LD block from the shop's data + supplied social links and injects it into the theme layout via a managed snippet. Fixes org-schema, machine-contact, and supports wikidata-qid (through sameAs).

Prerequisites

Authenticated Shopify CLI session (shopify auth login --store )

Required API scopes: read_themes, write_themes

Parameters

All skills accept these universal parameters:

Parameter	Type	Required	Default	Description
store	string	yes	—	Store domain (e.g., mystore.myshopify.com)
format	string	no	human	Output format: `human` (default) or `json`
dry_run	bool	no	true	Preview the snippet + injection without writing (defaults ON — edits the live theme)

Skill-specific parameters:

Parameter	Type	Required	Default	Description
theme_id	string	no	—	Theme GID (defaults to published MAIN theme)
logo_url	string	no	—	Absolute logo URL (else inferred from theme settings if available)
same_as	string	no	—	Comma list of official profile URLs (Instagram, TikTok, LinkedIn, Wikipedia, Wikidata)
contact_email	string	no	—	Customer-support email for `contactPoint` (else shop contactEmail)
contact_phone	string	no	—	Optional support phone for `contactPoint`

Safety

> ⚠️ Step 3 (themeFilesUpsert) writes a snippet and edits layout/theme.liquid in the LIVE theme. The change is additive (a {% render %} in ), but it publishes immediately and a malformed edit to theme.liquid can break rendering. The skill writes the JSON-LD into its own snippet file and inserts a single managed {% render 'agentic-organization-schema' %} line inside a # BEGIN/END marker block. Defaults dry_run: true; duplicate the theme first.

Workflow Steps

OPERATION: shop — query

Inputs: none

Expected output: Shop name, primary domain, contact email — the core Organization fields.

OPERATION: themes — query

Inputs: roles: [MAIN], theme.files(filenames: ["layout/theme.liquid", "snippets/agentic-organization-schema.liquid"])

Expected output: Current layout (to inject the render tag) + whether the snippet already exists.

OPERATION: themeFilesUpsert — mutation

Inputs: write snippets/agentic-organization-schema.liquid (the JSON-LD