illyism/seo-skills

understand-customers

Builds a buyer-psychology research brief covering customer pains, switching triggers, objections, inner monologue, and verbatim phrasing before writing a word of copy.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/illyism/seo-skills --skill understand-customers

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

For my product/service, [Briefly describe your product/service, e.g., "an AI-powered link building tool"], help me create Blitz Copy by first deeply understanding my ideal user. Answer these questions:

  1. Core Identity & Role:
  • Who are they really (e.g., "ambitious SaaS founder," "overwhelmed marketing manager," "freelancer struggling to scale")?
  • What's their primary goal related to the problem my product solves?
  1. Deepest Pains & Frustrations (The "Nightmare Scenario"):
  • What is their current biggest, most visceral nightmare related to [the problem your product solves, e.g., "link building," "content creation," "sales outreach"]?
  • What specific words or phrases do they use to describe this pain?
  • What deep inner thoughts or inner monologue is driving them?
  • What have they tried before that failed or disappointed them? Why?
  • What are the emotional consequences of this pain (e.g., "feeling stuck," "wasting money," "falling behind competitors," "imposter syndrome")?
  1. Unspoken Desires & Aspirations (The "Magic Wand" Outcome):
  • If they could wave a magic wand, what's the ultimate, almost "too good to be true" outcome they dream of regarding [the problem area]?
  • Beyond the functional benefit (e.g., "more backlinks"), what does this outcome mean for them emotionally or in terms of status (e.g., "market leader," "peace of mind," "industry recognition," "freedom")?
  • What would make them feel like they've found a "cheat code" or an "unfair advantage"?
  1. Language & Worldview:
  • What specific jargon, tools, or influencers are part of their world?
  • What's a core belief they hold about [the problem area] that my product can affirm or satisfyingly challenge?

Based on these insights, let's brainstorm initial Blitz Copy angles (Identity Triggers, Emotional Hooks, Pattern Interrupts, Dopamine-Driven Payoffs).

from this repository

More skills

All skills
illyism
Community

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.

1h installs
3
GitHub stars
1.8K
Updated
Nov 20
illyism
Community

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.

1h installs
3
GitHub stars
1.8K
Updated
Nov 20
illyism
Community

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.

1h installs
3
GitHub stars
1.8K
Updated
Nov 20
illyism
Community

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.

1h installs
3
GitHub stars
1.8K
Updated
Nov 20