Schema Markup
- 963 installs
- 787 repo stars
- Updated June 9, 2026
- kostja94/marketing-skills
schema-markup is a marketing agent skill that generates accurate Schema.org JSON-LD structured data for developers who need rich snippets and improved AI-search visibility on production web pages.
About
schema-markup is an SEO skill that produces Schema.org JSON-LD markup aligned to page content so search engines and AI answer engines can parse entities, offers, and FAQs reliably. Developers reach for schema-markup when shipping landing pages, product detail URLs, or documentation that should earn rich results instead of plain blue links. The skill emphasizes valid structured data over keyword stuffing, helping teams avoid JSON-LD syntax errors that block eligibility for enhanced SERP features. It fits post-build launch work where HTML exists and metadata needs a structured-data layer.
- Generates Schema.org JSON-LD for 15+ core types including Article, Product, FAQPage, Organization, HowTo, BreadcrumbList
- Optimizes structured data for both traditional SERP rich results and Generative Engine Optimization
- Validates against Google Rich Results Test and Schema Markup Validator rules
- Provides implementation guidance with first-use educational framing then direct output on repeat calls
- Distinguishes between markup generation and broader AI-search visibility strategy
Schema Markup by the numbers
- 963 all-time installs (skills.sh)
- +6 installs in the week ending Jul 29, 2026 (Skillselion tracking)
- Ranked #454 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/kostja94/marketing-skills --skill schema-markupAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 963 |
|---|---|
| repo stars | ★ 787 |
| Security audit | 3 / 3 scanners passed |
| Last updated | June 9, 2026 |
| Repository | kostja94/marketing-skills ↗ |
How do you add Schema.org JSON-LD for rich snippets?
Generate accurate Schema.org JSON-LD markup that improves rich snippets and AI-search visibility.
Who is it for?
Developers shipping marketing or product pages who need correct JSON-LD for rich snippets and AI-search parsers.
Skip if: Teams seeking only local Google Business Profile or citation audits without on-page structured data.
When should I use this skill?
The user asks for Schema.org markup, JSON-LD, rich snippets, or structured data for SEO and AI search visibility.
What you get
Validated Schema.org JSON-LD script blocks embedded-ready for target page types.
- JSON-LD script blocks
- Schema type recommendations
- Rich-snippet-ready structured data
Files
SEO: Local
Guides local SEO: Google Business Profile, NAP consistency, and citation building. Businesses with accurate NAP across 40+ authoritative sites see ~19% higher visibility in Google Maps. Use this skill when optimizing for local search, setting up GBP, or auditing citations.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read Sections 4 (Audience), 5 (Website).
Identify: 1. Business type: Storefront vs service-area 2. Location: Single or multiple 3. Current listings: Existing GBP, directories
NAP Consistency
NAP = Name, Address, Phone. Critical for local rankings.
| Rule | Guideline |
|---|---|
| Exact match | "Street" vs "St." or "LLC" inconsistency = Google may treat as different entities |
| Fix first | Audit and fix inconsistencies before adding new citations |
| Tools | BrightLocal, Whitespark, Moz Local for audit |
Google Business Profile
| Element | Guideline |
|---|---|
| Address | Physical address; no P.O. boxes |
| Description | 750 chars; primary keywords in first 100 |
| Hours | Accurate; seasonal availability |
| Category | Primary category matches business type |
| Service-area | Hide address if no storefront; define service areas |
Citation Building
Targeted precision over submitting to every directory.
Priority order: 1. Google Business Profile 2. Apple Maps 3. Yelp, Bing Places, Facebook 4. Better Business Bureau, Foursquare, Nextdoor 5. Niche directories (Healthgrades, Angi, etc.)
Citation Audit
- Incorrect or outdated data
- Duplicate entries
- Missing listings on key directories
Fix before adding; compounding errors harm rankings.
Output Format
- NAP (exact format for consistency)
- GBP optimization checklist
- Citation priority list
- Audit findings (if applicable)
Related Skills
- geo: GEO for AI search; local + AI overlap
- localization-strategy: Multilingual; local + i18n
- directory-submission: Directory listings; different from local citations
Related skills
Seo AuditRun structured SEO audits on their SaaS site or content hub and receive a prioritized action plan.173k42.2kCopywritingGenerate, rewrite, or strengthen persuasive website and landing-page copy that converts visitors into users.164k42.2k
Viral Short FormQuickly generate high-retention hooks, scripts, and outlines for TikTok, Reels, YouTube Shorts, and carousels.132k67Viral HooksWrite and critique viral hooks for short-form video opening sequences.123k67Viral Captions And CtasOptimize social media captions and CTAs for viral short-form video reach and saves.123k67Viral Youtube ShortsWrite and diagnose YouTube Shorts for Shorts Feed and long-form funnel.123k67FAQ
What output does schema-markup produce?
schema-markup produces Schema.org JSON-LD script blocks developers embed in HTML for rich snippets and machine-readable page semantics. Output is tailored to the page type such as product, article, or FAQ.
Is schema-markup the same as local SEO setup?
schema-markup handles on-page Schema.org JSON-LD structured data. Local SEO tasks like Google Business Profile and NAP citations are separate workflows in the broader marketing-skills collection.
Is Schema Markup safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.