Skills/Rank a pagev2.1.0

Move one page up for one search, with your agent

Runs a campaign to move one page up for one search toward an aim, through five gates in order, each opened only by a proof from a read of the live site, with a weekly read-out and the campaign’s time to rank.

Add it, from the top of the site’s repositorynpx skills add subinternal/clickd --skill clickd-rank-a-page
Then ask your agentRank our /hiking-boots page for “waterproof hiking boots”, aiming for top 3, and keep a weekly read-out.

For a site’s owner or developer with one page that should rank higher

The read-out you get each week

One page, one search, one aim. The same short read-out every week, even when nothing moved: the place Google gave beside what was done and what was proved, never one credited to the other.

/hiking-boots for “waterproof hiking boots”

Week 6, November 23. Aim: top 3.

Illustration

14.22.8average place, from Search Console

At the aim for the first time, on 342 impressions. Status: Climbing. Time to rank: 36 days, held once next week’s read-out finds it there again.

  1. 14.2
    Start
  2. 9.0
    Week 2
  3. 11.6
    Week 3
  4. 2.8
    Week 6
Done5. Links from outside, planned: six sites to ask, with a draft note each.
Next5. Links from outside, the notes.
Gates1 to 4 open, latest proof clickd’s read on November 16. Nothing slipped.
Needs youSend the notes, or say who should.

Five gates, in order

Work on a gate past one that is closed is wasted. Each opens only when a read of the live site proves it, or you do. Never the agent that did the work.

  1. 1Clean up

    Opens when the read finds no access fault, broken link or copy touching the page.

  2. 2One intent

    Opens when the title and first heading carry the search, and the page earns no search of another kind.

  3. 3Substance

    Opens when it passes the content rules and covers what the pages above it cover.

  4. 4Links inside

    Opens when three of the site’s ten most linked pages link to it from their text.

  5. 5Links from outside

    Opens when as many sites link to it as to the middle rival above it.

One status at a time

Written as the word in every read-out. Your clickd is your mean time to rank, said with how many campaigns reached their aim of how many were run.

  • Setting upThe page, search, aim or start not written down
  • ClimbingA gate opened in the last three weeks
  • StalledThree weeks with no gate opened, short of the aim
  • HoldingAt the aim two read-outs in a row
  • EndedYou ended it, or it held eight weeks

What it never does

  • Promise a place or a dateGoogle decides both.6
  • Say a gate moved the placeTime to rank measures how long it took. It never credits.
  • Change the aim without youAnd a campaign that missed its aim stays in your count.
  • Buy or swap linksGoogle’s spam policies forbid it, and a page caught at it falls.

When to reach for it

Reach for it when

  • A page that matters ranks on page two, or nowhere, for the search it is for.
  • You want an agent to work a page up gate by gate, and a read-out of what it did each week.
  • You want each gate proved on the live site, not ticked off by the one who did it, and the days to the aim counted honestly.

Leave it when

  • You want links bought or swapped: the skill refuses, as Google’s spam policies do.4
  • The whole site needs work first: the page system skill covers every page.

Install it by hand

The line at the top adds it for any agent. Or fetch its 9 files where your agent looks. Your agent also needs clickd connected over MCP: connecting an agent shows how.

Loads skills from .claude/skills/ in the repository, for everyone who works in it, or ~/.claude/skills/ for every project on your machine. Claude uses it when a request matches its description, or type /clickd-rank-a-page.

Terminal, for Claude Code
mkdir -p .claude/skills/clickd-rank-a-page/references
curl -fsSL https://clickd.com/skills/rank-a-page/SKILL.md -o .claude/skills/clickd-rank-a-page/SKILL.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/tracking.md -o .claude/skills/clickd-rank-a-page/references/tracking.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/report.md -o .claude/skills/clickd-rank-a-page/references/report.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/choosing-the-search.md -o .claude/skills/clickd-rank-a-page/references/choosing-the-search.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/the-page.md -o .claude/skills/clickd-rank-a-page/references/the-page.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/links-inside.md -o .claude/skills/clickd-rank-a-page/references/links-inside.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/search-console.md -o .claude/skills/clickd-rank-a-page/references/search-console.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/timelines-and-stopping.md -o .claude/skills/clickd-rank-a-page/references/timelines-and-stopping.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/troubleshooting.md -o .claude/skills/clickd-rank-a-page/references/troubleshooting.md
PowerShell, for Claude Code
New-Item -ItemType Directory -Force .claude\skills\clickd-rank-a-page\references | Out-Null
Invoke-WebRequest https://clickd.com/skills/rank-a-page/SKILL.md -OutFile .claude\skills\clickd-rank-a-page\SKILL.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/tracking.md -OutFile .claude\skills\clickd-rank-a-page\references\tracking.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/report.md -OutFile .claude\skills\clickd-rank-a-page\references\report.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/choosing-the-search.md -OutFile .claude\skills\clickd-rank-a-page\references\choosing-the-search.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/the-page.md -OutFile .claude\skills\clickd-rank-a-page\references\the-page.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/links-inside.md -OutFile .claude\skills\clickd-rank-a-page\references\links-inside.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/search-console.md -OutFile .claude\skills\clickd-rank-a-page\references\search-console.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/timelines-and-stopping.md -OutFile .claude\skills\clickd-rank-a-page\references\timelines-and-stopping.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/troubleshooting.md -OutFile .claude\skills\clickd-rank-a-page\references\troubleshooting.md -UseBasicParsing

Puts the files in .claude/skills/clickd-rank-a-page/.

Loads skills from .agents/skills/ in the repository and its parent folders, or ~/.agents/skills/ for every project. Codex uses it when a task matches its description, or mention it as $clickd-rank-a-page; /skills lists them.

Terminal, for Codex
mkdir -p .agents/skills/clickd-rank-a-page/references
curl -fsSL https://clickd.com/skills/rank-a-page/SKILL.md -o .agents/skills/clickd-rank-a-page/SKILL.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/tracking.md -o .agents/skills/clickd-rank-a-page/references/tracking.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/report.md -o .agents/skills/clickd-rank-a-page/references/report.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/choosing-the-search.md -o .agents/skills/clickd-rank-a-page/references/choosing-the-search.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/the-page.md -o .agents/skills/clickd-rank-a-page/references/the-page.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/links-inside.md -o .agents/skills/clickd-rank-a-page/references/links-inside.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/search-console.md -o .agents/skills/clickd-rank-a-page/references/search-console.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/timelines-and-stopping.md -o .agents/skills/clickd-rank-a-page/references/timelines-and-stopping.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/troubleshooting.md -o .agents/skills/clickd-rank-a-page/references/troubleshooting.md
PowerShell, for Codex
New-Item -ItemType Directory -Force .agents\skills\clickd-rank-a-page\references | Out-Null
Invoke-WebRequest https://clickd.com/skills/rank-a-page/SKILL.md -OutFile .agents\skills\clickd-rank-a-page\SKILL.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/tracking.md -OutFile .agents\skills\clickd-rank-a-page\references\tracking.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/report.md -OutFile .agents\skills\clickd-rank-a-page\references\report.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/choosing-the-search.md -OutFile .agents\skills\clickd-rank-a-page\references\choosing-the-search.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/the-page.md -OutFile .agents\skills\clickd-rank-a-page\references\the-page.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/links-inside.md -OutFile .agents\skills\clickd-rank-a-page\references\links-inside.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/search-console.md -OutFile .agents\skills\clickd-rank-a-page\references\search-console.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/timelines-and-stopping.md -OutFile .agents\skills\clickd-rank-a-page\references\timelines-and-stopping.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/troubleshooting.md -OutFile .agents\skills\clickd-rank-a-page\references\troubleshooting.md -UseBasicParsing

Puts the files in .agents/skills/clickd-rank-a-page/.

Loads skills from .cursor/skills/ or .agents/skills/ in the repository, or ~/.cursor/skills/ for every project. It also reads .claude/skills/, so one copy there serves both. The agent uses it when it is relevant, or type / in Agent chat and pick it.

Terminal, for Cursor
mkdir -p .cursor/skills/clickd-rank-a-page/references
curl -fsSL https://clickd.com/skills/rank-a-page/SKILL.md -o .cursor/skills/clickd-rank-a-page/SKILL.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/tracking.md -o .cursor/skills/clickd-rank-a-page/references/tracking.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/report.md -o .cursor/skills/clickd-rank-a-page/references/report.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/choosing-the-search.md -o .cursor/skills/clickd-rank-a-page/references/choosing-the-search.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/the-page.md -o .cursor/skills/clickd-rank-a-page/references/the-page.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/links-inside.md -o .cursor/skills/clickd-rank-a-page/references/links-inside.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/search-console.md -o .cursor/skills/clickd-rank-a-page/references/search-console.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/timelines-and-stopping.md -o .cursor/skills/clickd-rank-a-page/references/timelines-and-stopping.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/troubleshooting.md -o .cursor/skills/clickd-rank-a-page/references/troubleshooting.md
PowerShell, for Cursor
New-Item -ItemType Directory -Force .cursor\skills\clickd-rank-a-page\references | Out-Null
Invoke-WebRequest https://clickd.com/skills/rank-a-page/SKILL.md -OutFile .cursor\skills\clickd-rank-a-page\SKILL.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/tracking.md -OutFile .cursor\skills\clickd-rank-a-page\references\tracking.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/report.md -OutFile .cursor\skills\clickd-rank-a-page\references\report.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/choosing-the-search.md -OutFile .cursor\skills\clickd-rank-a-page\references\choosing-the-search.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/the-page.md -OutFile .cursor\skills\clickd-rank-a-page\references\the-page.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/links-inside.md -OutFile .cursor\skills\clickd-rank-a-page\references\links-inside.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/search-console.md -OutFile .cursor\skills\clickd-rank-a-page\references\search-console.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/timelines-and-stopping.md -OutFile .cursor\skills\clickd-rank-a-page\references\timelines-and-stopping.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/troubleshooting.md -OutFile .cursor\skills\clickd-rank-a-page\references\troubleshooting.md -UseBasicParsing

Puts the files in .cursor/skills/clickd-rank-a-page/.

An agent that does not load skills can still follow the file. Save the folder in the repository and point its standing instructions at it, with a line in AGENTS.md, which many agents read. The agent reads AGENTS.md when it starts, and follows the file when the task matches.

Terminal, for Any other agent
mkdir -p docs/clickd-rank-a-page/references
curl -fsSL https://clickd.com/skills/rank-a-page/SKILL.md -o docs/clickd-rank-a-page/SKILL.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/tracking.md -o docs/clickd-rank-a-page/references/tracking.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/report.md -o docs/clickd-rank-a-page/references/report.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/choosing-the-search.md -o docs/clickd-rank-a-page/references/choosing-the-search.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/the-page.md -o docs/clickd-rank-a-page/references/the-page.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/links-inside.md -o docs/clickd-rank-a-page/references/links-inside.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/search-console.md -o docs/clickd-rank-a-page/references/search-console.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/timelines-and-stopping.md -o docs/clickd-rank-a-page/references/timelines-and-stopping.md
curl -fsSL https://clickd.com/skills/rank-a-page/references/troubleshooting.md -o docs/clickd-rank-a-page/references/troubleshooting.md
echo "For moving one page up for one search, follow docs/clickd-rank-a-page/SKILL.md." >> AGENTS.md
PowerShell, for Any other agent
New-Item -ItemType Directory -Force docs\clickd-rank-a-page\references | Out-Null
Invoke-WebRequest https://clickd.com/skills/rank-a-page/SKILL.md -OutFile docs\clickd-rank-a-page\SKILL.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/tracking.md -OutFile docs\clickd-rank-a-page\references\tracking.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/report.md -OutFile docs\clickd-rank-a-page\references\report.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/choosing-the-search.md -OutFile docs\clickd-rank-a-page\references\choosing-the-search.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/the-page.md -OutFile docs\clickd-rank-a-page\references\the-page.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/links-inside.md -OutFile docs\clickd-rank-a-page\references\links-inside.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/search-console.md -OutFile docs\clickd-rank-a-page\references\search-console.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/timelines-and-stopping.md -OutFile docs\clickd-rank-a-page\references\timelines-and-stopping.md -UseBasicParsing
Invoke-WebRequest https://clickd.com/skills/rank-a-page/references/troubleshooting.md -OutFile docs\clickd-rank-a-page\references\troubleshooting.md -UseBasicParsing
Add-Content AGENTS.md "For moving one page up for one search, follow docs/clickd-rank-a-page/SKILL.md."

Puts the files in docs/clickd-rank-a-page/.

What is inside

SKILL.md stays short and sends your agent to a reference when a step needs it.

  • SKILL.mdThe words it uses, setting up a campaign and its aim, the five gates with what to look at, how to decide, what to change and what opens each, reaching the aim, the rules it keeps, and a worked example.167 lines
  • references/tracking.mdThe campaign log, with clickd’s work log or as campaign.md without it, what a gate’s states and a campaign’s status mean, and keeping a person’s clickd, with a worked log eight weeks in.106 lines
  • references/report.mdThe weekly read-out: the place against the aim and the start, the status, what was done and proved, what is next, what needs the person, and the days so far, with worked weeks: a slip, the aim reached, a stall and the end.93 lines
  • references/choosing-the-search.mdWhere candidate searches come from, reading the intent from the live results, checking another page of the site is not the better one, and setting an aim the evidence supports.63 lines
  • references/the-page.mdThe brief to write first, a worked before and after of the title, first heading and opening, answers under the reader’s questions, the rules that bear on them, and the traps that trip agents.93 lines
  • references/links-inside.mdFinding the site’s pages that should link here, a worked link in a sentence, the traps, and checking the links in the HTML the server sends.54 lines
  • references/search-console.mdReading the Performance report for one page and one search, with clickd or by hand, what average position means, honest weekly figures with their impressions, URL Inspection, and troubleshooting the figures.64 lines
  • references/timelines-and-stopping.mdWhat Google says about timing, what to tell the person, the campaign’s own pacing, and when to raise ending or changing target, which is always a new campaign.53 lines
  • references/troubleshooting.mdSymptoms in gates and reads, the place, and the work, each with its likely cause and the fix.34 lines

Version 2.1.0, October 31, 2026ChangesSKILL.md in fullSourcesAs data, in skills.json

Sources

17 pages

Each is in a ## Sources list in the file that cites it, by the page’s own title.

Google Search Central

  1. 1Influencing your title links in search results, Google Search Central. How the title at gate two is shown.
  2. 2Creating helpful, reliable, people-first content, Google Search Central. What substance means at gate three.
  3. 3Link best practices for Google, Google Search Central. Link text at gate four.
  4. 4Spam policies for Google web search, Google Search Central. Why links are earned, never bought or swapped, at gate five.
  5. 5How to specify a canonical URL with rel="canonical" and other methods, Google Search Central. One address for the page at gate one.
  6. 6Performance report (Search results): Overview and basic setup, Search Console Help. Where the page's place, and so its time to rank, comes from without clickd; results differ by person, newest data is preliminary, and the chart and table count differently.
  7. 7Performance report (Search results): Advanced filtering and comparison, Search Console Help. Filtering to one page and comparing two windows, and why filtered totals leave out anonymized queries.
  8. 8What are impressions, position, and clicks?, Search Console Help. Position as the topmost place held, averaged, and recorded only when the page was shown.
  9. 9URL Inspection tool, Search Console Help. Whether the page is on Google, and the declared canonical against the one Google selected, at gate one.
  10. 10Ask Google to recrawl your URLs, Google Search Central. Asking for a crawl after a change, and that it takes days to weeks.
  11. 11SEO Starter Guide: The Basics, Google Search Central. That changes take hours to months to show, to wait a few weeks before judging, and that there is no preferred word count.
  12. 12Debugging drops in Google Search traffic, Google Search Central. That small moves in position happen at any time, and that no change is sure to have an effect.
  13. 13Do you need an SEO?, Google Search Central. That no one can guarantee a first place, so the campaign never promises one.

Agent skills format and clients

  1. 14Extend Claude with skills, Anthropic, Claude Code docs. Where Claude Code loads skills from, and how one is called.
  2. 15Build skills, OpenAI, ChatGPT Learn. Where Codex loads skills from, and how one is called.
  3. 16Agent Skills, Cursor docs. Where Cursor loads skills from, and how one is called.
  4. 17Specification, Agent Skills. The format every skill here keeps: the folder, the frontmatter and its limits.