Algo Seo Schema

asgard-ai-platform/algo-seo-schema

Implement Schema.org structured data markup in JSON-LD format for enhanced search results. Use this skill when the user needs to add rich snippets to web pages, implement FAQ/Product/Article schema, or validate structured data — even if they say 'rich snippets', 'structured data', or 'Google rich results'.

8k tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

223

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/asgard-ai-platform/skills --skill algo-seo-schema

What comes with it

26 756 bytes besides the instruction

examples/sample_scenario.md

references/type-properties.md

references/validation-errors.md

The instruction itself

14 sections, as written by the author

Schema.org Structured Data

Overview

Schema.org structured data provides machine-readable page context to search engines via JSON-LD. Enables rich results (stars, FAQs, breadcrumbs, product cards) in SERPs. Implementation is O(1) per page — it's a markup task, not computational.

When to Use

Trigger conditions:

Adding rich snippet eligibility to web pages
Implementing product, article, FAQ, HowTo, or event markup
Debugging Google Search Console structured data errors

When NOT to use:

When optimizing page content or keywords (use content SEO)
When improving page speed (use Core Web Vitals optimization)

Algorithm

IRON LAW: Schema Markup Must MATCH Visible Content
Marking up content that users can't see violates Google guidelines
and risks manual penalties. Every structured data field must
correspond to content visible on the page.

Phase 1: Input Validation

Identify page type (Article, Product, FAQ, HowTo, Event, etc.). Map visible content to required and recommended schema properties.

Gate: Page type identified, all required properties have visible content.

Phase 2: Core Algorithm

Select the correct Schema.org type from the vocabulary
Map page content to schema properties (name, description, image, etc.)
Build JSON-LD object with @context and @type
Handle nested types (e.g., Product contains Offer contains Price)
Place JSON-LD in <script type="application/ld+json"> in <head>

Phase 3: Verification

Validate with Google Rich Results Test. Check: no errors, all required fields present, no mismatch with visible content.

Gate: Passes Google Rich Results Test with zero errors.

Phase 4: Output

Return complete JSON-LD markup ready for insertion.

Output Format

{
  "schema": {"@context": "https://schema.org", "@type": "Product", "name": "...", "offers": {"@type": "Offer", "price": "29.99", "priceCurrency": "TWD"}},
  "validation": {"errors": 0, "warnings": 1, "eligible_rich_results": ["Product snippet"]}
}

Examples

Sample I/O

Input: FAQ page with 3 questions and answers

Expected: FAQPage schema with 3 Question/Answer pairs in JSON-LD

Edge Cases

| Input | Expected | Why |

|-------|----------|-----|

| Page with no clear type | Use WebPage as fallback | Most generic valid type |

| Multiple schemas needed | Array of JSON-LD objects | One page can have multiple types |

| Missing required field | Error, do not generate | Incomplete schema hurts more than none |

Gotchas

Required vs recommended: Google requires certain fields per type. Missing required fields = schema ignored entirely. Check documentation per type.
Nesting depth: Deeply nested schemas (Product > Offer > Seller > Address) are error-prone. Validate each nesting level.
Schema spam: Adding schema for content not on the page (fake reviews, unavailable prices) triggers manual actions.
Type specificity: Use the most specific type available. "Article" is better than "WebPage"; "NewsArticle" is better than "Article" for news content.
Testing gap: Google Rich Results Test shows what Google sees, but not all valid schema triggers rich results. Eligibility ≠ guarantee of display.

References

For complete property reference by type, see references/type-properties.md
For common validation errors and fixes, see references/validation-errors.md

How to use it

Copy the folder

Take asgard-ai-platform/algo-seo-schema from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.