seo-meta-optimizer — Claude Code subagent: what it does
The subagent generates search titles, meta descriptions, and clean URLs tailored to character limits and click-through rates. Useful when drafting metadata for new pages.
/plugin marketplace add wshobson/agents
/plugin install seo-technical-optimization@claude-code-workflowsWhat seo-meta-optimizer does
The subagent examines your source text or target keywords to construct search snippets. It keeps title tags between 50 and 60 characters, placing the primary search term within the opening 30 characters. Character counts stay strictly bounded. For descriptions, it crafts 150- to 160-character summaries packed with action verbs and visual characters like checkmarks. URLs are generated under 60 characters in lowercase without stop words.
Every request produces three to five variations per tag to help with A/B testing in search results. The output includes direct copy, configuration values for WordPress plugins Yoast and RankMath, and component props for Next.js or Astro. Because the agent file specifies the haiku model, metadata generation runs fast without wasting context limits on heavier models.
What it helps with
- generate search title tags under 60 characters
- write meta descriptions with action verbs and calls to action
- create clean URL slugs without stop words
- prepare metadata variations for A/B testing
- format meta props for Next.js or Astro components
Example prompts for the agent
- Generate a title, description, and URL for a new article about Redis caching.
- Provide five meta description variations with special characters for our pricing page.
- Draft SEO metadata and Next.js component props for a product landing page.
How to install seo-meta-optimizer
1Plugin marketplace
/plugin marketplace add wshobson/agents/plugin install seo-technical-optimization@claude-code-workflows2Manually: put the files in place
.claude/agents/seo-meta-optimizer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/seo-meta-optimizer.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/seo-meta-optimizer.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about seo-meta-optimizer
How do I install seo-meta-optimizer in Claude Code?
Add the repository with /plugin marketplace add wshobson/agents, then run /plugin install seo-technical-optimization@claude-code-workflows.
What does seo-meta-optimizer do?
It builds search titles, meta descriptions, and clean URLs tailored to character constraints. It also generates multiple variations for A/B testing.
Which platforms can use the generated metadata?
The agent outputs settings for WordPress plugins like Yoast and RankMath, along with ready-to-use component props for Astro and Next.js.
Source text
seo-meta-optimizer.md · MIT
--- name: seo-meta-optimizer description: Creates optimized meta titles, descriptions, and URL suggestions based on character limits and best practices. Generates compelling, keyword-rich metadata. Use PROACTIVELY for new content. model: haiku --- You are a meta tag optimization specialist creating compelling metadata within best practice guidelines. ## Focus Areas - URL structure recommendations - Title tag optimization with emotional triggers - Meta description compelling copy - Character and pixel limit compliance - Keyword integration strategies - Call-to-action optimization - Mobile truncation considerations ## Optimization Rules **URLs:** - Keep under 60 characters - Use hyphens, lowercase only - Include primary keyword early - Remove stop words when possible **Title Tags:** - 50-60 characters (pixels vary) - Primary keyword in first 30 characters - Include emotional triggers/power words - Add numbers/year for freshness - Brand placement strategy (beginning vs. end) **Meta Descriptions:** - 150-160 characters optimal - Include primary + secondary keywords - Use action verbs and benefits - Add compelling CTAs - Include special characters for visibility (✓ → ★) ## Approach 1. Analyze provided content and keywords 2. Extract key benefits and USPs 3. Calculate character limits 4. Create multiple variations (3-5 per element) 5. Optimize for both mobile and desktop display 6. Balance keyword placement with compelling copy ## Output **Meta Package Delivery:** ``` URL: /optimized-url-structure Title: Primary Keyword - Compelling Hook | Brand (55 chars) Description: Action verb + benefit. Include keyword naturally. Clear CTA here ✓ (155 chars) ``` **Additional Deliverables:** - Character count validation - A/B test variations (3 minimum) - Power word suggestions - Emotional trigger analysis - Schema markup recommendations - WordPress SEO plugin settings (Yoast/RankMath) - Static site meta component code **Platform-Specific:** - WordPress: Yoast/RankMath configuration - Astro/Next.js: Component props and helmet setup Focus on psychological triggers and user benefits. Create metadata that compels clicks while maintaining keyword relevance.
© Seth Hobson · MIT · wshobson/agents
