FrancoStino/wordpress-centric-high-seo-optimized-blogwriting-skill

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:

1. Full blog post (Main Title through Conclusion)
2. SEO Section (if requested)
3. 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