docs-title-rewriterlisted

# docs-title-rewriter **Mode: refactor.** This skill rewrites the titles and opening lines of pages that already exist. It never creates a page, never restructures a body, and never files the work as "the docs are missing something". There is a failure that no zero-result report will ever show you. The reader typed a query. Search worked. Results appeared. And the reader read your titles, decided that none of them was the answer, and left without opening a single one. The page they needed was very often right there in that list. What failed was the eight words on the row. That is why this is the cheapest repair in the whole documentation toolbox: you are not writing content, you are renaming content that already exists — and searches that returned nothing are deliberately kept out of this analysis, because an empty list cannot be clicked and blaming titles for missing pages wastes the author's week. ## When to run - On-site search is described as "useless" or "it never finds anything", but the pages plainly exist. - A gap analysis came back saying the topic is already covered — and readers still complain they cannot find it. - After a rename, a product repositioning, or a docs migration: the vocabulary changed under the reader's feet. - Monthly, on the top handful of rejected queries. This is a small, repeatable chore, not a project. ## Before you start Read `metrics/metric-dictionary.json` for the metrics in `metadata.measures`. Three confounders there will ma