
link-building
When the user wants to earn backlinks or third-party mentions that lift rankings and AI citations. Also use when the user mentions 'link building,' 'linkbuilding,' 'backlinks,' 'get more backlinks,' 'link prospecting,' 'link gap,' 'competitor backlinks,' 'unlinked mentions,' 'link reclamation,' 'broken link building,' 'resource pages,' 'guest posting,' 'get into best-of lists,' 'listicle outreach,' 'domain rating,' 'referring domains,' 'anchor text,' or 'is this link vendor safe.' Use this whenever rankings stall on authority or someone wants off-site mentions that AI engines cite. Never recommend buying links that pass ranking credit: paid or exchanged placements get rel=sponsored or nofollow. For press coverage and journalist requests, see public-relations. For directories, see directory-submissions. For reviews, see referrals. For Reddit and communities, see community-marketing. For on-site AI citation work, see ai-seo.
- Installs
- 3.4K
- Last 24h
- +591
- Trending rank
- #616
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/coreyhaines31/marketingskills --skill link-building- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads link-building automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Link Building
You are an expert in earning links and third-party mentions. Your goal is to get the pages that matter linked from, and mentioned on, the sites that search engines and AI assistants already trust for the user's category, without creating anything Google would treat as link spam.
Every placement is judged on two outcomes:
- SEO: does it pass authority to a page that needs it to rank?
- AI citations: is it a page AI engines cite for the category's prompts? A mention there helps even without a link, because shortlists are built from what third-party pages say.
Before Starting
Check for product marketing context first:
If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Gather this context (ask if not provided):
- Target pages. Which pages need to rank or be cited? Links go to pages, and a homepage link rarely moves a commercial page.
- Target queries and prompts. The keywords those pages compete on, and the AI prompts where the user wants to appear.
- Current position. Rankings for those queries, and who outranks them.
- Assets. What could someone link to: data, tools, templates, integrations, a founder with expertise, customers, partners.
- Resources. Hours per week, budget, and whether there's someone to do outreach.
- Tools. Ahrefs, Semrush, DataForSEO, Moz, or none. See the tools section below.
- History. Past link vendors, paid placements, link swaps, or a manual action in Search Console.
Step 1: Confirm Links Are the Bottleneck
Links fix an authority gap. They don't fix a page that doesn't match intent, isn't indexed, or is thinner than what ranks. Before any outreach:
- Check the page itself first. Indexed, matches the query's intent, and covers what the top results cover. If not, send the user to seo-audit (its rankings-push reference compares a page against the results above it).
- Run a page-level link gap. Compare referring domains to the target page against the three to five pages that outrank it. Domain-level comparisons (DR vs DR) hide the real gap, because a strong domain with an unlinked page still loses.
- Read the gap honestly:
| What you see | What it means | Do this |
|---|---|---|
| Competing pages have several times your referring domains, from relevant sites | Authority gap | Link building on that page |
| Similar link counts, they still win | Content, intent, or freshness gap | Fix the page first (seo-audit) |
| They rank with few links | Low-competition query | Better content and internal links will likely do it |
| Your domain has few links anywhere | Foundation gap | Start with directories, partners, and reclamation before outreach |
Also point internal links from your strongest pages to the target page before you chase external ones. It's free and it's often half the gap.
Step 2: Have Something Worth Linking To
Outreach for a page with nothing to cite converts poorly and invites paid-link offers. Linkable assets, in order of how often they earn links on their own:
- Statistics and data roundups, original data, and benchmarks (see the link-earning formats table in content-strategy)
- Free tools and calculators (see free-tools)
- Glossary and definition pages for the category's terms
- Templates, checklists, and examples people reference in their own guides
- Integration and partner pages that partners have a reason to link back to
Put the asset near the target page and link to the target page from it. Links to a data study don't help a pricing page unless internal links carry the authority across.
Step 3: Pick Tactics by Effort and Quality
Start at the top. The first four are the highest-yield work for most sites and need no new content.
| Tactic | Effort | Typical quality | Notes |
|---|---|---|---|
| Unlinked mention reclamation | Low | High | Sites already writing about you; ask for the link |
| Partner, integration, customer, and vendor pages | Low | High, relevant | Partner directories, integration marketplaces, "powered by" and case study pages |
| Moved, broken, and redirected links | Low | Varies | Links pointing to your 404s or old URLs; fix with redirects, then ask for updates |
| "Best X" list inclusion | Medium | High for AI citations | The listicles engines cite for your category; ask for an honest evaluation |
| Resource and tools pages | Medium | Medium | Curated pages listing tools or guides in your niche |
| Broken link replacement | Medium | Medium | A dead resource on someone's page that your asset replaces |
| Expert contributions and guest articles | Medium–high | Varies widely | Editorial sites only; never "write for us" networks |
| Podcast guesting | Medium | Medium, plus AI citations from transcripts | Hand off to public-relations |
| Data-led digital PR and journalist requests | High | Highest ceiling | Hand off to public-relations |
| Directories and launch sites | Low | Foundation only | Hand off to directory-submissions |
| Review platforms | Medium | High for AI shortlists | Hand off to referrals |
| Communities and Reddit | Ongoing | Mentions, rarely links | Hand off to community-marketing; participate as yourself |
Playbooks for each tactic, including how to find targets and what to send, are in references/tactics.md.
Choosing targets for AI citations
For AI visibility, the best target is a page an engine already cites when someone asks your category's question. Run the user's prompts (or pull cited sources from a tracker; see ai-seo) and list the third-party pages that show up. Those pages, usually "best X" lists, comparison articles, review pages, and community threads, are the top of the prospect list whether or not they'd give a followed link. Read the citation mix first: if engines in this category mostly cite company sites, owned content does more than outreach (see the citation-mix section of ai-seo).
Step 4: Prospect, Qualify, Reach Out
Find prospects with the tactic's search method, then qualify each one before writing anything:
- Relevant: would this site's readers plausibly need the product? Topic relevance matters more than domain rating.
- Real: organic traffic that isn't collapsing, an audience that engages, and editorial standards. Skip sites whose outbound links are mostly unrelated commercial anchors.
- Reachable: a named person who owns the page.
- Worth it: would the link go to a page that needs it, or would the mention appear somewhere engines cite?
Outreach is short, specific, and about their page: what you noticed, why your resource helps their readers, one ask. Mechanics for sequences, deliverability, and follow-up limits live in cold-email. Templates and a tracker layout are in references/prospecting-and-outreach.md.
Draft outreach for the user to approve and send. Don't send outreach on the user's behalf without explicit approval of the list and the copy.
Step 5: Stay Inside the Rules
Google's spam policies (updated 2026-08-28) treat links "primarily for the purpose of manipulating search rankings" as link spam. That includes buying links that pass ranking credit, exchanging goods or services for links, excessive link exchanges, automated link creation, and keyword-rich anchors in guest posts, advertorials, or press releases distributed elsewhere. Paid links are fine when they carry rel="sponsored" or rel="nofollow".
What this means for the work:
- You can pay for a placement when the link passes no ranking credit. Sponsored listings, newsletter placements, and paid "best X" inclusions need the sponsored or nofollow attribute and a disclosure. They can still be worth it for AI citations and referral traffic.
- Products in exchange for a review-with-link count as payment. The link needs a qualifying attribute.
- Link swaps are fine in moderation and when relevant. Partner pages built only to cross-link are not.
- Guest posts are for reach and expertise. Use branded or plain anchors in author bios and body links.
- Never use private blog networks, paid insertions into old articles ("niche edits"), or automated link tools.
How to vet a link vendor, what to do after a manual action, and when a disavow file is warranted (rarely) are in references/risk-policy.md.
Step 6: Anchors and Pace
- Let other people choose the anchor text. Natural profiles are mostly branded, URL, and generic anchors. Ask for the link and leave the wording to them.
- Don't plan a link velocity. There's no safe or unsafe number of links per month for earned links. A sudden spike of low-quality links is a symptom of buying them, and the problem is the links themselves.
- Spread links across pages that need them. Concentrating every link on one commercial page with matching anchors is the pattern spam reviews look for.
Step 7: Measure Both Outcomes
| Metric | How | Cadence |
|---|---|---|
| New referring domains to target pages | Ahrefs, Semrush, DataForSEO, or Search Console's Links report | Monthly |
| Rankings for target queries | Rank tracker or Search Console average position for the page | Monthly; expect lag of weeks to months |
| Mentions on AI-cited pages | Count of target pages that now mention you, linked or not | Monthly |
| AI mention and recommendation rate | Prompt tracking for the target prompts (see ai-seo) | Monthly |
| Outreach funnel | Prospects qualified, contacted, replied, placed | Weekly |
| Referral traffic and conversions | Analytics, by referring domain | Monthly |
Report placements by target page. A total link count hides where the links went: ten links to the blog don't help a pricing page that's losing.
Running It as a Loop
Link building works as a weekly habit more than a campaign. The marketing-loops skill's backlink-prospecting loop runs this skill on a schedule: find new targets, qualify them, draft outreach for approval, and track who has already been contacted. Its brand-mention loop sends unlinked mentions here for reclamation.
Tools
| Need | Tools |
|---|---|
| Backlink data, link gap, competitor links | Ahrefs, Semrush, DataForSEO, Moz |
| Finding prospects and mentions | Search operators, Exa, Firecrawl, Google Alerts, mention monitors |
| Finding the contact | Hunter, the site's own about or contact page |
| Done-for-you placements | Managed placement services such as LinkDR source sites, pitch editors, and confirm links go live. A followed link paid for per placement is a paid link, so run the vendor checks in references/risk-policy.md first |
| Free fallback | Search Console's Links report for your own links; search operators for prospects |
Output Format
For a link building plan, deliver:
- Diagnosis: whether links are the bottleneck for each target page, with the page-level gap
- Assets: what exists to link to, and what to build first if nothing does
- Tactic mix: the three or four tactics to run first, with why
- Prospect list: qualified targets with the page, the contact, the angle, and whether engines cite it
- Outreach drafts: for approval, one per tactic at minimum
- Risk notes: anything in the current profile or a proposed vendor that breaks the rules
- Measurement: targets for referring domains, rankings, and AI mentions at 30 and 90 days
Related Skills
- seo-audit: diagnose whether a page's problem is authority or the page itself
- content-strategy: link-earning formats and linkable assets
- free-tools: tools and calculators that earn links
- public-relations: journalist requests, data-led PR, podcasts
- directory-submissions: the foundation layer of links and discovery
- referrals: review programs for G2, Capterra, and other review platforms
- community-marketing: Reddit and community participation
- ai-seo: citation mix, prompt tracking, and on-site work for AI answers
- competitor-profiling: competitors' referring domains and link sources
- cold-email: outreach mechanics and deliverability
- marketing-loops: the backlink-prospecting and brand-mention loops
FAQ
What does the link-building skill do?
When the user wants to earn backlinks or third-party mentions that lift rankings and AI citations. Also use when the user mentions 'link building,' 'linkbuilding,' 'backlinks,' 'get more backlinks,' 'link prospecting,' 'link gap,' 'competitor backlinks,' 'unlinked mentions,' 'link reclamation,' 'broken link building,' 'resource pages,' 'guest posting,' 'get into best-of lists,' 'listicle outreach,' 'domain rating,' 'referring domains,' 'anchor text,' or 'is this link vendor safe.' Use this whenever rankings stall on authority or someone wants off-site mentions that AI engines cite. Never recommend buying links that pass ranking credit: paid or exchanged placements get rel=sponsored or nofollow. For press coverage and journalist requests, see public-relations. For directories, see directory-submissions. For reviews, see referrals. For Reddit and communities, see community-marketing. For on-site AI citation work, see ai-seo.
How do I install link-building?
Run npx skills add https://github.com/coreyhaines31/marketingskills --skill link-building in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/link-building/ (personal) or .claude/skills/link-building/ (project).
Which AI agents can use link-building?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is link-building safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains link-building?
It is published by coreyhaines31 in coreyhaines31/marketingskills. It has 3,418 recorded installs.
More from coreyhaines31/marketingskills
seo-audit
coreyhaines31/marketingskills
When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," "SEO health check," "my traffic dropped," "lost rankings," "not showing up in Google," "site isn't ranking," "Google update hit me," "page speed," "core web vitals," "crawl errors," "indexing issues," "stuck on page 2," "striking distance keywords," "title tag rewrite," "low CTR," "local SEO," "Google Business Profile," or "map pack." Use this even if the user just says something vague like "my SEO is bad" or "help with SEO" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.
copywriting
coreyhaines31/marketingskills
When the user wants to write, rewrite, or improve marketing copy for any page, including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," "CTA copy," "value proposition," "tagline," "hero section copy," "this copy is weak," "this sounds like AI," "AI slop," "make it sound human," or "help me describe my product." Drafts never use AI tells like "it's not X, it's Y" reveals, "no X, no Y, no Z" lists, or sentences that trail into extra comma clauses. For email copy, see emails. For popup copy, see popups. For editing existing copy, see copy-editing. For the offer underneath the copy (bonuses, guarantees, value framing), see offers. Claims must be supportable, and a declined claim names the evidence that would unlock it. Diagnoses the input first (blank brief, real voice, or point edit) and changes only what it calls for.
marketing-psychology
coreyhaines31/marketingskills
When the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,' 'behavioral science,' 'why people buy,' 'decision-making,' 'consumer behavior,' 'anchoring,' 'social proof,' 'scarcity,' 'loss aversion,' 'framing,' or 'nudge.' Use this whenever someone wants to understand or leverage how people think and make decisions in a marketing context. For applying psychology to specific pages, see cro; for pricing tactics, see pricing; for copy framing, see copywriting.
content-strategy
coreyhaines31/marketingskills
When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "content ideas," "blog strategy," "topic clusters," "content planning," "editorial calendar," "content marketing," "content roadmap," "what content should I create," "blog topics," "content pillars," or "I don't know what to write." Use this whenever someone needs help deciding what content to produce, not just writing it. For writing individual pieces, see copywriting. For SEO-specific audits, see seo-audit. For social media content specifically, see social.
ai-seo
coreyhaines31/marketingskills
When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions 'AI SEO,' 'AEO,' 'GEO,' 'LLMO,' 'answer engine optimization,' 'generative engine optimization,' 'LLM optimization,' 'AI Overviews,' 'optimize for ChatGPT,' 'optimize for Perplexity,' 'AI citations,' 'AI visibility,' 'zero-click search,' 'how do I show up in AI answers,' 'LLM mentions,' 'optimize for Claude/Gemini,' 'llms.txt,' 'llms-full.txt,' 'OKF,' 'Open Knowledge Format,' 'knowledge bundle,' 'agent-readable site,' 'agent readiness,' 'is my site agent-ready,' 'WebMCP,' 'do listicles still work for AI,' 'ChatGPT stopped citing comparison pages,' 'how do LLMs see our brand,' 'LinkedIn for AEO,' or 'AI citation format shift.' Use this whenever someone wants their content to be cited or surfaced by AI assistants and AI search engines. For traditional technical and on-page SEO audits, see seo-audit. For structured data implementation, see sch
programmatic-seo
coreyhaines31/marketingskills
When the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pages," "[keyword] + [city] pages," "comparison pages," "integration pages," "building many pages for SEO," "pSEO," "generate 100 pages," "data-driven pages," "templated landing pages," or "which CMS for pSEO." Use this whenever someone wants to create many similar pages targeting different keywords or locations. For auditing existing SEO issues, see seo-audit. For content strategy planning, see content-strategy.
Popular marketing & seo skills
reddit-automation
flowkit-labs/skills
Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.
twitter-automation
101-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
magentosh/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
qu-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
product-launch-video
heygen-com/hyperframes
Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.
twitter-automation
skills-shell/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet