illyism/seo-skills/seo-title-optimization
Claude Code and agent skill by illyism/seo-skills
- community
Checking that the SKILL.md file is still in the repository.
Rewrite and audit SEO page titles, title tags, MDX frontmatter titles, H1 alignment, and bulk title improvements. Use when the user mentions titles, title tags, SERP titles, metadata titles, SEO titles, CTR, truncation, or asks to improve titles across pages.
Install
npx vskill@latest install illyism/seo-skills/seo-title-optimizationSKILL.md
SEO Title Optimization
Use this skill to improve page titles for search rankings and click-through rate.
Core Rule
Treat the SERP as the brief.
Do not write titles from vibes. Identify the target query, study what already ranks when possible, then write the clearest title that matches the page and search intent.
Title Formula
Start with:
Examples:
Client Portal Software for AccountantsBest AI Presentation Makers in 2026SEO Title Generator: Write Better Titles in 2026Emergency Plumber Dublin - 24/7 Same-Day Service
Checklist
For each title:
- Put the primary query near the front.
- Align
title, meta description, H1, and URL slug around the same topic. - Match the page type: pricing, support, docs, login, product, comparison, review, guide, pillar, definition, how-to, or listicle.
- Keep the important words visible before truncation.
- Use 40-55 characters as the ideal range when possible.
- Prefer human clarity over keyword stuffing.
- Make every title unique.
- Mirror SERP patterns when useful:
best,top, numbers, year, comparison terms. - Avoid useless titles like
Home,About,Products, or vague category labels. - Avoid changing slugs just to match temporary numbers or years.
Blog Post Title Patterns
Use Semrush-style post templates to match the title to search intent:
- Beginner guide: use for beginners or new concepts. Pattern:
Beginner's Guide to [Topic]or[Topic]: What It Is & How to Use It. - Pillar post: use for broad evergreen topics. Pattern:
The Complete Guide to [Topic],How to [X] (Basics, Tips & Resources), orEverything You Need to Know About [Topic]. - Definition post: use for "what is" intent. Pattern:
What Is [Term]?orWhat Is [Term] & How to [Use It]. - How-to post: use for task intent. Pattern:
How to [Task],How to [Task] Without [Obstacle], orHow to [Task] Like an Expert. - Listicle: use for rankings, curated tools, or summarized tips. Pattern:
10 [Things] to [Benefit]or[Number] Best [Tools/Ideas] for [Audience] in [Year]. - Checklist: use for task lists. Pattern:
[Topic] Checklist: [Number] Tips to [Outcome]. - Comparison: use for vs intent. Pattern:
[A] vs [B]: [Decision/Outcome]. - Error/problem: use for troubleshooting intent. Pattern:
What Does [Error] Mean?orHow to Fix [Problem].
Pick one template per page. Do not mix title formats unless the SERP clearly does.
Useful modifiers: Best, Top, Complete, Beginner's Guide, Examples, Template, Free, 2026, Essential.
Avoid hype-heavy modifiers unless the SERP supports them: Shocking, Unbelievable, Jaw-dropping, Guaranteed.
Workflow
- Identify the primary keyword or infer it from the page, slug, H1, and content.
- Determine search intent: informational, commercial, transactional, local, comparison, pricing, support, docs, login, beginner guide, pillar, definition, how-to, or listicle.
- If SERP/title data is available, compare top-ranking titles for repeated structures, modifiers, length, and wording.
- Choose the post/page title pattern that best matches the intent.
- Draft 3-5 title options.
- Pick the title that is accurate, concise, and most likely to earn the click.
- If editing files, update frontmatter
titleand only adjust H1/meta/slug when the user asked or the mismatch is clearly harmful. - For bulk work, return a before/after table and explain the pattern used.
Common Fixes
Too vague
Becomes:
Too bloated
Becomes:
Wrong page intent
Becomes:
Bulk Rewrite Output
When auditing multiple pages, use this format:
Keep explanations short. The output should help the user approve or edit quickly.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingseo/seo-title-optimization/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/illyism/seo-skills/seo-title-optimization)