# Add Valid Schema Markup to Web Pages

Search engines need structured data that matches visible page content. This skill guides JSON-LD schema selection, implementation, validation, and troubleshooting.

## Install

```bash
npx skillstore add coreyhaines31/schema-markup
```

## Metadata

- Status: approved
- Slug: coreyhaines31-schema-markup
- Skillstore revision: r1
- Version status: missing
- Tree hash: 7fc98a26e22d9458c8550e773a67f5b43c6c883891229909d851563f7c6f9313
- Author: coreyhaines31
- GitHub username: coreyhaines31
- License: MIT
- Repository: https://github.com/coreyhaines31/marketingskills/tree/main/skills/schema-markup
- Ref: d11af420e07cd866fe39cfa937efef3223896c06
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/coreyhaines31-schema-markup
- Manifest: https://skillstore.pages.dev/api/skills/coreyhaines31-schema-markup/manifest

## Capabilities

- Selects schema.org types for organization, product, article, FAQ, event, and local business pages.
- Defines required and recommended fields for common rich result formats.
- Provides JSON-LD implementation patterns for static sites, React, Next.js, CMS, and WordPress.
- Explains how to validate markup with rich result and schema validation tools.
- Identifies common schema errors, including missing fields and mismatched page content.
- Suggests questions to gather page type, goal, data, existing schema, and tech stack details.

## Use Cases

- Launch Product Schema: Create product structured data with offers, availability, ratings, and visible page details.
- Improve Article Eligibility: Map blog or news content to article markup with author, image, publisher, and dates.
- Fix Validation Errors: Review structured data issues and prepare updates for testing in validation tools.

## Prompt Templates

### Choose Schema Type

```
Review this page description and recommend the best schema.org type. Explain required fields and any rich result limits.
```

### Draft Page Markup

```
Create JSON-LD schema for this page using only the visible content and data I provide. Include placement and validation notes.
```

### Audit Existing Markup

```
Audit this existing schema markup against the visible page content. List missing fields, mismatches, warnings, and recommended fixes.
```

### Design Multi-Type Schema

```
Design a connected schema graph for this page. Include entity relationships, stable identifiers, implementation placement, and a testing checklist.
```

## Limitations

- It does not guarantee rich results because search engines make final display decisions.
- It does not automatically inspect live pages unless the host agent has separate browsing tools.
- It depends on accurate page content and business data from the user.
- It does not replace current Google policy review for sensitive or regulated markup.

## Best Practices

- Match every schema field to visible or authoritative page content.
- Use JSON-LD and validate changes before publishing them.
- Keep markup updated when prices, dates, ratings, hours, or page content change.

## Anti Patterns

- Do not mark up content that users cannot see on the page.
- Do not add self-serving reviews or ratings that violate search guidelines.
- Do not copy generic examples without replacing placeholder data with real page data.

## Security Audit

- Audited at: 2026-07-06T07:12:04.768\+00:00
- Summary: The static findings are false positives from markdown syntax, JSON-LD examples, placeholder URLs, and validation references. No executable command use, network data transfer, reconnaissance instruction, or prompt injection was found in SKILL.md.

## Stats

- Views: 208
- Downloads: 10
- Favorites: 0
- Popularity score: 0