schema-markup

What This Skill Does

The schema-markup skill is a specialized agent designed to assist users in implementing, auditing, and validating structured data using the JSON-LD format. Structured data is critical for modern search engine optimization, as it provides search engines and AI models with explicit clues about the meaning of content on a webpage. This skill helps bridge the gap between complex schema.org specifications and actionable website implementation.

By utilizing this skill, you can ensure your content qualifies for Google rich results, such as FAQ accordions, star ratings for product reviews, How-To guides, and Breadcrumb navigation. Beyond traditional search engines, the agent optimizes your content for AI search visibility, increasing the likelihood that your data will be correctly ingested and cited by AI models like Google's AI Overviews or Perplexity.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/alirezarezvani/cs-schema-markup

Use Cases

• Rich Result Troubleshooting: Use this when you have existing structured data but Google Search Console reports errors, or when you are not seeing the expected rich snippets in search results.
• New Schema Implementation: Use this when launching a new page type (e.g., a product catalog or an FAQ page) and you need clean, valid JSON-LD code that adheres to Google's strict requirements.
• AI Search Optimization: Use this to enhance your site's semantic structure, ensuring that large language models and AI crawlers can accurately interpret your business entities, events, and articles.
• Compliance Auditing: Use this to perform a periodic review of your site's schema to ensure that your markup remains up-to-date with changing schema.org standards.

Example Prompts

1. "I am getting a 'missing field' error in Google Search Console for my Product schema; can you help me fix the JSON-LD?"
2. "I want my FAQ page to show up with collapsible questions in Google search. Can you write the JSON-LD for these 5 questions?"
3. "My local business website isn't appearing correctly in AI search results. How can I improve my Organization and LocalBusiness schema to better define my location and services?"

Tips & Limitations

• Context is King: Always provide your site's URL and the specific CMS you are using. If you have marketing-context.md in your project, ensure it is updated so the agent can tailor its advice to your brand's specific SEO strategy.
• Don't Overdo It: Avoid 'schema stuffing.' Only use schema types that are directly supported by the visible content on the page to avoid manual action penalties from Google.
• Validation First: Always run the generated JSON-LD through validator.schema.org before deploying it to a production environment. While the agent is highly accurate, CMS-specific limitations (like stripping <script> tags) can sometimes break the implementation.