Schema

What it does

When your agent uses it

• Optimize schema markup and structured data on their site
• The user mentions schema markup
• Structured data
• Breadcrumb schema

Example prompts

• “schema markup,”
• “structured data,”
• “JSON-LD,”
• “/schema”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Read context first. If .agents/product-marketing.md (or .claude/product-marketing.md, or legacy product-marketing-context.md) exists, read…
2. 2Identify the page type and the rich results it can earn — what is the primary content, and which enhanced result is realistically…
3. 3Inventory existing markup. Note what schema (if any) is already present and whether it errors. To read JS-injected JSON-LD on the live…
4. 4Choose the right types and properties — match each to its required and recommended fields (Quick Reference). When a page legitimately is…
5. 5Generate valid JSON-LD for the page, accurately reflecting visible content (Output Format; full examples in references/schema-examples.md).
6. 6Validate with the Rich Results Test and the Schema.org Validator, fix errors/warnings, then hand the markup to your own assistant to add…

What it can do on your machine

Read from SKILL.md and the folder at commit fb53247. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • schema.org

  Also links to:

  • search.google.com
  • validator.schema.org

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Schema loads about 2.1k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 126 tokens; SKILL.md has 813 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~126

When it runs · the whole SKILL.md, loaded when a task matches

~2.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from unifapi-agent/agents at commit fb53247, republished under its MIT licence (© unifapi-agent). 813 words, ~2,119 tokens.

name

schema

description

When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," "breadcrumb schema," "Google rich results," "knowledge panel," "star ratings in search," or "add structured data." Use this whenever someone wants their pages to show enhanced results in Google. For broader SEO issues, see the seo-audit skill.

license

MIT

metadata.author

UnifAPI

metadata.version

1.0.0

metadata.adapted_from

https://github.com/coreyhaines31/marketingskills

metadata.adapted_author

Corey Haines

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", "@id": "https://example.com/#org", "name": "...", "url": "..." },
    {
      "@type": "WebSite",
      "@id": "https://example.com/#website",
      "url": "...",
      "publisher": { "@id": "https://example.com/#org" }
    },
    { "@type": "BreadcrumbList", "itemListElement": [] }
  ]
}

{
  "@context": "https://schema.org",
  "@type": "...",
  "// complete, valid markup populated from the actual page": "..."
}

Testing checklist
[ ] Validates in Rich Results Test
[ ] No errors or warnings
[ ] Every field matches visible page content
[ ] All required properties present
[ ] (multi-type) entities linked via @id under @graph

© unifapi-agent, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/seo-agent/schema of unifapi-agent/agents.

• SKILL.md
• README.md
• references/schema-examples.md

Open the folder on GitHubat commit fb53247