Add Review schema markup
SkillCommerce & financeThe review skill is an agent skill for adding and auditing review schema markup. It guides an AI agent through checking pages for Review and AggregateRating structured data, fixing missing or invalid markup, and verifying star-rating rich result eligibility for e-commerce and review sites.
Available today. Use it from your connected AI after setup.
No other account needed.
Have an agent environment that supports loading skills.
Then ask your AI: use the Add Review schema markup skill
What your AI can do with it
- Inspect page source or rendered DOM for JSON-LD Review and AggregateRating blocks
- Verify required properties: ratingValue, ratingCount/reviewCount, bestRating
- Add AggregateRating JSON-LD nested inside the main entity such as Product or LocalBusiness
- Run URLs through Google's Rich Results Test to validate markup
- Flag routes or templates where search-facing output violates the rule
- Explain which page types are eligible for star-rating rich results
Getting started
- Have an agent environment that supports loading skills.
- Add the review skill to the agent's available skills.
- Give the agent a product page, local business page, recipe, app, book page, or review aggregator page to check.
- Ask it to audit rich result eligibility or add Review and AggregateRating schema markup.
- Validate the resulting markup with Google's Rich Results Test before deploying.
What this skill tells your AI
The instructions your AI receives, as published by thedaviddias/front-end-checklist in skills/review/SKILL.md and read by ahel’s review.
Star ratings in search results increase click-through rates by up to 35%; incorrect or missing schema means competitors with valid markup capture that visibility advantage.
Quick Reference
- Use
Reviewschema on individual review pages andAggregateRatingon product/service pages to earn star-rating rich results AggregateRatingrequiresratingValue,ratingCountorreviewCount, and validbestRating/worstRatingvalues- Ratings must reflect genuine user reviews — Google penalises self-serving or fabricated ratings
- Validate markup with Google's Rich Results Test before deploying
Check
Inspect the page source or rendered DOM for JSON-LD blocks containing "@type": "Review" or "@type": "AggregateRating". Verify required properties are present: ratingValue, ratingCount/reviewCount, bestRating. Run the URL through Google's Rich Results Test.
Fix
Add a JSON-LD <script> block with AggregateRating nested inside the main entity (Product, LocalBusiness, etc.). Populate ratingValue and ratingCount from real review data. Remove any schema on pages with no genuine user reviews.
Explain
Explain how Review and AggregateRating schema work, which page types are eligible for star-rating rich results in Google Search, and why fabricated ratings violate Google's structured data guidelines.
Code Review
Review metadata generation, rendered HTML, structured data, and response headers related to Add Review schema markup. Flag exact routes or templates where search-facing output violates the rule, and describe how to verify the final page output.
For full implementation details, code examples, and framework-specific guidance,
see references/rule.md.
Signals
- GitHub stars
- 74k
- Forks
- 7k
- Last commit
- Aug 2026
- Hacker News mentions
- 20
Questions
- When should the review skill be used?
- Use it on product pages, local business pages, recipes, apps, books, and any page that aggregates user reviews, or when auditing rich result eligibility for e-commerce or review sites.
- What properties does AggregateRating require?
- It requires ratingValue, ratingCount or reviewCount, and valid bestRating and worstRating values.
- Can ratings be fabricated to earn stars?
- No. Ratings must reflect genuine user reviews. Google penalises self-serving or fabricated ratings, and schema should be removed from pages with no genuine user reviews.
Advanced
- Item type
- skill
- Key
review-thedaviddias- Source
- github.com/thedaviddias/front-end-checklist
github.com/thedaviddias/front-end-checklist