✍️ seo-blog-writer
SEO blog posts that rank: intent research, outline, meta tags, FAQ and schema. A free, open-source Agent Skill for Claude Code, Cline, Cursor, Codex and 75+ AI agents.
Install seo-blog-writer
# Claude Code (all 51 skills)
/plugin install all-skills --marketplace milad-ahmd/agent-skills
# Cursor, Codex, Cline, Windsurf, Copilot + 75 more agents
npx skills add milad-ahmd/agent-skills --skill seo-blog-writer
# Shell installer
curl -fsSL https://raw.githubusercontent.com/milad-ahmd/agent-skills/main/install.sh | bash -s -- seo-blog-writerIncluded in packs: indie-hacker-pack, marketer-pack
What to say to your agent
Write an SEO article for 'best budgeting apps'Outline a blog post that ranks for X
When it triggers
Researches and writes SEO-optimized, genuinely helpful blog articles, covering keyword and search-intent analysis, competitor outline gaps, title and meta description, headings, FAQ, internal links, and schema, in the brand's voice and following Google's helpful-content and E-E-A-T principles. Use when the user asks to write a blog post or article, do SEO content, or rank for a keyword.
Full skill instructions (SKILL.md)
SEO Blog Writer
Content that ranks because it is the most helpful answer to the search.
1. Research
- Primary keyword + intent: informational, commercial, transactional or navigational. Match the format that is already ranking (guide, listicle, comparison, tutorial).
- Analyse the top results (with a search or browser tool if available, otherwise from the user's input): their headings, depth, angle, and gaps they miss.
- Collect secondary keywords, related questions (People Also Ask) and entities.
- E-E-A-T: ask for first-hand experience, data, examples, author credentials and screenshots that only this brand can provide.
2. Brief and outline (get approval before writing)
Title (≤ 60 chars, keyword early) ×3 options
Meta description (≤ 155 chars, benefit + keyword) ×2
URL slug: /short-keyword-slug
H1 → H2/H3 outline with intent of each section and target word count
Unique angle / information gain: what we add that others don't
3. Write
- Answer the query in the first 100 words, then go deeper.
- Short paragraphs, descriptive headings, lists, tables and examples. Write at an 8th–10th grade reading level.
- Use keywords naturally, never stuffed. Cover the topic completely.
- Add an FAQ section built from real questions, 3–5 internal link suggestions and 2–3 authoritative external sources.
- Suggest images with alt text, and FAQ or Article JSON-LD schema.
- End with a clear CTA that matches the search intent.
4. Optimise
A checklist covering: the keyword in the title, H1, intro, one H2, the slug and the meta description; images compressed with alt text; internal links; scannability; and a freshness date.
Rules
- No invented statistics, quotes or sources. Mark anything uncertain
[VERIFY]and cite real sources. - No AI filler phrases ("In today's digital landscape", "delve", "it's important to note").
- Write in the brand's voice. Ask for samples.
- Output Markdown, ready for the user's CMS (WordPress, Ghost, Webflow, MDX).
View source on GitHub ⭐ Star the collection
Related skills
📣 ad-copy-generator
Ad copy for Meta, TikTok, Google and YouTube within each platform's limits, plus an A/B test matrix
🎨 brand-voice-guide
A brand voice, positioning and personas guide, then rewrites copy on-brand
🕵️ competitor-spy
Competitor analysis of pricing, messaging, socials, ads and reviews, with a SWOT and opportunities
♻️ content-repurposer
One video or podcast into 15+ posts: Shorts, Reels, threads, LinkedIn, carousel, newsletter
📧 email-campaign-writer
Welcome, launch, cart and newsletter email sequences with subject-line tests
🪝 hook-generator
Scroll-stopping hooks for videos, posts, emails and ads, scored and ranked