content-brief
Skill2 starsChanged yesterdayMITView on GitHub
Write a ranking content brief for one target keyword or page: confirm intent from the live SERP, read the top results and list every question they answer (plus People Also Ask), define what the page must add that page one lacks (own data, worked example, decision rule), set the primary and secondary keywords with volume and difficulty, outline headings, internal links, schema and the title/meta, and set a length target from the competing pages. Use when the user is writing a new article or landing page, refreshing a page that slipped, asks what a page should include to rank, or wants an SEO content outline or a brief for a writer.
21 other projects use a version of this.
Adopted by
Most recently taken up by
- harborrank/harborrank-skillsword for word, first seen Nov 16, 2026
- sitetiller/ai-visibility-skillstheir own version, first seen Nov 15, 2026
- agiea-brain/agency-skillstheir own version, first seen Nov 8, 2026
- akii-technologies-ltd/akii-seo-ai-search-optimizertheir own version, first seen Nov 1, 2026
- Ryze-AI-Adgent/open-seo-mcp-skillstheir own version, first seen Oct 27, 2026
- tidycatc132/claude-skillstheir own version, first seen Oct 25, 2026
Used with
Projects with it also use competitor-gap, serp-analysis and 3 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
DarynaRodriguezSkillcompetitor-gap
Finds the terms rivals rank for and the site does not, confirms who the real organic competitors are, and returns a gap table split into terms to win, terms underperforming, and terms to concede.
Also in 4 projects that use this
opencueSkillserp-analysis
Use when the user asks to "analyze SERPs"; reviews ranking factors, features, intent, AI Overviews, and snippets. SERP分析/搜索结果
Also in 3 projects that use this
indranilbanerjeeSkillclient-proposal
Draft a client proposal or RFP response: scope, deliverables, KPIs, pricing tiers. \"respond to this RFP\"
Also in 3 projects that use this
akii-technologies-ltdSkillinternal-linking
Analyze and improve internal linking strategy. Use when the user asks about "internal links", "link structure", "site architecture", "link strategy", "orphan pages", "link equity", "page authority distribution", "anchor text", "topical clusters", "siloing", or wants to improve how pages connect.
Also in 3 projects that use this
sharozdawaSkillai-visibility
Track and analyze brand visibility across AI platforms (ChatGPT, Perplexity, Claude, Gemini). Check mention rates, sentiment, competitors, and get improvement recommendations.
Also in 3 projects that use this
Other versions21 projects use a version of this.
Word for word · 1
- harborrank/harborrank-skills★ 2100% same
Edited · 0
None found.
Wrote their own version · 20
- Ryze-AI-Adgent/open-seo-mcp-skills★ 8.4ksame name
- indranilbanerjee/digital-marketing-pro★ 934same name
- langchain-ai/design-agent★ 619same name
- akii-technologies-ltd/akii-seo-ai-search-optimizer★ 80same name
- semrush/skills★ 13same name
- calven-ai/marketing-as-code★ 10same name
- searchfit/searchfit-seo★ 9same name
- agiea-brain/agency-skills★ 1same name
- busyeugene/content-marketing-skills★ 1same name
- DarynaRodriguez/seo-skills★ 1same name
10 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository17 other files it gives its agents.
- ai-search-visibilitySkill
- client-seo-reportSkill
- competitive-landscapeSkill
- competitor-analysisSkill
- google-business-profileSkill
- keyword-cannibalizationSkill
- keyword-clusteringSkill
- keyword-researchSkill
- lead-teardownSkill
- link-prospectingSkill
- local-seoSkill
- schema-markupSkill
- seo-auditSkill
- seo-coachSkill
- seo-contextSkill
- seo-project-setupSkill
- seo-proposalSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
21 rules. 0 are common, 10 are distinctive, and 11 are very specific to this project.
0
Common
Most of the 18 edited versions we read keep these.
10
Distinctive
This author's own choices. Worth a look.
11
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 16
If neither tool is available, or whoami fails because the user is not signed in, tell the user plainly: "HarborRank isn't connected, so I …
- Distinctive: line 27
Do not stop there. Continue in fallback mode (below).
- Very specific: line 33
If creditsRemaining will not cover the planned calls, give the user the estimate and ask before spending.
- Very specific: line 35
If a tool fails for insufficient credits, stop making paid calls, tell the user, and finish with free tools and the data you already have.
- Very specific: line 37
If the user asks to upgrade, change plan or buy credits, call get_upgrade_link (no credits) and give them the link.
- Very specific: line 38
When whoami returns mode: "self-hosted", there are no plan gates.
- Distinctive: line 42
Use this mode only when Step 0 finds no connection.
- Distinctive: line 46
Search the target keyword on the web, judge intent from the pages that appear, and read those pages in full.
- Distinctive: line 49
Use Search Console CSV exports in the workspace for a refresh: the page's queries, clicks and positions are the user's own data.
- Distinctive: line 57
Start with the label Web-evidence only: no HarborRank data.
- Very specific: line 67
If projectId is missing, use list_projects first.
- Very specific: line 86
If the project's SEO folder has seo-context.md, read it first for the site, market, audience, competitors and goals.
- Very specific: line 95
Add internal links: 3 to 6 existing pages this page should link to and 2 to 4 that should link to it, with anchor text.
- Distinctive: line 98
Write the brief's guidance in plain, direct sentences.
- Very specific: line 99
Ask before saving the keywords with save_keywords and a page:<slug> tag.
- Distinctive: line 106
Verdict: write it, refresh it, or pick another keyword, and why.
- Distinctive: line 127
Start from the SERP, never a stock outline.
- Very specific: line 129
Do not invent metrics, word counts or URLs.
- Distinctive: line 130
Do not promise rankings or traffic.
- Distinctive: line 131
Do not pad. A short page that answers the query beats a long one that does not.
- Very specific: line 132
Do not call save_keywords without explicit confirmation.
“Common” is measured: kept by at least 6 in 10 of the 18 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
HarborRank Content Brief
Goal
Produce one brief, for one target keyword or page, that a writer can follow to publish a page that deserves a page-one spot. The brief starts from the live SERP, not a template, and it says plainly what the page adds that the current page one lacks. This is the deep version of one brief from keyword-clustering, which maps keywords to pages first.
Step 0: Check connection
Before any other step, confirm the HarborRank MCP tools are loaded. Look for get_domain_overview or list_leads among your tools, including deferred tools you can load (the name may carry a prefix such as mcp__harborrank__). If they are there, call whoami: it uses no credits, confirms the user is signed in, and returns creditsRemaining for budgeting the run. Do not call a research tool to test the connection.
If neither tool is available, or whoami fails because the user is not signed in, tell the user plainly: "HarborRank isn't connected, so I can't pull live HarborRank data yet." Then tell them how to connect it:
- Claude Code with the HarborRank plugin: run
/mcp, chooseharborrank, and sign in. - Claude Code without the plugin: run
claude mcp add --transport http --scope user harborrank https://app.harborrank.com/mcp, then/mcpto sign in. - Claude on the web, desktop or Cowork: open Customize, then Connectors, search for HarborRank, choose Connect, and sign in. New accounts start with a 7-day free trial.
- Cursor with the HarborRank plugin: open Cursor Settings, then MCP, and sign in to
harborrank. - Gemini CLI with the HarborRank extension: run
/mcp auth harborrank. - Other clients: add
https://app.harborrank.com/mcpas a remote MCP server. Setup for each client is at https://harborrank.com/docs/mcp.
Tell them what happens when they connect: they sign in to HarborRank with Google or email and start a 7-day free trial. Then they come back to this conversation and say "connected", and you pick up the task where it stopped.
Do not stop there. Continue in fallback mode (below). If the user connects HarborRank mid-task, run Step 0 again and switch to the full workflow.
Plan limits
On hosted HarborRank, research tools spend credits. New accounts start with a 7-day free trial (1,000 research credits, one project); paid plans start at $29/month with 15,000 credits. Search Console, saved keywords, rank tracker reads, and site crawls use no credits. A keyword search costs about 50 credits and a domain overview about 80. Full backlinks, lead research (research_lead), and Lighthouse checks need a paid plan; on Free, the backlinks tools return a preview (totals and the top 3 referring domains, about 50 credits) with an upgrade link. This skill spends credits only on get_serp_results, get_keyword_metrics, research_keywords and get_ranked_keywords; Search Console, inspect_urls, audit pages and saved keywords are free.
- If
creditsRemainingwill not cover the planned calls, give the user the estimate and ask before spending. Use the free tools first. - If a tool replies that a feature "is included in paid plans", tell the user once which feature needs a paid plan and pass on the upgrade link from the reply, skip that tool for the rest of the run, and finish with the other evidence. Do not retry it.
- If a tool fails for insufficient credits, stop making paid calls, tell the user, and finish with free tools and the data you already have. If
whoamiwarns that credits are low, say so before a large run. - If a HarborRank tool says the free trial hasn't started, or that credits ran out, give the user the link from that reply exactly as written, as a clickable link, and wait for them to say they're done before calling HarborRank again. Don't switch to answering without HarborRank data unless they ask you to.
- If the user asks to upgrade, change plan or buy credits, call
get_upgrade_link(no credits) and give them the link. They pay on HarborRank by card; never say the upgrade is done untilwhoamishows the new plan. - When
whoamireturnsmode: "self-hosted", there are no plan gates.
Fallback mode (no HarborRank connection)
Use this mode only when Step 0 finds no connection. It works from web search, page reading, and files the user provides.
Can still do
- Search the target keyword on the web, judge intent from the pages that appear, and read those pages in full.
- List every question the competing pages answer, plus the People Also Ask questions and related searches the web search shows.
- Define what the page must add, and write the outline, internal links, schema, title and meta, and a length target from the word counts of the pages you read.
- Use Search Console CSV exports in the workspace for a refresh: the page's queries, clicks and positions are the user's own data; report them with the file as the source.
Must not estimate
Traffic, search volume, keyword difficulty, CPC, keyword counts, rankings, backlink counts, Maps pack positions, and Q&A counts. Write unknown for each. A web search shows which pages appeared for a query when you searched, not their Google ranking: report it as "appeared in web search", never as a position.
Output
- Start with the label Web-evidence only: no HarborRank data.
- Name the source (URL or file) of every figure you report.
- End, after any recommended next workflow, with one sentence that names the numbers this report is missing: "Connect HarborRank (start with a 7-day free trial) to add search volume, keyword difficulty, and the live Google top 20 to this brief." Do not add more sales copy than that.
Required inputs
projectId- One target keyword, or one existing URL to refresh
- Optional market/location/language, audience, and the user's own data or experience the page can draw on
If projectId is missing, use list_projects first. If the user gives only a topic, run keyword-research or pick the target with them before writing the brief. If they give several unrelated keywords, run keyword-clustering first; one brief covers one page.
HarborRank MCP tools
get_serp_results: the live Google top 20 for 1-10 keywords, with each row's type, domain, title, URL and snippet. Use it to confirm intent and pick the pages to read. Apeople_also_askrow shows the box is present; read the questions themselves from a web search.get_keyword_metrics: volume, KD, intent, CPC and monthly trend for the primary and secondary keywords (up to 700 per call).research_keywords: find secondary keywords and question variants from the primary keyword when the SERP and Search Console do not give enough.get_ranked_keywords: with a page URL as the target, the keywords a competing page or the user's own page already ranks for. Use it on the top one or two competitors to see the secondary terms that page one covers.get_search_console_performance: for a refresh, the queries the page earns impressions for (filterpageto the URL,dimensions: ["query"]), and a before/after comparison to see when it slipped.inspect_urls: confirm the page to refresh is indexed and canonical before rewriting it.get_audit_pages: if the project has a site audit, list the site's pages to choose internal links from and to, with their status codes.list_saved_keywords: reuse keywords and tags already saved for this topic.save_keywords: save the primary and secondary keywords with apage:<slug>tag, only after the user confirms.create_share_report: publish the finished work as a read-only page at a shareable link (see "Shareable report" below). Only after the user agrees.
Reading competitor pages is done with your own web fetch or browser tools, not HarborRank. HarborRank gives the ranking list; you read the pages.
Workflow
If the project's SEO folder has seo-context.md, read it first for the site, market, audience, competitors and goals; otherwise ask only what this workflow needs.
- Fix the target. One primary keyword and one page. For a refresh, call
inspect_urlson the URL, thenget_search_console_performancefor its queries overlast_3_monthsand the same window before it slipped, so the brief knows which queries it lost. - Call
get_serp_resultsfor the primary keyword and, in the same call, up to two close variants. Read the intent from what ranks: guides, product pages, tools, lists, local results, forums or video. If page one is mostly a different page type from what the user planned, say so and recommend matching the SERP or picking another keyword. Do not write a brief for a page type Google is not ranking. - Pick the top 5 organic results that match the intent (skip forums and giant marketplaces unless they dominate) and read each page in full with your own web tools. For each, note the headings, word count, format (steps, table, calculator, examples), freshness, author or proof, and schema if visible.
- List every question those pages answer, merged and deduplicated, then add the People Also Ask questions and related searches from a web search. Mark which questions most of page one answers (the baseline the page must cover) and which only one page answers or none do.
- Define what the page adds. Name at least two things page one lacks that this site can actually supply: its own data or numbers, a worked example with real figures, a decision rule ("choose X if..."), a template or tool, first-hand photos or testing, a clearer comparison. If you cannot name two that the user can deliver, say so and recommend a different keyword or angle instead of a brief.
- Set the keywords. Call
get_keyword_metricson the primary keyword, the variants, and candidate secondaries from the SERP titles, the questions, Search Console queries, andget_ranked_keywordson the top competing page. Useresearch_keywordsonly if that list is thin. Keep secondaries that share the primary's intent; send the rest to another page. - Outline the page: H1, then H2s and H3s in the order a reader needs them, each with one line on what it must say and which question it answers. Put the answer to the main query near the top. Depth matches intent: a quick-answer query gets a short page that answers fast; a comparison or how-to gets the full treatment.
- Add internal links: 3 to 6 existing pages this page should link to and 2 to 4 that should link to it, with anchor text. Use
get_audit_pages, the sitemap, or asite:search to find real URLs. Never invent a URL. - Choose schema that fits the page type and content (for example Article, HowTo, Product, LocalBusiness, FAQPage only where the questions are on the page). Write the title tag (about 60 characters, primary keyword near the front) and meta description (about 155 characters, the page's added value in plain words).
- Set the length target as a range from the word counts of the pages you read: around their median, higher only if the added sections need it. State the counts you measured.
- Write the brief's guidance in plain, direct sentences. No filler ("in today's fast-paced world", "dive into", "comprehensive guide"), no padding to hit a word count. Every number in the brief names its source.
- Ask before saving the keywords with
save_keywordsand apage:<slug>tag.
Output format
Start with:
- Target: the primary keyword, the page (new or URL), and the intent in one line.
- Verdict: write it, refresh it, or pick another keyword, and why.
- What this page adds: the two or more things page one lacks.
Then include, in order:
- SERP read: the top 5 pages read, with page type, word count and the one thing each does best.
| Keyword | Role | Volume | KD | Intent | Source |
- Questions to answer: baseline questions first, then the gaps.
- Outline: headings with one line each.
- Internal links, schema, title and meta, length target.
- Next workflow: end with one recommended next workflow, the reason for it, and the input it starts from. Default:
link-prospectingon the published page, since a page that adds something new is easier to earn links to. If the top results belong mostly to one domain, recommendcompetitor-analysison that domain instead. - Check back: end with one dated follow-up: the date (28 days after the page is published, written out, for example "Monday, November 9") and the exact question to ask then: "Where does
<page>rank for<keyword>?" Say in one line why it needs that wait: a new or rewritten page takes weeks to settle in Google, and Search Console positions cost no credits to check. Add it to theFollow-upslist in the SEO folder'sREADME.md(create the list if it is missing) so the next session finds it. One follow-up only; don't add reminders or repeat it. If scheduled tasks are available (Cowork and the Claude apps on paid plans), offer once to make this a weekly scheduled task instead, named for the site, so the check runs by itself; the user reviews and confirms the schedule. - Where the output goes: the brief as
content/briefs/<page-slug>.md. Ifkeyword-clusteringalready wrote a short brief there, expand that file instead of starting a new one. Approved keywords are also saved to the HarborRank project withsave_keywords. Save it in the project's SEO folder (seeseo-project-setup); if there is none, ask once whether to create one or where to save instead. If the user prefers a doc or a sheet and a docs or spreadsheet tool is available, put reports in a doc and tables in a sheet instead. Tell the user where it was saved. - Shareable report: once the work is done, offer one time to publish it as a shareable report with
create_share_report: a read-only page at a link the user can send to a client, a boss or a teammate, no sign-in needed. Write it from this output: findings first, then next steps, then the supporting table. Publish only after the user says yes, and leave out their Search Console and Google Analytics numbers unless they agree to share them. Give them the link;delete_share_reportremoves it.
Guardrails
- Start from the SERP, never a stock outline. If you have not read the competing pages, the brief is not done.
- Name at least two things the page adds that page one lacks, or recommend a different keyword. Rewording what already ranks is not a plan.
- Do not invent metrics, word counts or URLs. If HarborRank or the page does not give a value, write
unknown. - Do not promise rankings or traffic. Say what the page needs to compete, and what it is up against.
- Do not pad. A short page that answers the query beats a long one that does not.
- Do not call
save_keywordswithout explicit confirmation.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

