schema-markup-generator

Category: Developer Tools · Version: 1.0.0 · Author: OpenDirectory · Compatibility: All targets (claude, codex, opencode, gemini, anti-gravity, openclaw, hermes)

Generate valid JSON-LD structured data for any webpage. The agent crawls the page, detects which schema types apply, and outputs a script tag ready to paste into your HTML. Optionally opens a GitHub PR with the markup injected.

Install

npx CLI (Recommended)
skills.sh
Claude Code Native
Claude Desktop
Manus AI

npx "@opendirectory.dev/skills" install schema-markup-generator --target claude

npx skills add Varnan-Tech/opendirectory --skill schema-markup-generator

/plugin marketplace add Varnan-Tech/opendirectory
/plugin install opendirectory-gtm-skills@opendirectory-marketplace

Copy https://github.com/Varnan-Tech/opendirectory/tree/main/skills/schema-markup-generator into download-directory.github.io to download the ZIP.
Open Claude Desktop -> Customize -> Skills -> + -> Upload a skill and drop the folder containing SKILL.md.

Schema Types Supported

Type	Use When
FAQPage	Page has 2 or more visible question/answer pairs
Article / BlogPosting	Page is a blog post or editorial article
Organization	Page represents a company or institution
Product	Page sells or describes a product with pricing
WebSite	Homepage schema with optional sitelinks search
HowTo	Page is a step-by-step guide with numbered steps
BreadcrumbList	Page has visible breadcrumb navigation
SoftwareApplication	Page describes a software tool or app
LocalBusiness	Page represents a physical business location

The agent detects the right type automatically. A single page often gets multiple types (a blog post gets Article and BreadcrumbList, a homepage gets WebSite and Organization).

Requirements

No LLM API key needed. The agent reads the page and generates the markup. Chrome is needed for JavaScript-rendered pages. For static HTML pages or when you paste HTML directly, Chrome is not required. A GitHub token is optional. Without it, the agent outputs the markup as text for you to paste manually.

Setup

1. Start Chrome with remote debugging (for live URLs)

# macOS
open -a "Google Chrome" --args --remote-debugging-port=9222

# Linux
google-chrome --remote-debugging-port=9222

2. Configure environment variables (optional)

cp .env.example .env
# Add GITHUB_TOKEN if you want auto-PR support

How to Use

From a live URL:

"Generate schema markup for https://example.com/faq"
"Add structured data to https://example.com/blog/my-post"
"What schema markup does this page need? https://example.com/about"

From pasted HTML:

"Generate schema markup for this page: [paste HTML]"
"Add JSON-LD to this HTML: [paste HTML]"

Targeting a specific type:

"Generate FAQPage schema for https://example.com/support"
"Add Organization schema to our about page: https://example.com/about"
"Generate Product schema for this page: https://example.com/products/pro"

With auto-PR:

"Generate schema markup for https://example.com/blog/post and open a GitHub PR"

Output

Output	Description
JSON-LD script block	One `<script type="application/ld+json">` block per schema type
Placement instructions	Where to insert the block in your HTML or framework
MISSING field list	Required fields not found on the page that you need to fill in
GitHub PR	If GITHUB_TOKEN and GITHUB_REPO are configured and you confirm

Validate Your Markup

After applying the markup, validate it at:

Google Rich Results Test: https://search.google.com/test/rich-results
Schema.org Validator: https://validator.schema.org

Project Structure

schema-markup-generator/
├── SKILL.md
├── README.md
├── .env.example
├── evals/
│   └── evals.json
└── references/
    ├── json-ld-spec.md
    └── output-template.md

License

MIT

Catalog

Visual & Media

Content

Launch

GTM Intelligence

Outreach

Research

Developer Tools

Other

Install

Schema Types Supported

Requirements

Setup

1. Start Chrome with remote debugging (for live URLs)

2. Configure environment variables (optional)

How to Use

Output

Validate Your Markup

Project Structure

License

​Install

​Schema Types Supported

​Requirements

​Setup

​1. Start Chrome with remote debugging (for live URLs)

​2. Configure environment variables (optional)

​How to Use

​Output

​Validate Your Markup

​Project Structure

​License

Install

Schema Types Supported

Requirements

Setup

1. Start Chrome with remote debugging (for live URLs)

2. Configure environment variables (optional)

How to Use

Output

Validate Your Markup

Project Structure

License