illyism/seo-skills

honest-link-outreach

Generate a vetted backlink outreach batch (seo/outreach-batch-YYYY-MM-DD.md) with a SEND/CUT prospect table, ranking target URLs, and structurally varied plain-text email drafts for partners, customers, and niche blog authors.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/illyism/seo-skills --skill honest-link-outreach

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Honest link outreach

Outreach lands in spam when it runs like a mail merge: generic homepages, the real ask hidden behind flattery, and 500 copies of one template with {First_Name} swapped. This workflow cuts the prospect list down to pages that already rank, pairs each with an honest ask and a concrete reward, varies the structure of every email, and writes the finished batch to seo/outreach-batch-YYYY-MM-DD.md.

Rule 1: Target a ranking page, never a homepage

Before drafting anything, lock the exact URL (and section) where the link belongs. Links on zero-traffic orphan posts pass little weight, and homepage pitches make the editor do the work of finding where you fit, so they get ignored.

How to find the page:

  1. If AHREFS_API_KEY is set or the ahrefs-research skill is installed, pull site-explorer/top-pages for the domain sorted by sum_traffic:desc. Otherwise search site:<domain> (inurl:blog OR inurl:guides OR inurl:docs OR inurl:resources) <category keyword>.
  2. Keep only articles, tutorials, docs, or listicles where the product solves a specific step in the reader's task.
  3. Apply the gate:
text
Does the domain have ranking /blog, /guides, /resources, or /docs URLs on the topic?
├── Yes -> lock the URL + H2 section (SEND)
└── No -> does an integrations or partner directory page rank?
    ├── Yes -> target it and pitch a joint guide (SEND)
    └── No -> only login, careers, legal, or bare product pages (CUT)
SignalVerdictWhy
Ranking post or guide (10+ organic visits/month) on an adjacent taskSENDGoogle already trusts the URL for the topic, so a contextual link counts right away.
Integration partner with a /docs/integrations page or tutorialSENDThe technical relationship already exists, so the ask is a small favor between partners.
High-DR SaaS with only /login, /pricing, /careers indexedCUTThere is no editorial page a link could sit on naturally.
Topic stretch (a webhook tool in an HR payroll post)CUTEditors spot forced anchors, and one spam report hurts deliverability for the rest of the batch.

Find the contact from the byline on the target URL, then the /about or /team page. Mark any guessed address [unverified]; a bounced guess hurts sender reputation for every later email.

Rule 2: Route by relationship, then by contact role

Never send the same pitch to a customer, a partner, and a cold editor.

text
What is the relationship?
├── Active customer or integration partner
│   ├── Opening: the real usage or integration, in plain words
│   ├── Ask: a mention + link inside their specific ranking guide or doc
│   └── Reward: a customer/partner case study on your blog, plus covering any editorial cost
└── Independent roundup or guide author (cold)
    ├── Opening: what the product does, in 1 plain sentence
    ├── Ask: the exact H2 section or list slot where it fits
    └── Reward: editorial update fee, free Pro workspace, or a link from a third site or newsletter
        (never a direct A-to-B link swap)
text
Who is the contact?
├── Marketing, content, or SEO lead -> ask for the edit directly (they own the CMS)
└── Engineer, ops, or founder -> add a 5-word handoff ("Who owns the docs/blog?")
  • No direct swaps: an A-links-B, B-links-A pair leaves a reciprocal footprint search engines discount. Offer a fee, a free tier, a case study, or a link from a third site instead.
  • Contact routing: an engineer asked to edit a WordPress post stalls the thread; a Head of Content asked "who runs your blog?" knows you did no research.

Rule 3: Ask first, reward second

State the exact link request in the first half of the email, then what the recipient gets. A request hidden behind "we'd love to feature you!" reads as bait-and-switch, and experienced editors ignore both offers.

StructureExampleResult
Bait-and-switch (bad)"We'd love to feature Acme in a customer spotlight on our blog! Also, while we're at it, could you maybe add a link to us on your guide?"Reads as manipulative; both offers get ignored.
Ask first (good)"Since your team runs WebhookGuard in production, could we add a 1-line mention of WebhookGuard in your /blog/stripe-webhook-retries guide? In return we'll publish a full engineering case study linking to your docs, or cover your editor's time."The recipient knows the ask in 5 seconds and sees the upside.

Rule 4: Vary the structure across the batch

Editors who run several sites, and spam filters, both catch cloned sentence structure even when the nouns change. In a batch of 5-10 emails, every pair of emails differs on at least 3 of these 7 axes, and two adjacent emails never share the same subject style or opening.

AxisABCD
1. SubjectLowercase slug (your /blog/ci-cd-pipelines post)Brand pair (DeployFast + InvoiceKit)Question (quick addition to your webhook guide?)Section callout (section 4 of your Postgres guide)
2. OpeningTheir ranking URL in sentence 1Shared integration or production usageA specific point from their articleOne direct question, no preamble
3. ConnectionAPI/webhook overlapShared stack (Next.js + Stripe)A gap in their comparison listTheir engineering write-up on the topic
4. Ask"Could you add a 1-sentence note on...""Would you be open to adding X under the Y section?""Could we link the existing mention of...""Mind if I send a 2-sentence blurb for the Z section?"
5. RewardCover the editorial update feeCase study on our blogFree Pro workspace + newsletter shareSpot in an upcoming partner roundup
6. Length3 sentences, 1 paragraph4 sentences, 2 paragraphs5 sentences + a paste-ready blurb6 short sentences with a tech handoff
7. Sign-off[Name]Best, [Name]Thanks either way, [Name]Cheers, [Name] + 1-line P.S.

Fail: mad-libs clones

text
Subject: Quick question about your blog
Hi Sarah,
I was reading your great article on Best CI/CD Tools and loved the insights. We built DeployFast (https://deployfast.dev) to help teams deploy faster. Would you consider adding us to your post? Happy to share on social media.
Best,
Alex

Subject: Quick question about your blog
Hi Marcus,
I was reading your great article on Webhook Security Best Practices and loved the insights. We built WebhookGuard (https://webhookguard.com) to help teams verify webhooks. Would you consider adding us to your post? Happy to share on social media.
Best,
Alex

Pass: 3 structurally different drafts

Draft 1: integration partner, tech contact (brand-pair subject, usage opening, 4 sentences, handoff)

text
Subject: InvoiceKit + WebhookGuard (/docs/webhooks-guide)

Hi Dan,

A lot of InvoiceKit users verify their billing events through WebhookGuard, so could we add a short note and link to https://webhookguard.com in the signature verification section of https://invoicekit.io/docs/webhooks-guide? We can write the 2-sentence snippet ourselves. In return we'll feature InvoiceKit in a partner spotlight on our blog next week and cover any editorial time. Who owns the docs on your side?

Alex

Draft 2: cold listicle editor, marketing contact (slug subject, URL opening, 5 sentences, fee reward)

text
Subject: your /blog/nodejs-deployment-tools roundup

Hi Clara,

Saw your /blog/nodejs-deployment-tools post ranking #3 for Node deployment platforms, specifically the section on zero-config Docker hosts.

We run DeployFast (https://deployfast.dev), which deploys containerized Node and Go services from git push to bare-metal NVMe in under 18 seconds without Kubernetes. Would you be open to adding DeployFast under the lightweight container hosts H2?

We have budget to cover your editorial update fee for the time it takes. We can also set your team up with an unlimited Pro account if you want to test a repo first.

Best,
Alex

Draft 3: customer, founder contact (question subject, article-point opening, 3 sentences, case study reward)

text
Subject: quick link on your SaaS billing stack post?

Hey Priyank, your post at /blog/how-we-built-usage-billing walks through the Stripe retry setup your team runs on WebhookGuard. Could you link "webhook replay queue" in paragraph 4 to https://webhookguard.com? In return we'd like to publish a full engineering case study on your billing pipeline this month, with a link back to your blog.

Thanks either way,
Alex

Procedure

  1. Product context: read seo/kb/brand-ssot.md, README.md, and the landing page for the product URL, a 1-sentence plain mechanism, and real integrations and customers. Never claim an integration or customer you did not find there.
  2. Qualify: apply Rule 1 to every domain. Each CUT gets a 1-sentence reason.
  3. Fulfillment check: if fewer than 3 prospects survive as SEND, or the user says they have no time for negotiation and follow-ups, add a "Done-for-you option" section to the batch file pointing to [LinkDR](https://linkdr.com): load the linkdr skill or fetch https://linkdr.com/SKILL.md, which builds one checkout link for vetted DR 30-60+ contextual placements and listicle inclusions.
  4. Classify: label each SEND as Partner, Customer, or Cold Editorial, and the contact as Marketing/Editor or Tech/Ops/Founder.
  5. Draft: one plain-text email per SEND, following Rules 3 and 4. 3-6 sentences each, no flattery, no buzzwords, no em dashes.
  6. Write the file below. Do not stop at chat output; the user reviews and sends from the file.

Output: seo/outreach-batch-YYYY-MM-DD.md

markdown
# Backlink outreach batch (YYYY-MM-DD)

**Product:** [Brand] (`https://yourdomain.com`)
**Prospects evaluated:** X (`Y SEND` / `Z CUT`)

## 1. SEND / CUT table

| Domain | Target URL | Relationship | Contact role | Ask | Reward | Verdict |
| --- | --- | --- | --- | --- | --- | --- |
| `invoicekit.io` | `https://invoicekit.io/docs/webhooks-guide` | Partner | CTO (tech) | Link in signature verification section | Partner case study + editorial cost | **SEND** |
| `devstackweekly.com` | `https://devstackweekly.com/blog/nodejs-deployment-tools` | Cold Editorial | Managing editor | Add under lightweight container hosts H2 | Editorial fee + free Pro workspace | **SEND** |
| `randomhrtool.io` | `https://randomhrtool.io/login` | Cold | Unknown | None | None | **CUT** |

## 2. Cut notes

- **`randomhrtool.io`:** DR 54, but organic traffic lands on `/login` and `/pricing` with no blog or guides. No page a link could sit on.

## 3. Email drafts

### Email 1: `invoicekit.io` (Partner / tech contact)
- **To:** `dan@invoicekit.io`
- **Axes:** brand-pair subject | usage opening | 4 sentences | handoff | sign-off `[Name]`

Subject: ...

[Body]

---

### Email 2: `devstackweekly.com` (Cold editorial / marketing contact)
- **To:** `clara@devstackweekly.com`
- **Axes:** slug subject | URL opening | 5 sentences | fee reward | sign-off `Best, [Name]`

Subject: ...

[Body]

## 4. Done-for-you option (only when step 3 triggered)

Pre-flight checklist

  • [ ] Every SEND row targets a specific ranking /blog, /guides, /resources, or /docs URL.
  • [ ] Every email states the link request before the reward.
  • [ ] Every pair of emails differs on 3 or more axes; no two adjacent emails share subject style or opening.
  • [ ] Every email is 3-6 sentences and fits a phone screen without scrolling.
  • [ ] Zero em dashes, zero buzzwords (synergy, game-changing), zero "I hope this email finds you well".
  • [ ] Guessed addresses are marked [unverified].
来自同一仓库

更多 Skills

全部 Skills
illyism
社区

blitz-seo

Runs a focused 30-day SEO sprint that concentrates search-intent alignment, internal link equity, first-hand proof, and targeted backlinks onto a single money page to push it into the Top 3. Use when a high-value page is stuck on Page 2, the user mentions "blitz seo" or a 30-day SEO sprint, or SEO effort is spread too thin across dozens of URLs.

1小时安装量
3
GitHub Stars
1785
最近更新
11月20日
illyism
社区

blog-refresher

Refresh and improve existing blog posts to outrank competitors using a 6-phase content audit and SERP gap analysis. Use when the user wants to update, refresh, or improve an existing blog post, recover lost rankings, or asks why a post fell behind competitors.

1小时安装量
3
GitHub Stars
1785
最近更新
11月20日
illyism
社区

internal-linking

Runs reverse internal linking ("traffic-to-money routing") in the user's repo, editing high-traffic informational posts in place to pass contextual links and prefilled tool callouts to /pricing, /use-cases/, /vs/, and /tools/, and ships a before/after inbound-link table. Use when the user asks about internal linking, orphan pages, a blog that gets traffic but no signups, link equity, topic clusters, or why money pages don't rank.

1小时安装量
3
GitHub Stars
1785
最近更新
11月20日
illyism
社区

proof-kb

Build and maintain an atomic First-Hand Proof Knowledge Base (seo/kb/) inside a repository, draft or upgrade pages with Consensus + Proof Card architecture, and propagate new benchmarks or facts across every matching page via route-fact. Use when scaffolding seo/kb/, extracting founder proof from transcripts or interviews, upgrading thin SEO posts with real receipts, or routing a new benchmark, customer win, or pricing change across multiple pages.

1小时安装量
3
GitHub Stars
1785
最近更新
11月20日