SkillAgentSearch skills...

seo-title-optimization

Rewrite and audit SEO page titles, title tags, MDX frontmatter titles, H1 alignment, and bulk title improvements

Install / Use

npx skills add Illyism/seo-skills --skill seo-title-optimization

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

84/100

Category

Marketing

Supported Platforms

Universal

Tags

Our assessment of seo-title-optimization

seo-title-optimization scores 84/100 on our quality scale, 454th of 573 Marketing skills we index.

Its SKILL.md is 4.7 KB long, well organised into 8 sections with 8 code examples: a solid amount of guidance for an agent.

It has 531 GitHub stars, a meaningful sign that others use it.

Substance
26/30
Structure
20/20
Description
12/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 13 days ago, so seo-title-optimization is actively maintained.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

seo-title-optimization compared with similar skills

All 4 of these similar skills score higher than seo-title-optimization; compare them before choosing.

SkillScoreStarsUpdatedFormat
seo-title-optimization (this skill)by Illyism8453113d agoSKILL.md
algorithmic-artby anthropics100177.9k36d agoSKILL.md
pptxby anthropics100177.9k36d agoSKILL.md
designby nextlevelbuilder100137.2k13d agoSKILL.md
ui-ux-pro-maxby nextlevelbuilder100137.2k13d agoSKILL.md

Frequently asked questions

How do I install seo-title-optimization?
Run npx skills add Illyism/seo-skills --skill seo-title-optimization. The install tabs above show the steps for each supported agent.
Which AI agents does seo-title-optimization work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is seo-title-optimization safe to use?
It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is seo-title-optimization still maintained?
The repository was last updated 13 days ago, so seo-title-optimization is actively maintained.

name: seo-title-optimization description: 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. metadata: version: 1.0.0 author: illyism source: https://il.ly/skills/seo-title-optimization

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:

Primary keyword + modifier / benefit + brand

Examples:

  • Client Portal Software for Accountants
  • Best AI Presentation Makers in 2026
  • SEO Title Generator: Write Better Titles in 2026
  • Emergency 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), or Everything You Need to Know About [Topic].
  • Definition post: use for "what is" intent. Pattern: What Is [Term]? or What Is [Term] & How to [Use It].
  • How-to post: use for task intent. Pattern: How to [Task], How to [Task] Without [Obstacle], or How 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? or How 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

  1. Identify the primary keyword or infer it from the page, slug, H1, and content.
  2. Determine search intent: informational, commercial, transactional, local, comparison, pricing, support, docs, login, beginner guide, pillar, definition, how-to, or listicle.
  3. If SERP/title data is available, compare top-ranking titles for repeated structures, modifiers, length, and wording.
  4. Choose the post/page title pattern that best matches the intent.
  5. Draft 3-5 title options.
  6. Pick the title that is accurate, concise, and most likely to earn the click.
  7. If editing files, update frontmatter title and only adjust H1/meta/slug when the user asked or the mismatch is clearly harmful.
  8. For bulk work, return a before/after table and explain the pattern used.

Common Fixes

Too vague

Home

Becomes:

AI Customer Support Chatbot for SaaS Teams

Too bloated

The Ultimate Complete Guide to the Many Benefits of Digital Signage for Businesses

Becomes:

8 Digital Signage Benefits for Businesses

Wrong page intent

Plans for Growing Teams

Becomes:

Client Portal Pricing

Bulk Rewrite Output

When auditing multiple pages, use this format:

| Page       | Current title | Suggested title                          | Why                                 |
| ---------- | ------------- | ---------------------------------------- | ----------------------------------- |
| `/example` | `Home`        | `Client Portal Software for Accountants` | Adds main query and product clarity |

Keep explanations short. The output should help the user approve or edit quickly.

Related Skills

View on GitHub
GitHub Stars531
CategoryMarketing
Updated13d ago
Forks56

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium