seo-writer

Analyze search intent and map keywords to headings for SEO optimization.

30|4|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Jeffallan/writing-with-agents --skill seo-writer-jeffallan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-writer
Source: https://github.com/Jeffallan/writing-with-agents/tree/main/skills/seo-writer
Command: npx skills add https://github.com/Jeffallan/writing-with-agents --skill seo-writer-jeffallan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

The Skill addresses the common challenge of poorly-optimized SEO, particularly during various phases of writing and editing, which leads to lower search engine rankings and traffic.

Core Features & Use Cases

  • Cross-Cutting SEO Guidance: Augments the Architect, Carpenter, and Judge phases with search optimization best practices.
  • Keyword & Heading Mapping: Automates the mapping of keywords to headings and structuring of the document for search optimization.
  • SEO Validation & Reporting: Validates the on-page SEO elements, flags issues by severity, and presents a structured SEO report.
  • Use Case: For an SEO analyst creating a content strategy for a business blog, the skill can automatically analyze search intent, map keywords to headings, and ensure SEO best practices are followed throughout the writing process.

Quick Start

To perform a comprehensive SEO review on a document, run the seo-writer command on your document 'article.md'.

Frequently Asked Questions about seo-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map keywords to headings for SEO optimization during the writing process?

SEO optimization during the writing process maps keywords to headings by analyzing search intent and structuring the document to align with SERP features. This ensures the content structure directly matches the target search queries.

What is search intent analysis and how does it improve on-page SEO?

Search intent analysis improves on-page SEO by evaluating what users actually want from a query, then configuring metadata and snippet targeting accordingly. It validates SEO elements and flags structural issues by severity.

How do I validate on-page SEO elements and generate a structured report?

To validate on-page SEO elements and generate a structured report, run a comprehensive document review that enforces an SEO checklist. The analysis flags optimization issues by severity and presents the results in a structured format.

Can I apply SEO best practices across multiple phases of document writing and editing?

You can apply SEO best practices across multiple phases of document writing and editing by augmenting the drafting, structuring, and reviewing phases with cross-cutting search optimization guidance and validation.

Do I need prior keyword research to use an SEO optimization workflow for my content?

Prior keyword research is required because the SEO optimization workflow integrates existing keyword data to map terms to headings and configure metadata. You need an understanding of SEO best practices and SERP features.

What are the limitations of automating SEO checklist enforcement for content structure?

Automating SEO checklist enforcement for content structure is limited to on-page validation, keyword mapping, and metadata configuration. It does not replace comprehensive off-page SEO strategies or backlink analysis.