Skill · Workflow
seo-article-from-keyword
Researches the search results, outlines, drafts and then grades the draft against a rubric until it passes. Use when asked to run the "SEO article from a keyword" workflow.
The skill itself. Agents read the name and description first and load the rest only when a task matches.
seo-article-from-keyword/SKILL.md
---
name: seo-article-from-keyword
description: Researches the search results, outlines, drafts and then grades the draft against a rubric until it passes. Use when asked to run the "SEO article from a keyword" workflow.
---
# SEO article from a keyword
Researches the search results, outlines, drafts and then grades the draft against a rubric until it passes.
## Inputs
Ask for any of these that the user hasn't given:
- `keyword` (e.g. "best standing desk for small apartments")
- `audience` (e.g. "renters working from home")
## Steps
Run the steps in order. Refer to saved results by name. Don't skip a step that says STOP.
1. **Manual start** — Start: Start with {{keyword}} and {{audience}}.
2. **Search the top results** — Use web_search: Search for {{keyword}}. Collect the top 8 results: title, headings, angle and what each one misses. Save the result as `serp`.
3. **Outline** — Using {{serp}}, write an outline for {{audience}} that covers the gap the results miss. H2s only, one line each. Save the result as `outline`.
4. **Draft** — Write the article from {{outline}}. 1,200 words, plain language, one table comparing the desks. Save the result as `draft`.
5. **Grade and revise** — Review loop (max 3 passes): Score {{draft}} 1–5 on: answers the query in the first 100 words, original insight, scannable headings, no filler. Revise anything under 4. Stop when every score is 4+. Save the result as `draft`.
6. **Save as Markdown** — Finish: Save {{draft}} with a title tag and meta description to articles/{{keyword}}.md.
## Done when
Every step has run, each approval was given, and you've reported what was produced and where it was saved.