aaron-he-zhu/aaron-marketing-skills / seo-geo/implement/serp-markup-builder
serp-markup-builder
VerifiedUse when the user asks to "optimize meta tags", "write title tags / meta descriptions", "add Open Graph or Twitter cards", or "generate schema / JSON-LD" for FAQ, HowTo, Article, Product, or LocalBusiness rich-result candidates. Produces title/description options, an OG+Twitter block, and validated JSON-LD for the document head. Not for body copy — use content-writer; not for crawl/index technical issues — use technical-seo-checker. 标题优化/元描述/Schema标记/结构化数据
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.4 KB |
| references/ctr-and-social-reference.md | markdown | 1.9 KB |
| references/meta-instructions-detail.md | markdown | 3.1 KB |
| references/meta-tag-code-templates.md | markdown | 2.6 KB |
| references/meta-tag-formulas.md | markdown | 4.9 KB |
| references/schema-decision-tree.md | markdown | 3.3 KB |
| references/schema-instructions-detail.md | markdown | 3.6 KB |
| references/schema-templates.md | markdown | 6.2 KB |
| references/validation-guide.md | markdown | 4.8 KB |
references/schema-instructions-detail.md
View on GitHub# Schema Markup Generator — Detailed Instructions
Compact workflow, schema mapping, implementation guidance, validation checklist, and FAQ example for the Schema Markup Generator skill.
## Step 1: Identify Content Type and Rich Result Opportunity
Use CORE-EEAT `O05` to match content type to schema:
| Content Type | Required Schema | Conditional Schema |
|--------------|-----------------|--------------------|
| Blog guide | Article, Breadcrumb | FAQ, HowTo |
| Blog tools | Article, Breadcrumb | FAQ, Review |
| Best-of / alternatives | ItemList, Breadcrumb, FAQ | AggregateRating |
| Landing page | SoftwareApplication, Breadcrumb, FAQ | WebPage |
| FAQ page | FAQPage, Breadcrumb | — |
| Testimonial page | Review, Breadcrumb | FAQ, Person |
Then evaluate rich-result eligibility:
| Rich Result Type | Eligibility | Impact |
|------------------|-------------|--------|
| FAQ | Yes/No | High |
| How-To | Yes/No | Medium |
| Product | Yes/No | High |
| Review | Yes/No | High |
| Article | Yes/No | Medium |
| Breadcrumb | Yes/No | Medium |
| Video | Yes/No | High |
## Step 2: Generate Schema Markup
For the chosen schema type:
- Include all required properties
- Add optional properties only when they are true and visible on page
- Include a short rich-result preview
- Split fields into required vs. optional notes
- Note which fields affect rich-result eligibility
- Combine multiple schema types inside one JSON array when needed
> **Reference**: See [references/schema-templates.md](schema-templates.md) for copy-start JSON-LD templates.
## Step 3: Provide Implementation and Validation
```markdown
## Implementation Guide
### Placement
- `<head>` is preferred
- Before `</body>` also works if the stack requires it
### Validation Checklist
- [ ] JSON is valid
- [ ] Required properties are present
- [ ] URLs are absolute
- [ ] Dates use ISO 8601
- [ ] Schema matches visible page content
- [ ] No policy violations
```
Validation flow:
1. Test with ~~schema validator
2. Re-check in Schema.org Validator
3. Monitor ~~search console enhancements and rich-result reports
## Example FAQ Schema for SEO Page
**User**: "Generate FAQ schema for a page about SEO with 3 questions"
```json
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is SEO?",
"acceptedAnswer": {
"@type": "Answer",
"text": "[direct answer]"
}
},
{
"@type": "Question",
"name": "How long does SEO take?",
"acceptedAnswer": {
"@type": "Answer",
"text": "[direct answer]"
}
},
{
"@type": "Question",
"name": "Is SEO better than paid ads?",
"acceptedAnswer": {
"@type": "Answer",
"text": "[direct answer]"
}
}
]
}
```
Wrap the JSON-LD in `<script type="application/ld+json">...</script>` and validate it before deployment.
## Schema Type Quick Reference
| Content Type | Schema Type | Key Properties |
|--------------|-------------|----------------|
| Blog Post | BlogPosting / Article | headline, datePublished, author |
| Product | Product | name, offers, availability |
| FAQ | FAQPage | Question, Answer |
| How-To | HowTo | step, totalTime |
| Local Business | LocalBusiness | address, geo, openingHours |
| Recipe | Recipe | ingredients, cookTime |
| Event | Event | startDate, location |
| Video | VideoObject | uploadDate, duration |
| Course | Course | provider, name |
| Review | Review | itemReviewed, ratingValue |
## Tips for Success
Match visible content, avoid unsupported claims, keep values fresh, validate thoroughly, and watch Search Console after launch.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |