Agent skill

SEO Aeo Schema Generator

by henryalouf in henryalouf/ruflow

Generates valid JSON-LD structured data for 10 schema types with rich result eligibility validation and implementation-ready script blocks.

MITAuto-check passedMarketing & SEO

Install SEO Aeo Schema Generator

skills CLI
$ npx skills add henryalouf/ruflow --skill seo-aeo-schema-generator -a claude-code

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

GitHub CLI
$ gh skill install henryalouf/ruflow seo-aeo-schema-generator --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/henryalouf/ruflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/seo-aeo-schema-generator .claude/skills/seo-aeo-schema-generator && 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/

Facts

Skill name
seo-aeo-schema-generator
GitHub stars
157
Token cost
~1.1k tokens
SKILL.md length
469 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Generates valid JSON-LD structured data for 10 schema types with rich result eligibility validation and implementation-ready script blocks.

  • Works in 5 steps: Recommend Schema Types → Use Built-In Schema Templates → Populate Fields → …
  • Wants to generate schema markup
  • SKILL.md covers Overview, When to Use This Skill, Supported Schema Types and How It Works, plus 5 more sections
  • Reaches schema.org

What it does

SEO Aeo Schema Generator is an agent skill from henryalouf/ruflow. Generates valid JSON-LD structured data for 10 schema types with rich result eligibility validation and implementation-ready script blocks. Activate when the user wants to generate schema markup, JSON-LD, or structured data for any page.

Its SKILL.md is about 1.1k 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 and AI search optimization. The licence is MIT.

When your agent uses it

  • Wants to generate schema markup
  • Structured data for any page

Example prompts

  • “Use the seo-aeo-schema-generator skill to generate valid JSON-LD structured data for 10 schema types with rich result eligibility validation and…”
  • “/seo-aeo-schema-generator”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Recommend Schema Types
  2. Use Built-In Schema Templates
  3. Populate Fields
  4. Validate
  5. Output Script Blocks

What it can do on your machine

Read from SKILL.md and the folder at commit 568d7a5. 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 html).

    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:

    • github.com

    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

SEO Aeo Schema Generator loads about 1.1k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 469 words of instructions outside code blocks.

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

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 henryalouf/ruflow at commit 568d7a5, republished under its MIT licence (© henryalouf). 469 words, ~1,136 tokens.

Download SKILL.mdSave it as .claude/skills/seo-aeo-schema-generator/SKILL.md (or your agent's skills folder).
name
seo-aeo-schema-generator
description
Generates valid JSON-LD structured data for 10 schema types with rich result eligibility validation and implementation-ready script blocks. Activate when the user wants to generate schema markup, JSON-LD, or structured data for any page.
risk
safe
source
community
date_added
2026-04-01

SEO-AEO Schema Generator

Overview

Generates implementation-ready JSON-LD schema markup for 10 schema types including FAQPage, Article, Product, HowTo, and BreadcrumbList. Validates all required fields against Google rich result eligibility rules, flags missing fields with exact fix instructions, and outputs one clean <script> block per schema type ready to paste into the page <head>.

Part of the SEO-AEO Engine.

When to Use This Skill

  • Use when adding structured data to a new landing page or blog post
  • Use when a page needs FAQ rich results or product star ratings in search
  • Use when validating existing schema for Google rich result eligibility
  • Use after the content-quality-auditor flags missing schema

Supported Schema Types

TypeRich Result Unlocked
FAQPageFAQ accordion in SERP — AEO critical
ArticleArticle rich result, Top Stories
ProductPrice, availability, rating in SERP
HowToStep-by-step rich result
ReviewStar rating in SERP
AggregateRatingStar rating with review count
BreadcrumbListBreadcrumb path in SERP URL
OrganizationBrand knowledge panel signals
WebPageEnhanced page understanding
WebSiteSitelinks Searchbox

How It Works

Step 1: Recommend Schema Types

If schema types are not specified, recommend the appropriate types based on the page type. Landing pages get FAQPage + Product + BreadcrumbList. Blog posts get Article + FAQPage + BreadcrumbList.

Step 2: Use Built-In Schema Templates

Using your knowledge of schema.org and Google's rich result requirements, construct the JSON-LD template for each requested schema type. Use the required and recommended fields listed in the Google Rich Results documentation for that type.

Step 3: Populate Fields

Map all page data to template placeholders. Check every required field against the rich result eligibility rules.

Step 4: Validate

Flag any missing required field as a Critical issue. Flag missing recommended fields as warnings. Do not output schema with missing required fields.

Show full SKILL.md (180 more words)Show less
Step 5: Output Script Blocks

Write one <script type="application/ld+json"> block per schema type. Include implementation instructions and testing tool links.

Examples

Example: FAQPage Schema Output
html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is Syncro?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Syncro is a remote-first project management platform for distributed engineering teams. It centralises task tracking, async communication, and sprint planning in one tool."
      }
    }
  ]
}
</script>

Best Practices

  • ✅ Do: Always include FAQPage schema on any page with a FAQ section — it is the strongest AEO signal
  • ✅ Do: Use one <script> block per schema type — never combine multiple types
  • ✅ Do: Test every output in Google's Rich Results Test before deploying
  • ❌ Don't: Use relative URLs anywhere in schema — all URLs must start with https://
  • ❌ Don't: Leave placeholder text in any field before deploying
  • ❌ Don't: Use HTML tags inside JSON-LD string values

Common Pitfalls

  • Problem: Schema passes validation but rich result doesn't appear in search Solution: Rich results can take weeks to appear after deployment. Request re-indexing in Google Search Console immediately after adding schema.

  • Problem: Product schema missing star rating display Solution: Add AggregateRating object with ratingValue, reviewCount, bestRating, and worstRating — all four fields required.

  • @seo-aeo-landing-page-writer — provides the FAQ and product data for schema population
  • @seo-aeo-content-quality-auditor — flags schema gaps during the audit

Additional Resources

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

Files

Just SKILL.md in .agents/skills/seo-aeo-schema-generator of henryalouf/ruflow.

Open the folder on GitHubat commit 568d7a5

Compare with similar skills

SEO Aeo Schema Generator 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.

SEO Aeo Schema Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Aeo Schema Generator this skillhenryalouf/ruflow157—~1.1kAutomated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
Geoliangdabiao/GEO-Content-Optimizer-Skill2051 repos~2.3kAutomated safety check: NotesMIT
SEO and GEO Auditdageno-agents/seo-geo-audit176—~2kAutomated safety check: PassMIT
Geo Optimizerliangdabiao/GEO-Content-Optimizer-Skill205—~1.1kAutomated safety check: PassNone

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
  • Geo

    liangdabiao/GEO-Content-Optimizer-Skill

    完整的 GEO(生成式引擎优化)服务流水线:给一个产品官网 URL 和介绍材料, 做站点诊断与 AI 答案采样、生成带验收标准的执行工单、产出可直接部署的资产 (llms.txt / JSON-LD / 定义块 / FAQ / 内容大纲与初稿)、自动验收工单是否闭环、 并打包成可直接发给客户的交付物。可按周期复跑,做长期 GEO 运营与月报。

    205 GitHub starsUsed in 1 repo~2.3k tokens
    Marketing & SEOAuto-check: notes
  • SEO and GEO Audit

    dageno-agents/seo-geo-audit

    Runs one prioritized audit that combines technical SEO, content quality, trust signals, entity clarity and AI search readiness for a page, site or domain.

    176 GitHub stars~2k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Geo Optimizer

    liangdabiao/GEO-Content-Optimizer-Skill

    GEO (Generative Engine Optimization) 全流程优化工具。帮助品牌内容被 ChatGPT、Perplexity、Gemini 等 AI 搜索引擎引用。

    205 GitHub stars~1.1k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Universal SEO Analysis

    AgriciDaniel/claude-seo

    Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.

    19k GitHub stars~4.9k tokensUpdated 6 days ago
    Marketing & SEOAuto-check passed

More from henryalouf/ruflow

All 13 skills in this repo
  • Agents Md

    henryalouf/ruflow

    This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise.

    157 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Claimable Postgres

    henryalouf/ruflow

    Provision instant temporary Postgres databases via Claimable Postgres by Neon (pg.new).

    157 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check: notes
  • Run local evaluations for Hugging Face Hub models with inspect-ai or lighteval.

    157 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Train or fine-tune TRL language models on Hugging Face Jobs, including SFT, DPO, GRPO, and GGUF export.

    157 GitHub stars~6.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Train or fine-tune vision models on Hugging Face Jobs for detection, classification, and SAM or SAM2 segmentation.

    157 GitHub stars~7.4k tokensUpdated 4 mo ago
    Auto-check passed
  • SEO Aeo Blog Writer

    henryalouf/ruflow

    Writes long-form blog posts with TL;DR block, definition sentence, comparison table, and 5-question FAQ for SEO ranking and AEO citation.

    157 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about SEO Aeo Schema Generator

What does SEO Aeo Schema Generator do?

Generates valid JSON-LD structured data for 10 schema types with rich result eligibility validation and implementation-ready script blocks. SEO Aeo Schema Generator is an agent skill from henryalouf/ruflow. Generates valid JSON-LD structured data for 10 schema types with rich result eligibility validation and implementation-ready script blocks.

When should I use SEO Aeo Schema Generator?

SEO Aeo Schema Generator fits situations like: wants to generate schema markup; structured data for any page.

How do I install SEO Aeo Schema Generator in Claude Code?

Run `npx skills add henryalouf/ruflow --skill seo-aeo-schema-generator -a claude-code`. Or copy the skill folder (.agents/skills/seo-aeo-schema-generator in henryalouf/ruflow) into .claude/skills/seo-aeo-schema-generator in your project. Claude Code loads it when a task matches its description.

How do I install SEO Aeo Schema Generator in Codex?

Run `npx skills add henryalouf/ruflow --skill seo-aeo-schema-generator -a codex`. Or copy the skill folder (.agents/skills/seo-aeo-schema-generator in henryalouf/ruflow) into .agents/skills/seo-aeo-schema-generator in your project. Codex loads it when a task matches its description.

Can I use SEO Aeo Schema Generator 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 henryalouf/ruflow --skill seo-aeo-schema-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-aeo-schema-generator, .gemini/skills/seo-aeo-schema-generator, .github/skills/seo-aeo-schema-generator and .opencode/skills/seo-aeo-schema-generator in your project.

What does SEO Aeo Schema Generator need to run?

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

Does SEO Aeo Schema Generator access the network?

SKILL.md names 2 domains. In commands or code: schema.org; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is SEO Aeo Schema Generator 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 SEO Aeo Schema Generator use?

SEO Aeo Schema Generator 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 SEO Aeo Schema Generator use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 SEO Aeo Schema Generator?

Skills that share tags, products or a category with SEO Aeo Schema Generator: SEO Geo (ReScienceLab/opc-skills, 1.8k stars), GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars), Geo (liangdabiao/GEO-Content-Optimizer-Skill, 205 stars) and SEO and GEO Audit (dageno-agents/seo-geo-audit, 176 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Aeo Schema Generator?

henryalouf (a GitHub user) maintains it in henryalouf/ruflow, which has 157 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on May 18, 2026.

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