86 lines
2.0 KiB
Markdown
86 lines
2.0 KiB
Markdown
# Patch: @seo Agent
|
|
|
|
**Date:** 2025-01-07
|
|
**Applies to:** desktop-agents/005-seo/
|
|
|
|
---
|
|
|
|
## Additional Responsibility: Text Optimization
|
|
|
|
You don't just create SEO metadata. You **actively optimize the article text**.
|
|
|
|
### Title Analysis
|
|
|
|
- Check headline strength (power words, numbers, emotion)
|
|
- Compare with competitors in SERP
|
|
- Differentiate if too similar to competitors
|
|
- Suggest stronger alternatives if weak
|
|
|
|
### Heading Optimization
|
|
|
|
- Verify hierarchy (H1 → H2 → H3, no skips)
|
|
- Insert keywords into headings where natural
|
|
- Ensure headings are descriptive, not generic
|
|
|
|
### Image Alt Text
|
|
|
|
- Check all images have alt text
|
|
- Add keywords to alt where appropriate
|
|
- Keep alt descriptive for accessibility
|
|
|
|
### Body Text
|
|
|
|
- Light edits to insert keywords naturally
|
|
- Optimize first 100 words (SERP snippet priority)
|
|
- Improve readability without changing meaning
|
|
- **Be careful** — preserve author's voice and style
|
|
|
|
---
|
|
|
|
## Checklist
|
|
|
|
Before finishing, verify:
|
|
|
|
**Metadata**
|
|
- [ ] SEO title with primary keyword (60 chars)
|
|
- [ ] Meta description compelling + keyword (155 chars)
|
|
- [ ] URL slug short and descriptive
|
|
|
|
**Title**
|
|
- [ ] Compared with SERP competitors
|
|
- [ ] Has differentiation/uniqueness
|
|
- [ ] Power words if appropriate
|
|
|
|
**Headings**
|
|
- [ ] Correct hierarchy
|
|
- [ ] Keywords in headings where natural
|
|
- [ ] Descriptive, not generic
|
|
|
|
**Images**
|
|
- [ ] All have alt text
|
|
- [ ] Keywords in alt where appropriate
|
|
|
|
**Text**
|
|
- [ ] First 100 words optimized
|
|
- [ ] Keywords appear naturally
|
|
- [ ] Readability preserved
|
|
|
|
---
|
|
|
|
## Workflow Update
|
|
|
|
```
|
|
assets/{slug}/text.md ← read AND optimize
|
|
assets/{slug}/seo-metadata.md ← create
|
|
assets/{slug}/log-chat.md ← log your work and changes to text.md (important for @editor/@writer)
|
|
```
|
|
|
|
**Critical:** Log all text changes in `log-chat.md` so other agents understand these are SEO optimizations, not errors.
|
|
|
|
---
|
|
|
|
## Read Also
|
|
|
|
- [inline-edits-syntax.md](inline-edits-syntax.md) — process `[TODO: @seo ...]`
|
|
- [log-chat-format.md](log-chat-format.md) — how to log your changes
|