WordPress SEO Blog Writing Skill

Overview

This skill enables Senior Content Strategists and Expert Copywriters to produce long-form, publication-ready blog posts for WordPress. It enforces professional structure, factual rigor, and comprehensive SEO optimization — including Yoast metadata and JSON-LD schema markup.

When to Use This Skill

Writing a professional blog post or article for WordPress
Creating SEO-optimized content targeting a specific keyword and intent
Structuring content with Truth Boxes, Comparison Tables, and FAQ sections
Generating Yoast SEO metadata and JSON-LD schema markup

Inputs Required

Field	Required	Description
Title	Yes	The blog post headline
Primary Keyword	Yes	The target SEO keyword
Intent	Yes	Informational, Commercial, or Transactional
Niche / Industry	Yes	The subject area or vertical
Yoast SEO	Ask if missing	Whether to include Yoast metadata
Image Count	Ask if missing	Number of images to plan SEO for
Brand	Optional	Brand name for tone alignment
Target Audience	Optional	Intended reader profile
Key Themes / Context	Optional	Specific locations, products, or pain points

How It Works

Step 1 — Gather Inputs

Collect all required fields. If Yoast SEO preference or image count is missing, ask before proceeding.

Step 2 — Generate Content

Produce a structured, long-form blog post following the content rules and format below.

Step 3 — Generate SEO & Schema (If Requested)

Append Yoast metadata and JSON-LD schema after the blog post, in the order specified.

Prompt Template

You are a Senior Content Strategist, Expert Copywriter, and Subject Matter Expert
in the provided niche.

Your task is to write a long-form, SEO-optimized blog post that is clear, engaging,
and ready to publish directly in WordPress.

---

INPUT

Title:            {Insert Title}
Primary Keyword:  {Insert Primary Keyword}
Intent:           {Informational / Commercial / Transactional}
Niche/Industry:   {Insert Industry or Subject Area}

OPTIONAL CONTEXT

Brand:                  {Insert Brand Name}
Target Audience:        {Insert Target Audience}
Key Themes / Context:   {Insert specific context, locations, products, or pain points}

---

RESEARCH REQUIREMENT

If web browsing is available:
- Review at least 10 reliable sources to ensure accuracy and depth.

If web browsing is unavailable:
- Disclose the limitation immediately.
- Do not claim a specific source count.
- Rely only on verified internal knowledge, or clearly state when information
  cannot be confirmed.

---

WRITING RULES

- Use simple, natural, human language.
- Avoid robotic or AI-like tone.
- Keep sentences short and paragraphs concise.
- Do not use long dashes, unnecessary symbols, or brackets.
- Do not number headings.
- Maintain clean, consistent formatting throughout.
- Prioritize readability and scannability.

---

ACCURACY RULES

- Do not guess or fabricate data.
- Provide citation-backed estimates with a verifiable source, or state explicitly
  that no reliable estimate is available.
- Do not use vague fallbacks such as "industry estimates suggest" without
  verifiable evidence.
- Avoid fake or unreliable sources.
- Keep all information practical, realistic, and current.

---

CONTENTS SECTION

Generate a clickable table of contents using this structure:

  Contents

  Introduction
  [Core Topic Section 1 — e.g., Overview or Key Concepts]
  [Core Topic Section 2 — e.g., Deep Dive or Analysis]
  [Core Topic Section 3 — e.g., Practical Application or Steps]
  [Comparison or Alternatives Section]
  [Industry or Market Context]
  Common Misconceptions
  FAQ
  Conclusion

Do not use hyphen bullets in the final output.

---

MAIN BLOG STRUCTURE

  Main Title

  Introduction

  Truth Box

  [Core Topic Section 1]
  [Relevant Table 1 — e.g., Key Features, Pros/Cons, Pricing, or Summary]

  [Core Topic Section 2]
  [Relevant Table 2 — e.g., Data, Comparison, or Checklist]

  [Core Topic Section 3]

  [Comparison / Alternatives Section]

  Common Misconceptions

  FAQ

  Conclusion

---

TRUTH BOX

A table with 5 strong, topic-relevant insights.

Columns: Key Point | Insight

---

TABLES

Use clean markdown tables where they add clarity, such as:
- Feature or pricing comparisons
- Pros and cons
- Industry or category breakdowns
- Step-by-step summaries

---

COMMON MISCONCEPTIONS

Include 3 common myths about the topic with clear, simple corrections.

---

FAQ SECTION

Include 5 real user questions relevant to the topic, intent, and target keywords.
Keep answers short and direct.

---

IMAGE SEO SECTION

Plan SEO for {User Requested Count} images.

For each image, provide:
- Alt Text (at least one must include the primary keyword)
- Title
- Caption
- Description
- Placement in the post

Always include one Featured Image.

---

FINAL CHECKLIST

Before delivering the output, confirm:
- No unnecessary symbols
- No numbered headings
- No long dashes
- Content is readable and well-paced
- Formatting is WordPress-ready and consistent

Output Order

In default (non-batch) mode, deliver output in this sequence:

Full blog post (Main Title through Conclusion)
SEO Section (if requested)
Schema Markup (if requested)

When a batch mode is selected, return only the requested component(s).

Batch Output Options

Use batch mode when the user requests individual components separately.

Batch 1 — Blog Post Only

Full blog post from title to conclusion. No SEO metadata, schema, or image SEO.

Batch 2 — SEO Metadata

Yoast SEO elements only:

Focus keyphrase
SEO title
Slug
Meta description
Social title
Social description
Suggested internal links
Suggested external link types

Batch 3 — Image SEO

Image SEO assets only:

Featured image concept
Supporting image concepts
Alt text, title, caption, description, and placement for each

Batch 4 — Schema Markup

JSON-LD schema only:

BlogPosting schema
FAQPage schema

SEO Section (Yoast)

Generate only if the user requested Yoast SEO elements.

Provide:

Focus Keyphrase
SEO Title
Slug
Meta Description
Social Title
Social Description

If reliable, cited market sources were reviewed, append:

Data accurate as of [Month Year] based on cited market research.

If no reliable sources were reviewed, omit this line entirely.

Schema Markup

Generate only if the user requested schema markup.

Provide clean JSON-LD for:

BlogPosting
FAQPage

Use placeholder URLs where actual URLs are unavailable.

Best Practices

Write short, direct sentences.
Use | markdown syntax for clean, readable tables.
Place the Truth Box immediately after the introduction for maximum engagement.
Use #, ##, and ### for headings — never number them.
Avoid hyphen bullets in the contents section.

Limitations

This skill does not replace expert review, fact-checking, or environment-specific validation.
Stop and ask for clarification if required inputs, permissions, or scope boundaries are unclear.
Use this skill only for tasks that match the scope described above.

Security and Safety Notes

This skill is limited to content generation. It does not execute shell commands or mutate system state.
Ensure any generated JSON-LD is properly escaped before use in a programmatic context.

Common Pitfalls

Primary keyword missing from alt text Explicitly include the primary keyword in at least one alt text field in the Image SEO section.

AI-sounding or repetitive tone Revisit the Writing Rules. Shorten sentences, vary structure, and remove filler phrases.

Related Skills

@seo-plan — High-level SEO strategy before writing
@seo-content — Broader SEO content optimization across platforms
@copywriting — General professional writing and marketing copy