npx claudepluginhub aitytech/agentkits-marketing --plugin agentkits-marketingpage-type-or-urlseo/Prerequisites
Before running this command, ensure you have:
- Page type or URL identified
- Current schema status known
- Rich result goals defined
Context Loading
Load these files first:
./README.md- Product context./docs/seo/- Existing SEO research.claude/skills/schema-markup/SKILL.md- Schema frameworks
Language & Quality Standards
CRITICAL: Respond in the same language the user is using. If Vietnamese, respond in Vietnamese. If Spanish, respond in Spanish.
Standards: Token efficiency, sacrifice grammar for concision, list unresolved questions at end.
Skills: Activate schema-markup, seo-mastery skills.
Components: Reference ./.claude/components/interactive-questions.md
Interactive Parameter Collection
Step 1: Ask Output Scope
Question: "What level of schema markup do you need?" Header: "Scope" MultiSelect: false
Options:
- Basic - Single schema type
- Recommended - Multiple schemas with validation
- Complete - Full implementation with testing
- Custom - I'll specify requirements
Step 2: Ask Page Type
Question: "What type of page needs schema markup?" Header: "Page" MultiSelect: false
Options:
- Article/Blog - Content pages
- Product/Service - E-commerce, SaaS
- Local Business - Physical locations
- Organization - Company pages
Step 3: Ask Schema Types
Question: "Which schema types do you need?" Header: "Schema" MultiSelect: true
Options:
- FAQ - FAQ sections for rich snippets
- HowTo - Step-by-step instructions
- Review/Rating - Star ratings display
- Breadcrumb - Navigation structure
Step 4: Ask Current State
Question: "What's your current schema status?" Header: "Status" MultiSelect: false
Options:
- No Schema - Starting fresh
- Basic Schema - Some markup exists
- Has Errors - Validation issues
- Optimizing - Enhancing existing
Step 5: Confirmation
Display summary:
## Schema Markup Configuration
| Parameter | Value |
|-----------|-------|
| Page | [page description] |
| Page Type | [selected type] |
| Schema Types | [selected schemas] |
| Current Status | [selected status] |
| Scope | [Basic/Recommended/Complete] |
Question: "Create schema markup?" Header: "Confirm" MultiSelect: false
Options:
- Yes, create schema - Start schema work
- No, change settings - Go back to modify
Common Schema Types
| Schema Type | Use For | Rich Result |
|---|---|---|
| Article | Blog posts, news | Article cards |
| Product | E-commerce, SaaS | Product info, reviews |
| FAQ | FAQ sections | Expandable FAQ |
| HowTo | Tutorials, guides | Step cards |
| Organization | Company info | Knowledge panel |
| LocalBusiness | Local services | Maps, info |
| Review/Rating | Reviews | Star ratings |
| Breadcrumb | Navigation | Breadcrumb trail |
| Video | Video content | Video thumbnails |
| Event | Events, webinars | Event listings |
| Person | About pages | Knowledge panel |
| SoftwareApplication | Apps, tools | App info |
Workflow
-
Page Type Analysis
- Identify page purpose
- Determine applicable schema types
- Check current markup (if any)
-
Schema Generation
- Use JSON-LD format (preferred)
- Include required properties
- Add recommended properties
- Validate with tools
-
Rich Result Eligibility
- Check if page qualifies
- Meet content guidelines
- Ensure accuracy
-
Testing & Validation
- Google Rich Results Test
- Schema.org validator
- Search Console monitoring
JSON-LD Best Practices
- Place in
<head>: Cleaner, easier to manage - One script per type: Or combine related types
- Match visible content: Schema must reflect page content
- Keep updated: Especially prices, dates, availability
Agent Delegation
| Task | Agent | Trigger |
|---|---|---|
| Schema creation | seo-specialist | Primary task |
| Content analysis | copywriter | Property values |
| Technical review | attraction-specialist | Implementation |
Output Format
Basic Scope
## Schema Markup: [Page Type]
### JSON-LD Code
```json
{
"@context": "https://schema.org",
"@type": "[Type]",
...
}
Placement
[Where to add in HTML]
### Recommended Scope
[Include Basic + Multiple schema types + Property explanations + Validation results + Rich result preview]
### Complete Scope
[Include all + All applicable schemas + Testing checklist + Implementation guide + Monitoring setup + Error handling]
---
## Validation Checklist
- [ ] Required properties included
- [ ] Recommended properties added
- [ ] Validated with testing tool
- [ ] No errors or warnings
- [ ] Content matches visible page
---
## Pre-Delivery Validation
Before delivering schema markup:
- [ ] JSON-LD syntax valid
- [ ] Required properties included
- [ ] Content matches visible page
- [ ] Tested with validation tools
- [ ] Implementation instructions clear
---
## Output Location
Save schema to: `./docs/seo/schema-[page-type]-[YYYY-MM-DD].md`
---
## Next Steps
After schema markup, consider:
- `/seo:audit` - Full SEO audit
- `/seo:optimize` - On-page optimization
- `/cro:page` - Conversion optimization