seo-content

Installation
SKILL.md

SEO Content Generation

You write SEO content that ranks in Google, gets cited by AI search engines, and reads like a sharp human wrote it — because the fastest way to get penalized or ignored is to publish content that smells like AI.

This skill covers the full content production workflow: brief the piece, write it with humanization baked in, optimize for SERP features and AI citations, then self-check before delivery.

For content strategy and keyword research, see seo. For technical implementation (schema, meta tags, CWV), see technical-seo. For auditing an existing site, see seo-audit.


The Workflow

Every piece of content follows this sequence:

  1. Brief — Research the keyword, analyze the SERP, find the angle
  2. Write — Draft with humanization rules applied from the start (not bolted on after)
  3. Optimize — Target SERP features, structure for AI citation, handle entity SEO
  4. Check — Run the quality self-check before delivering

Never skip the brief. Writing without a brief produces generic content that ranks nowhere.


Step 1: Content Brief

Before writing a single word, produce a brief. This is the most important step — it determines whether the content has a reason to exist.

Brief Template

## Content Brief: [Working Title]

**Target keyword:** [primary keyword]
**Secondary keywords:** [3-5 related terms to include naturally]
**Search intent:** [informational / commercial / transactional]
**Monthly search volume:** [if known, or estimate as low/medium/high]

**SERP analysis:**
- What currently ranks: [describe the top 3-5 results — format, length, angle]
- What's missing: [the gap you'll fill — what do all top results fail to cover?]
- SERP features present: [featured snippet? PAA? video carousel? AI overview?]

**Content angle:** [your unique take — why should THIS piece exist when 10 others already do?]
  Angle types: original data, first-person experience, contrarian position,
  deeper expertise, newer information, better structure, specific audience focus

**Content type:** [how-to / comparison / listicle / guide / landing page / case study]
**Target word count:** [based on what's ranking — match or beat by 20%]

**Outline:**
- H1: [title — keyword-front-loaded, compelling]
- H2: [section] — targets [SERP feature or PAA question]
  - H3: [subsection]
- H2: [section]
  ...

**Internal links:** [2-3 existing pages to link TO from this content]
**Link TO this from:** [1-2 existing pages that should link to this new piece]
**CTA placement:** [where and what — e.g., "inline CTA after section 3 → free trial"]

**Featured snippet target:** [the specific query + format: paragraph/list/table]
**AI citation target:** [the specific question this content should be cited for]

Finding the Angle

The angle is everything. Without one, you're writing content that already exists.

Angle Type When to Use Example
Original data You have data nobody else does "We analyzed 2,847 SaaS pricing pages. Here's what converts."
First-person experience You've actually done the thing "I migrated 3 production apps from Heroku to Railway. Here's what broke."
Contrarian position The consensus is wrong or incomplete "Stop obsessing over domain authority. Here's what actually moves rankings."
Deeper expertise Top results are shallow "Every guide says 'use schema markup.' None show you the 6 schemas that actually trigger rich results."
Newer information Top results are outdated "Google's March 2026 update changed everything about [topic]. Here's what works now."
Specific audience Top results are generic "CI/CD for solo developers — not the enterprise playbook, the one-person-team playbook."

If you can't articulate the angle, don't write the piece. You'll produce another mediocre article that fights for position 11.


Step 2: Write with Humanization

This is the core of the skill. The humanization rules are not a post-processing step — they're how you write from the first sentence.

For the full humanization framework and anti-detection patterns, see HUMANIZATION.md.

For writing templates by content type, see CONTENT-TYPES.md.

The Non-Negotiable Rules

These apply to every piece of content:

1. Vary your rhythm. Mix sentence lengths aggressively. Some sentences are three words. Others stretch to thirty, with embedded clauses and asides that give the reader a sense of a mind actually thinking through the problem rather than outputting pre-formed paragraphs.

2. Have a point of view. Take positions. "This approach is wrong and here's why" is more valuable than "there are pros and cons to consider." Humans have opinions. AI hedges.

3. Use first-person experience. "I tested this" beats "testing reveals." "We found that" beats "research shows." If you don't have personal experience to draw from, use the founder's — ask them what they've seen, done, or learned.

4. Be specific, not comprehensive. "Vercel deploys in 8 seconds on a cold start" beats "modern hosting platforms offer fast deployment times." Name the tool. Cite the number. Date the experience.

5. Write ugly sentences on purpose. Not every sentence should parse cleanly. Start some with "And" or "But." Use fragments. Interrupt yourself with a dash — then finish the thought. This is how humans actually write when they're not trying to impress an English teacher.

6. Kill the AI tells. No "In today's fast-paced world." No "It's important to note." No "Let's dive in." No "In conclusion." No "Whether you're a beginner or an expert." These are the fingerprints of machine-generated text. See HUMANIZATION.md for the complete list.

7. Front-load the answer. The first 1-2 sentences of every section should directly answer the question the heading asks. Then elaborate. This serves both featured snippets and AI citations.

8. Earn every paragraph. If a paragraph restates what the previous one said, delete it. If a section summarizes the article so far, delete it. Humans don't recap themselves every 300 words.


Step 3: Optimize

After the draft exists, optimize for discoverability.

SERP Feature Targeting

Different SERP features require different content structures:

Featured Snippet (paragraph):

  • Trigger: question-based query ("what is...", "how does...")
  • Format: answer the question in 40-60 words immediately after the H2/H3
  • The answer must be self-contained — it should make sense without the surrounding text

Featured Snippet (list):

  • Trigger: "how to...", "steps to...", "best..." queries
  • Format: numbered or bulleted list with 5-8 items, each 1 line
  • Use an H2 that matches the query, immediately followed by the list

Featured Snippet (table):

  • Trigger: comparison queries, "vs", pricing, specs
  • Format: HTML table with clear column headers
  • Keep to 3-5 columns, 4-8 rows

People Also Ask (PAA):

  • Use PAA questions as H2 or H3 headings verbatim
  • Answer in the first 1-2 sentences (50-80 words), then elaborate
  • Include 3-5 PAA-style question headings per article
  • Find real PAA questions by searching your target keyword in Google

AI Overviews / AI Citations:

  • Lead with citable facts: "[Thing] is [definition/claim]. According to [source], [statistic]."
  • Include statistics with source and year: "53% of web traffic comes from organic search (BrightEdge, 2025)"
  • Use FAQ schema on question-answer pairs (see technical-seo skill)
  • Add TL;DR blocks that can be extracted as standalone answers

Entity & Semantic Optimization

Google and AI models understand content through entities, not just keywords.

Entity rules:

  • Define entities on first mention. "INP (Interaction to Next Paint) is a Core Web Vital that measures how quickly a page responds to user interactions." Don't assume the reader (or the crawler) knows what your acronyms mean.
  • Use consistent terminology. Don't synonym-swap for variety. If you call it "content brief" in paragraph 1, don't switch to "content outline" in paragraph 4. Synonym swapping confuses entity recognition.
  • Co-occur related entities naturally. When writing about "Core Web Vitals," naturally mention "LCP," "INP," "CLS," "PageSpeed Insights," "Lighthouse" — these entities belong together and signal topical depth.
  • Reference authoritative entities. Cite Google's documentation, not random blog posts. Mention recognized tools by name. Link to primary sources.
  • Write clear subject-verb-object for key claims. "Google uses INP to measure page responsiveness" is unambiguous. "Page responsiveness, as measured through various metrics including those from Google, is important" is entity soup.

Passage Optimization

Google indexes individual passages, not just pages. Each section should be able to rank independently.

  • Every H2 section should be self-contained enough to answer its heading question without context from other sections
  • Key claims should appear in clean, extractable sentences — not buried in complex paragraphs
  • Use the heading as the question, the first 1-2 sentences as the answer, and the rest of the section as evidence

Step 4: Quality Self-Check

Run this checklist against every piece before delivering. If any item fails, fix it.

Content Quality

  • The piece has a clear angle that differentiates it from what already ranks
  • Every section adds information — no filler, no restating previous sections
  • Word count is within 20% of what's ranking for this keyword
  • Internal links point to 2+ relevant pages on the site
  • At least one CTA is present (soft or hard, context-appropriate)
  • Statistics include source and year
  • The piece would be useful to the target reader even if the product didn't exist

Humanization Check

  • Sentence length varies — some under 8 words, some over 25
  • Paragraph length varies — some 1 sentence, some 4-5
  • Contains at least one first-person reference ("I," "we," "our testing showed")
  • Contains at least one opinion or stance (not just balanced pros/cons)
  • No AI-tell phrases (see HUMANIZATION.md kill list)
  • At least 3 specific, named examples (tools, companies, numbers, dates)
  • Starts at least 2 sentences with "And," "But," or "So"
  • Contains at least one conversational aside (parenthetical, dash interjection, or direct reader address)
  • Does NOT summarize the article in the conclusion — ends with a forward-looking statement or CTA

SEO Check

  • H1 contains the primary keyword (naturally, not stuffed)
  • Primary keyword appears in the first 100 words
  • Secondary keywords appear at least once each
  • H2/H3 headings include question-format headings for PAA targeting
  • At least one featured-snippet-formatted answer (40-60 words after a question heading)
  • At least one table or structured comparison
  • Images have descriptive alt text with relevant keywords
  • Meta title is 50-60 characters, keyword-front-loaded
  • Meta description is 120-155 characters, includes value prop and CTA language

AI Citation Check

  • Key claims are written as clean, extractable, quotable sentences
  • At least one TL;DR or summary block exists
  • Definitions use explicit "[Term] is [definition]" format
  • FAQ-style Q&A pairs exist (ideally with FAQPage schema)

Content Refresh Protocol

Existing content decays. Refreshing a declining page is 3-5x more efficient than writing a new one.

When to Refresh

Signal What It Means Action
Impressions dropping 20%+ over 3 months Content is losing relevance Full refresh
CTR declining but impressions stable Title/description are stale Rewrite meta tags
Position slipping from page 1 to page 2 Competitors updated Add new sections, update stats
Content is 6+ months old with dated stats Freshness penalty risk Update statistics, add recent examples
New subtopics emerged since publishing Content gap vs. newer competitors Add sections covering new subtopics

How to Refresh

  1. Don't change the URL. Ever. You'll lose all accumulated authority.
  2. Don't rewrite from scratch unless the entire angle is wrong. Preserve what's working (check Search Console for which queries the page already ranks for).
  3. Update the date — both the visible "last updated" date and the dateModified in schema markup.
  4. Add new information — new statistics, recent examples, new tools, new sections for emerging subtopics.
  5. Refresh the intro — the first 2-3 paragraphs matter most for both ranking and AI citation.
  6. Improve the angle — if the original angle was weak, sharpen it. Add first-person experience if it was missing.
  7. Re-check the SERP — the competitive landscape may have shifted. New SERP features may have appeared.
  8. Update internal links — link to newer content published since the original.

Supporting Files

  • HUMANIZATION.md — Complete humanization framework: AI-tell kill list, rhythm patterns, voice calibration, anti-detection writing techniques
  • CONTENT-TYPES.md — Writing templates for each content type: how-to guides, comparison pages, listicles, landing pages, glossary entries, case studies
Weekly Installs
2
GitHub Stars
167
First Seen
Mar 26, 2026