seo-title-optimization — Claude Code skill for SEO titles
The seo-title-optimization Claude Code skill audits and rewrites SEO page titles. It activates for requests about title tags, SERP titles, CTR, truncation, or title changes across pages.
no license 910 installs ★ 1,797 updated 2026-11-16
npx skills add Illyism/seo-skills --skill seo-title-optimization -a claude-codeWhat seo-title-optimization does
The skill revises page titles against a target query and the page’s search intent. It checks whether the title, meta description, H1, and URL slug address the same topic. For bulk edits, it returns a table with current and proposed titles plus a short reason for each change.
It starts by identifying the query and page type. When search-result data is available, the skill compares ranking titles before drafting options and selecting one. Its suggested target is 40–55 characters where practical. Search-result data is only used for comparison when available.
What it helps with
- replace a vague page title with one that reflects its target query
- align a page title with its meta description and H1
- check whether key words may be cut off in search results
- revise titles across several pages in a before-and-after table
Example prompts for the agent
- Review this page’s SEO title and suggest clearer alternatives.
- Check whether this page’s
title, meta description, and H1 match. - Rewrite the titles in this page list and return a before-and-after table.
How to install seo-title-optimization
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill seo-title-optimization -a claude-code2Manually: put the files in place
~/.claude/skills/seo-title-optimization/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-title-optimization/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill seo-title-optimization -a codex2Manually: put the files in place
.agents/skills/seo-title-optimization/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill seo-title-optimization -a cursor2Manually: put the files in place
.cursor/skills/seo-title-optimization/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Illyism/seo-skills seo/seo-title-optimization/SKILL.md2Manually: put the files in place
.github/skills/seo-title-optimization/SKILL.md1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill seo-title-optimization -a gemini-cli2Platform CLI
gemini skills install https://github.com/Illyism/seo-skills --path seo/seo-title-optimizationManually: put the files in place
.devin/skills/seo-title-optimization/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill seo-title-optimization -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about seo-title-optimization
How do I install seo-title-optimization in Claude Code?
Run npx skills add Illyism/seo-skills --skill seo-title-optimization -a claude-code. The skill file is at ~/.claude/skills/seo-title-optimization/SKILL.md.
What does seo-title-optimization do?
It audits and rewrites SEO page titles using the target query and page intent. It also checks alignment with the meta description and H1, and can return bulk edits in a comparison table.
What does the skill return for bulk title edits?
It produces a table with each page’s current title, a proposed replacement, and a brief explanation.