article-writing
Use when writing one long-form article end to end — answer-first lede, question-shaped headings, plus its on-page surface (title, meta, slug, FAQ, Article/FAQPage JSON-LD) — or fixing a draft that buries the answer or reads AI-padded. NOT keyword research or topic selection (that is `seo-geo`), NOT the editorial calendar (that is `content-engine`).
ericrisco · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add ericrisco/rsc-harness --skill article-writing技能说明
name: article-writing
description: "Use when writing one long-form article end to end — answer-first lede, question-shaped headings, plus its on-page surface (title, meta, slug, FAQ, Article/FAQPage JSON-LD) — or fixing a draft that buries the answer or reads AI-padded. NOT keyword research or topic selection (that is seo-geo), NOT the editorial calendar (that is content-engine)."
tags: [article, blog, long-form, seo-writing, geo, on-page, eeat, copywriting]
recommends: [seo-geo, content-engine, brand-voice, landing-copy, technical-writing, case-studies]
origin: risco
Article writing
Draft one long-form article end to end: the prose and the on-page surface that ships with it — answer-first lede, question-shaped headings, title tag, meta description, slug, FAQ block, and the JSON-LD that makes the piece machine-readable.
You own a single finished article. You do not pick the topic, build the calendar, or define the house voice — those are siblings below.
When NOT to use
| You want… | Go to |
|---|---|
| Keyword research, SERP tracking, technical SEO, deciding which topics to target | ../seo-geo/SKILL.md |
| Editorial calendar, topic-cluster plan, pipeline across many pieces | ../content-engine/SKILL.md |
| The reusable brand tone-of-voice spec the article is written in | ../brand-voice/SKILL.md |
| A conversion landing or sales page (hero, offer, CTA) | ../landing-copy/SKILL.md |
| An email newsletter issue (subject line, send) | ../newsletter/SKILL.md |
| Product docs, API reference, software how-tos | ../technical-writing/SKILL.md |
| A customer outcome story / narrative | ../case-studies/SKILL.md |
Rule: if the deliverable is not one publishable article, you are in the wrong skill.
Start from intent, not a word count
Before you write a sentence, read the top of the SERP for the target query. Name two things: the dominant intent (informational, transactional, comparison, navigational) and the winning format Google already rewards (listicle, step guide, definition + table, comparison). Match that format — fighting the shape Google already chose loses.
Then set depth from intent, not from a number you were handed. The first-page Google average is ~1,447 words across 11.8M results (Backlinko) — a descriptive average, never a target. Thoroughness and intent satisfaction rank, not length.
| Intent | Typical depth | Shape |
|---|---|---|
| Simple how-to / quick answer | 400–800 words | Direct answer, short steps, one image |
| Standard informational post | 1,500–2,000 words | Answer-first lede + question H2s |
| Comprehensive guide | 1,700–2,500 words | Full subtopic coverage, tables, FAQ |
| Pillar page | 2,500–5,000 words | Hub with two-way cluster links |
Why: padding a 600-word answer to 2,000 to "look thorough" dilutes it and reads as filler. Cutting a guide to 800 words leaves the query half-answered. Length follows the question.
The answer-first lede
The first ~200 words must directly and completely answer the primary query. Lead with the answer (TL;DR-first / inverted pyramid), then expand. This is the structure that wins featured snippets and AI Overview citations — and with zero-click hitting ~60% of searches (2024) and AI Overviews appearing in ~13% of queries (May 2025), being the extracted answer matters more than the click.
<!-- Bad: warms up for three paragraphs before answering -->
## Should you compost in an apartment?
Composting has become increasingly popular in recent years as more people
look for sustainable lifestyle choices. Many city dwellers assume they can't
participate because of limited space. But is that really true? Let's explore
the fascinating world of urban composting and find out together.
<!-- Good: answers in the first two sentences, then expands -->
## Can you compost in an apartment?
Yes — a sealed countertop bokashi bin or a small worm bin (vermicomposting)
lets you compost food scraps in a flat with no yard and no smell. Bokashi
ferments scraps in ~2 weeks; a worm bin yields finished compost in 3–6 months.
Here is how to choose between them and set one up in a 60×40 cm footprint.
If the query is a question, the H1 or first H2 should be that question and the next sentence should answer it. Worked lede examples are in references/on-page-seo.md.
Outline as a question map
Build the skeleton from real subtopics, not from what you feel like writing.
- One H1, matching the primary query or its close paraphrase.
- H2/H3 are questions or named subtopics that mirror the SERP's "People also ask", related searches, and the headings competitors share — plus the gaps they all miss (that gap is your edge).
- One idea per heading. A heading that needs an "and" is two headings.
- Headings are subtopics, not slogans:
## How much does a standing desk cost?not## The Price Question.
Why question-shaped headings: only ~38% of pages cited in AI Overviews rank top-10, so clean, extractable, question→answer structure can win citations without traditional authority. Make every section answerable on its own.
Drafting for depth and E-E-A-T
Google does not penalize AI-assisted content as such. It penalizes scaled content abuse — high-volume, no-editorial-review, thin, no-first-hand-experience pages. The March 2026 core update named scaled content abuse a primary target; offending sites saw 50–80% traffic drops. The defense is not avoiding AI; it is genuine value, depth, and human review.
So every draft earns its keep with E-E-A-T (Experience, Expertise, Authoritativeness, Trust — Trust is the load-bearing member):
- First-hand experience — a thing you tested, measured, or saw. "We ran the worm bin for 90