# Intro

Write short, Semrush-style blog post intros with journey teasers, practical relevance...

- Repository: https://github.com/Illyism/seo-skills (695 stars)
- Category: Writing
- License: see repository
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Illyism/seo-skills --skill intro -g -a claude-code -y`
Codex: `npx skills add Illyism/seo-skills --skill intro -g -a codex -y`
Cursor: `npx skills add Illyism/seo-skills --skill intro -g -a cursor -y`
Gemini CLI: `npx skills add Illyism/seo-skills --skill intro -g -a gemini-cli -y`

## Description

Write short, Semrush-style blog post intros with journey teasers, practical relevance, and reader intent matching. Use when the user asks for /intro, a blog intro, opening paragraph, article lead, listicle intro, or hook copy for a post.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Blog Intro Writer

Write engaging blog intros in the style of high-performing SEO listicles and guides ([examples.md](examples.md#contents)).

## Contents

- [When this applies](#when-this-applies)
- [First step](#first-step)
- [Commitments](#commitments)
- [Intro patterns](#intro-patterns)
- [Writing rules](#writing-rules)
- [Slug, title, and image alt](#slug-title-and-image-alt)
- [Default output](#default-output)
- [Full output format](#full-output-format)
- [Quality check](#quality-check)

## When this applies

The user invoked **`/intro`**, or asked for a blog intro, opening paragraph, or lead copy for a post.

Works on its own or after title work (see the `seo-title-optimization` skill). If the slug or title is missing, ask briefly or propose one.

## First step

Say: "Tell me a bit about your content and I'll write an intro for it."

Gather enough to match intent:

- Topic, primary keyword, and search intent (informational, listicle, how-to, comparison)
- Target reader and their goal
- Article shape: listicle count, H2/H3 outline, or key sections
- Product angle, if the post promotes one
- Optional: chosen title, slug, featured image subject

If the user already pasted an outline or draft, use it. Do not invent stats, market share, or legal claims unless they provided them.

## Commitments

I will:

- Use simple, concise English
- Return an image alt text
- Give a slug and a title
- Use lists where they help scanning
- Match the reader's intent to the content
- Introduce the topic and why it matters
- Tell readers what they will learn
- **Journey teaser:** a roadmap of the key steps or sections ahead
- **Explain why:** the practical importance of the topic
- **Relevance:** how the topic relates to the reader's goal
- Use short sentences and keep it short

## Intro patterns

Pick the pattern that fits the article type.

### Listicle (e.g. "21 Best Search Engines")

Reference: [listicle example](examples.md#listicle-search-engines)

The rest: https://github.com/Illyism/seo-skills/blob/HEAD/content/intro/SKILL.md