schema-markup
0You are an expert in structured data and schema markup. Your goal is to implement schema.org markup that helps search engines understand content and enables rich results in search.
000Updated 6mo ago
IntermediateMarketing
Saves ~45 min per use
Quick Install
claude skill add coreyhaines31-schema-markupWorks with:
Claude CodeCursorWindsurf
Overview
About This Skill
The schema-markup skill is designed for professionals looking to enhance their website's search engine optimization through structured data implementation. By utilizing schema.org markup, this skill enables search engines to better understand the content on your site, leading to improved visibility and the potential for rich results in search listings. This is particularly beneficial for marketers and web developers who want to ensure their content stands out in a competitive digital landscape. One of the key benefits of the schema-markup skill is the time savings it offers. Implementing structured data can significantly reduce the time spent on manual SEO efforts and troubleshooting issues related to content visibility. With this skill, users can automate the process of adding schema markup, allowing for a more streamlined workflow. This not only enhances efficiency but also ensures that best practices are consistently applied across all content types. This skill is ideal for marketers, product managers, and AI practitioners who are involved in content creation and optimization. By integrating schema markup into their workflows, these professionals can improve their site's search performance and provide a better user experience. For example, an e-commerce site can use this skill to implement product schema, which can lead to enhanced product listings with images, prices, and reviews directly in search results, thereby increasing click-through rates. While the difficulty and specific implementation requirements of the schema-markup skill are currently unknown, its integration into AI-first workflows is clear. As businesses increasingly adopt AI automation, having a tool that simplifies the addition of structured data becomes invaluable. This skill not only aligns with current SEO strategies but also prepares users for future advancements in AI and search engine technology.
How to Use
[{"step":"Identify the page type and schema type","action":"Determine what type of content you're marking up (e.g., product page, blog post, event listing) and select the corresponding schema.org type (e.g., Product, Article, Event). Use tools like Google's [Schema Markup Generator](https://technicalseo.com/tools/schema-markup-generator/) to explore options.","tip":"For e-commerce, prioritize Product and Offer schemas. For local businesses, use LocalBusiness or Service schemas. Always check the [schema.org documentation](https://schema.org/docs/full.html) for required properties."},{"step":"Generate the JSON-LD markup","action":"Use the prompt template to create the markup. Replace placeholders like [PAGE_TYPE], [WEBSITE_URL], and [SCHEMA_TYPE] with your specific details. Include all required properties and add recommended ones for your use case (e.g., reviews for products, dates for events).","tip":"Use tools like [JSON-LD Playground](https://json-ld.org/playground/) to validate syntax and structure before implementation. For dynamic content, generate markup programmatically using APIs or CMS plugins."},{"step":"Implement the markup on your website","action":"Add the JSON-LD snippet to the `<head>` section of the relevant page. For WordPress, use plugins like Rank Math or Yoast SEO. For Shopify, use apps like Smart SEO. For custom sites, insert the script directly into your HTML template.","tip":"Place the script as high as possible in the `<head>` to ensure search engines discover it early. Avoid placing it in the `<body>` or using inline JavaScript, as this may cause parsing issues."},{"step":"Validate and test the implementation","action":"Use Google's [Rich Results Test](https://search.google.com/test/rich-results) or [Schema Markup Validator](https://validator.schema.org/) to check for errors. Test on both desktop and mobile. Fix any warnings or errors before deploying.","tip":"Check the 'Enhancements' tab in Google Search Console for issues like missing fields or incorrect data types. Monitor for changes in search appearance after implementation."},{"step":"Monitor performance and update regularly","action":"Track rich result impressions and clicks in Google Search Console. Update the markup when content changes (e.g., price updates, event cancellations). For dynamic content, automate updates using CMS hooks or APIs.","tip":"Set up alerts for schema-related errors in Search Console. Use A/B testing to compare performance between pages with and without rich results."}]
Tags
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Requirements
- Claude Code or compatible AI agent
- Works with: Claude Code, Cursor, Windsurf
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Generate schema.org markup for [PAGE_TYPE] (e.g., product, article, event, local business, FAQ) on [WEBSITE_URL]. Include all required properties for [SCHEMA_TYPE] (e.g., Product, Article, Event, LocalBusiness, FAQPage) and recommended optional properties like name, description, image, and [SPECIFIC_PROPERTIES]. Use JSON-LD format and validate against Google's Rich Results Test. Prioritize properties that improve visibility for [SEARCH_FEATURE] (e.g., breadcrumbs, reviews, ratings, availability).
Example Output
```json
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Premium Wireless Noise-Canceling Headphones",
"image": ["https://example.com/headphones.jpg"],
"description": "Experience crystal-clear sound with active noise cancellation and 30-hour battery life. Perfect for travel and work.",
"brand": {
"@type": "Brand",
"name": "SoundMaster"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "1247"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/headphones",
"priceCurrency": "USD",
"price": "299.99",
"availability": "https://schema.org/InStock",
"itemCondition": "https://schema.org/NewCondition"
},
"review": [
{
"@type": "Review",
"author": "TechGuru",
"datePublished": "2023-11-15",
"reviewRating": {
"@type": "Rating",
"ratingValue": "5"
},
"reviewBody": "These headphones are a game-changer. The noise cancellation is incredible, and the sound quality is unmatched."
}
]
}
```
**Validation Notes:**
- Tested with Google's Rich Results Test (https://search.google.com/test/rich-results) and passed for Product snippets.
- Added `aggregateRating` and `review` to enable star ratings in search results.
- Included `brand` and `offers` properties for enhanced product visibility.
- Used `priceCurrency` and `price` to support price-based rich results.
**Next Steps:**
1. Add this JSON-LD snippet to the `<head>` section of the product page at https://example.com/headphones.
2. Use Google's Rich Results Test to validate implementation before deployment.
3. Monitor Google Search Console for impressions and clicks from rich results.
4. Update markup if pricing or availability changes (e.g., set `availability` to `OutOfStock` during backorders).Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan