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.
npx "@opendirectory.dev/skills" install schema-markup-generator --target claudeWatch this quick video to see how it's done:
install-skill-on-claude-compress.mp4
- Copy the URL of this specific skill folder from your browser's address bar.
- Go to download-directory.github.io.
- Paste the URL and click Enter to download.
- Open your Claude desktop app.
- Go to the sidebar on the left side and click on the Customize section.
- Click on the Skills tab, then click on the + (plus) icon button to create a new skill.
- Choose the option to Upload a skill, and drag and drop the
.zipfile (or you can extract it and drop the folder, both work).
Note: For some skills (like
position-me), theSKILL.mdfile might be located inside a subfolder. Always make sure you are uploading the specific folder that contains theSKILL.mdfile!
| 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).
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.
# macOS
open -a "Google Chrome" --args --remote-debugging-port=9222
# Linux
google-chrome --remote-debugging-port=9222cp .env.example .env
# Add GITHUB_TOKEN if you want auto-PR supportFrom 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 | 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 |
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
schema-markup-generator/
├── SKILL.md
├── README.md
├── .env.example
├── evals/
│ └── evals.json
└── references/
├── json-ld-spec.md
└── output-template.md
MIT