2.0 KiB

Raw Blame History

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.

2.0 KiB Raw Blame History