docs-rank-recoverylisted
Install: claude install-skill Docsbook-io/docs-skills
# docs-rank-recovery
Most SEO advice is about pages that do not rank. This is about the ones that
**already do** — the pages sitting at position 5 to 20, collecting impressions
and almost no clicks.
Those pages have already won the expensive part. Google has crawled them,
indexed them, judged them relevant enough to show, and is putting them in front
of real people who typed a real query. What is missing is the last, cheap step:
looking like the answer in a result list. Moving one page from position 9 to
position 4 is a title and an opening paragraph. Getting a brand-new page to
position 9 is months.
**Mode: refactor.** This skill rewrites pages that exist, preserving their
meaning and their URL. It does not create new pages — when the honest verdict is
"this page is not about that query", the output is a note for whoever plans new
content, not a new page written here. It also never invents a position it did
not read.
## When to run
- Monthly, as the standing search review — this set changes slowly and rewards
patience more than frequency.
- After a docs restructure, to find pages whose ranking survived a URL or title
change but whose click-through did not.
- When someone says "traffic is flat but we keep publishing" — the answer is
usually sitting in this set, not in the next new page.
- **Not** as a general SEO audit. If nobody has ever checked titles, headings,
structured data or alt text on these docs, run the broad audit first (see
Related skills) and come