schemalisted
Install: claude install-skill sitetiller/ai-visibility-skills
# Structured data: only what Google documents, only what is on the page
Google says structured data does not guarantee a rich result, and the markup must describe content visible on the page. The skill lints what is on a live page, recommends types per page type from Google's search gallery, and sends the final check to Google's Rich Results Test.
## Inputs
- The URL of a live page (or the user's draft JSON-LD to paste in a test page they own).
- Page type: article, product or software page, comparison, homepage, tool.
## Steps
1. Lint:
```bash
npx sitetiller schema https://example.com/guides/invoice-template --json
```
Output: `url`, `status`, `types` (type to count) and `findings` (`level` error, warning or info; `type`; `message`; `doc` link). Errors are missing properties that Google documents as required for the rich result. Warnings are recommended properties or duplicated entities. Info lines mark features that no longer produce rich results.
2. Interpret with the table.
| Finding | Meaning | Action |
|---|---|---|
| Invalid JSON-LD | The block does not parse; Google cannot read it | Fix syntax (trailing commas, unescaped quotes) |
| SoftwareApplication missing `offers.price` | Google requires `name` and `offers.price` (use `0` for free; add `priceCurrency` for paid) | Add the price shown on the page |
| SoftwareApplication missing `aggregateRating` or `review` | Google says one of the two must be included | Add genuine, visible user ratings, or do not