Agent skill

Local Schema

by garrettjsmith in garrettjsmith/localseoskills

When the user wants to implement LocalBusiness structured data, location schema, or local-specific JSON-LD markup.

Install Local Schema

skills CLI

$ npx skills add garrettjsmith/localseoskills --skill local-schema -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install garrettjsmith/localseoskills local-schema --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/garrettjsmith/localseoskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/local-schema .claude/skills/local-schema && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "local-schema" agent skill from https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-schema into .claude/skills/local-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "local-schema", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-schema

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add garrettjsmith/localseoskills --skill local-schema -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install garrettjsmith/localseoskills local-schema --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/garrettjsmith/localseoskills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/local-schema .agents/skills/local-schema && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "local-schema" agent skill from https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-schema into .agents/skills/local-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "local-schema", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add garrettjsmith/localseoskills --skill local-schema -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install garrettjsmith/localseoskills local-schema --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/garrettjsmith/localseoskills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/local-schema .cursor/skills/local-schema && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "local-schema" agent skill from https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-schema into .cursor/skills/local-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "local-schema", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/garrettjsmith/localseoskills.git --path skills/local-schema

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add garrettjsmith/localseoskills --skill local-schema -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install garrettjsmith/localseoskills local-schema --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/garrettjsmith/localseoskills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/local-schema .gemini/skills/local-schema && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "local-schema" agent skill from https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-schema into .gemini/skills/local-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "local-schema", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install garrettjsmith/localseoskills local-schema

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add garrettjsmith/localseoskills --skill local-schema -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/garrettjsmith/localseoskills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/local-schema .github/skills/local-schema && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "local-schema" agent skill from https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-schema into .github/skills/local-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "local-schema", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add garrettjsmith/localseoskills --skill local-schema -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install garrettjsmith/localseoskills local-schema --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/garrettjsmith/localseoskills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/local-schema .opencode/skills/local-schema && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "local-schema" agent skill from https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-schema into .opencode/skills/local-schema/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "local-schema", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: local-schema
GitHub stars: 114
Token cost: ~1.5k tokens
SKILL.md length: 389 words
Files: 1
Skills in repo: 38
Repo updated: Aug 15, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

When the user wants to implement LocalBusiness structured data, location schema, or local-specific JSON-LD markup.

Works in 3 steps: Google Rich Results Test:… → Schema Markup Validator:… → Browser DevTools:…
Wants to implement LocalBusiness structured data
SKILL.md covers Core Principle, LocalBusiness Schema Template, @type Selection and Multi-Location Schema, plus 5 more sections
Reaches schema.org and en.wikipedia.org

What it does

Local Schema is an agent skill from garrettjsmith/localseoskills. When the user wants to implement LocalBusiness structured data, location schema, or local-specific JSON-LD markup. Also use when the user mentions "local schema," "LocalBusiness schema," "structured data for local," "JSON-LD for business," "NAP schema," or "local business markup." For general schema, see schema-markup skill. For GBP profile work, see gbp-optimization.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Schema markup. The repository describes itself as: Open-source Claude SEO tool for local search visibility — skills, tool integrations, and automation templates that turn Claude into a Local SEO expert. The licence is MIT.

When your agent uses it

Wants to implement LocalBusiness structured data
Location schema
Local-specific JSON-LD markup
The user mentions local schema

Example prompts

“local schema,”
“LocalBusiness schema,”
“structured data for local,”
“/local-schema”

Workflow steps

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

Google Rich Results Test: https://search.google.com/test/rich-results (renders JavaScript)
Schema Markup Validator: https://validator.schema.org/
Browser DevTools: document.querySelectorAll('script[type="application/ld+json"]')

What it can do on your machine

Read from SKILL.md and the folder at commit 405ce20. 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
- en.wikipedia.org
- facebook.com
- yelp.com
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

Local Schema loads about 1.5k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 389 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~96
When it runs · the whole SKILL.md, loaded when a task matches: ~1.5k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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 garrettjsmith/localseoskills at commit 405ce20, republished under its MIT licence (© garrettjsmith). 389 words, ~1,539 tokens.

Download SKILL.mdSave it as .claude/skills/local-schema/SKILL.md (or your agent's skills folder).

name: local-schema
description: When the user wants to implement LocalBusiness structured data, location schema, or local-specific JSON-LD markup. Also use when the user mentions "local schema," "LocalBusiness schema," "structured data for local," "JSON-LD for business," "NAP schema," or "local business markup." For general schema, see schema-markup skill. For GBP profile work, see gbp-optimization.
metadata.version: 1.0.0
metadata.author: Garrett Smith

Local Schema Markup

You are an expert in implementing structured data for local businesses. Your goal is to correctly implement LocalBusiness schema that reinforces GBP data and improves local search visibility.

Core Principle

Schema on your website must match your GBP data exactly. Mismatches create conflicting signals. The schema is your website confirming what GBP says about your business.

LocalBusiness Schema Template

json

{
  "@context": "https://schema.org",
  "@type": "Plumber",
  "@id": "https://example.com/#business",
  "name": "Smith Plumbing",
  "image": "https://example.com/images/logo.png",
  "url": "https://example.com",
  "telephone": "+17165550100",
  "email": "info@smithplumbing.com",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Main St, Suite 200",
    "addressLocality": "Buffalo",
    "addressRegion": "NY",
    "postalCode": "14201",
    "addressCountry": "US"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "42.8864",
    "longitude": "-78.8784"
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "08:00",
      "closes": "17:00"
    }
  ],
  "areaServed": [
    { "@type": "City", "name": "Buffalo", "sameAs": "https://en.wikipedia.org/wiki/Buffalo,_New_York" },
    { "@type": "City", "name": "Orchard Park" },
    { "@type": "City", "name": "Hamburg" }
  ],
  "priceRange": "$$",
  "sameAs": [
    "https://www.facebook.com/smithplumbing",
    "https://www.yelp.com/biz/smith-plumbing-buffalo"
  ],
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "142"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Plumbing Services",
    "itemListElement": [
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Emergency Plumbing",
          "description": "24/7 emergency plumbing repair"
        }
      }
    ]
  }
}

@type Selection

Use the most specific LocalBusiness subtype:

Business Type	Schema @type
General business	`LocalBusiness`
Plumber	`Plumber`
Electrician	`Electrician`
HVAC	`HVACBusiness`
Dentist	`Dentist`
Restaurant	`Restaurant`
Auto repair	`AutoRepair`
Attorney	`Attorney`
Real estate agent	`RealEstateAgent`
Hair salon	`HairSalon`
Medical practice	`MedicalBusiness`

Full list: https://schema.org/LocalBusiness (check subtypes)

Multi-Location Schema

Each location needs its own schema with a unique @id:

json

{
  "@type": "Plumber",
  "@id": "https://example.com/locations/buffalo-ny/#business",
  "name": "Smith Plumbing - Buffalo",
  "url": "https://example.com/locations/buffalo-ny/",
  ...
}

On the homepage, reference all locations:

json

{
  "@type": "Organization",
  "@id": "https://example.com/#organization",
  "name": "Smith Plumbing",
  "department": [
    { "@id": "https://example.com/locations/buffalo-ny/#business" },
    { "@id": "https://example.com/locations/orchard-park-ny/#business" }
  ]
}

SAB (Service Area Business) Schema

For businesses without a public address, omit address and emphasize areaServed:

json

{
  "@type": "Plumber",
  "name": "Smith Plumbing",
  "areaServed": [
    { "@type": "City", "name": "Buffalo, NY" },
    { "@type": "City", "name": "Orchard Park, NY" },
    { "@type": "State", "name": "New York" }
  ],
  "telephone": "+17165550100",
  "url": "https://example.com"
}

Validation

Tools

Google Rich Results Test: https://search.google.com/test/rich-results (renders JavaScript)
Schema Markup Validator: https://validator.schema.org/
Browser DevTools: document.querySelectorAll('script[type="application/ld+json"]')

Common Errors

address format doesn't match GBP
Missing geo coordinates
Wrong @type (too generic)
telephone missing country code
openingHoursSpecification doesn't match actual hours
Duplicate @id across pages

⚠️ Detection limitation: web_fetch and curl strip <script> tags. Many CMS plugins inject JSON-LD via JavaScript. Always use Rich Results Test or browser tools to verify schema exists.

Task-Specific Questions

Single location or multi-location?
Storefront or SAB?
What CMS/platform? (WordPress plugin, Next.js, etc.)
Does the business have existing schema?
What GBP categories are set?

Show full SKILL.md (144 more words)Show less

What to Do Next

What You Found	Next Action	Skill
Schema implemented, need to verify GBP matches	Audit GBP to ensure all data aligns exactly with schema	`gbp-optimization`
Need schema on multiple location pages	Build schema per page with location-specific data	`local-landing-pages`
Schema is part of a broader audit	Feed schema findings into the full audit report	`local-seo-audit`
Schema added but rankings unchanged	Schema alone rarely moves rankings — it reinforces other signals. Check if the real issue is elsewhere	`geogrid-analysis`

Default next step: After implementing schema, validate with Google's Rich Results Test, then monitor Search Console for structured data errors over the next 2 weeks.

Tools for This Skill

See docs/tool-routing to pick based on what's connected.

Schema validation at scale (across many location pages) → technical audit tools (Screaming Frog preferred for custom extraction)
Single-page validation → Google Rich Results Test (no tool skill needed)

Files

Just SKILL.md in skills/local-schema of garrettjsmith/localseoskills.

Open the folder on GitHubat commit 405ce20

Compare with similar skills

Local Schema next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Local Schema compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Local Schema this skillgarrettjsmith/localseoskills	114	—	~1.5k	Automated safety check: Pass	MIT	1 mo ago
SEO GeoReScienceLab/opc-skills	1.8k	4 repos	~2.1k	Automated safety check: Pass	Apache-2.0	today
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude	11k	—	~2.8k	Automated safety check: Notes	MIT	yesterday
Portaljs Add Dcatdatopian/portaljs	2.4k	1 repos	~1.8k	Automated safety check: Pass	MIT	1 mo ago
Schema Markupfreekmurze/dotfiles	1k	15 repos	~1.2k	Automated safety check: Pass	None	2 days ago
SEO Optimizerailabs-393/ai-labs-claude-skills	454	1 repos	~3.2k	Automated safety check: Pass	MIT	11 mo ago

Similar skills

SEO Geo
ReScienceLab/opc-skills
SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.
1.8k GitHub starsUsed in 4 repos~2.1k tokens
Marketing & SEOAuto-check passed
GEO-First SEO Audit Tool
zubair-trabzada/geo-seo-claude
Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.
11k GitHub stars~2.8k tokensUpdated yesterday
Marketing & SEOAuto-check: notes
Portaljs Add Dcat
datopian/portaljs
Make a PortalJS portal harvestable by national/EU/US open-data portals — emit standards-compliant DCAT catalog feeds (DCAT 2/3, DCAT-AP, DCAT-US, national profiles) in JSON-LD, Turtle, and RDF/XML…
2.4k GitHub starsUsed in 1 repo~1.8k tokens
Marketing & SEOAuto-check passed
Schema Markup
freekmurze/dotfiles
When the user wants to add, fix, or optimize schema markup and structured data on their site.
1k GitHub starsUsed in 15 repos~1.2k tokens
Marketing & SEOAuto-check passed
SEO Optimizer
ailabs-393/ai-labs-claude-skills
This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices.
454 GitHub starsUsed in 1 repo~3.2k tokens
Marketing & SEOAuto-check passed
Geo
liangdabiao/GEO-Content-Optimizer-Skill
完整的 GEO（生成式引擎优化）服务流水线：给一个产品官网 URL 和介绍材料，做站点诊断与 AI 答案采样、生成带验收标准的执行工单、产出可直接部署的资产（llms.txt / JSON-LD / 定义块 / FAQ / 内容大纲与初稿）、自动验收工单是否闭环、并打包成可直接发给客户的交付物。可按周期复跑，做长期 GEO 运营与月报。
203 GitHub starsUsed in 1 repo~2.3k tokens
Marketing & SEOAuto-check: notes

Questions about Local Schema

What does Local Schema do?

When the user wants to implement LocalBusiness structured data, location schema, or local-specific JSON-LD markup. Local Schema is an agent skill from garrettjsmith/localseoskills. When the user wants to implement LocalBusiness structured data, location schema, or local-specific JSON-LD markup.

When should I use Local Schema?

Local Schema fits situations like: wants to implement LocalBusiness structured data; location schema; local-specific JSON-LD markup; the user mentions local schema.

How do I install Local Schema in Claude Code?

Run `npx skills add garrettjsmith/localseoskills --skill local-schema -a claude-code`. Or copy the skill folder (skills/local-schema in garrettjsmith/localseoskills) into .claude/skills/local-schema in your project. Claude Code loads it when a task matches its description.

How do I install Local Schema in Codex?

Run `npx skills add garrettjsmith/localseoskills --skill local-schema -a codex`. Or copy the skill folder (skills/local-schema in garrettjsmith/localseoskills) into .agents/skills/local-schema in your project. Codex loads it when a task matches its description.

Can I use Local Schema in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add garrettjsmith/localseoskills --skill local-schema -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/local-schema, .gemini/skills/local-schema, .github/skills/local-schema and .opencode/skills/local-schema in your project.

What does Local Schema need to run?

SKILL.md names no scripts, command-line tools or credentials: Local Schema is instructions for the agent only.

Does Local Schema access the network?

SKILL.md names 6 domains. In commands or code: schema.org, en.wikipedia.org, facebook.com and yelp.com; the agent is likely to contact these when it follows the instructions. As links in the text: search.google.com and validator.schema.org. This is read from the text; nothing was executed.

Is Local Schema safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Local Schema use?

Local Schema is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Local Schema use?

About 1.5k tokens (SKILL.md is roughly 6.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Local Schema?

Skills that share tags, products or a category with Local Schema: SEO Geo (ReScienceLab/opc-skills, 1.8k stars), GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars), Portaljs Add Dcat (datopian/portaljs, 2.4k stars) and Schema Markup (freekmurze/dotfiles, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Local Schema?

garrettjsmith (a GitHub user) maintains it in garrettjsmith/localseoskills, which has 114 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on August 15, 2026.

Source: garrettjsmith/localseoskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Local Schema

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Local Schema Markup

Core Principle

LocalBusiness Schema Template

@type Selection

Multi-Location Schema

SAB (Service Area Business) Schema

Validation

Tools

Common Errors

Task-Specific Questions

What to Do Next

Tools for This Skill

Files

Compare with similar skills

Similar skills

More from garrettjsmith/localseoskills

Related

Questions about Local Schema