--- name: wordpress-centric-high-seo-optimized-blogwriting-skill description: "Generate clean, human-sounding, SEO-optimized WordPress blog posts with optional Yoast metadata, JSON-LD schema markup, and image SEO planning. Supports modular batch output." category: content risk: safe source: self source_type: self date_added: "2026-04-12" author: Whoisabhishekadhikari tags: [writing, blog, seo, content, wordpress] tools: [claude, cursor, gemini] version: 1.1.0 --- # 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 ```text 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 that describes the actual image; include the keyword only when it naturally describes visible content - 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** Describe the actual image. Use empty alt text for purely decorative images; do not force a keyword into unrelated images. **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 A source quota does not establish accuracy: cite sources supporting each material claim and disclose unresolved conflicts. Placeholder URLs must be replaced before publication. FAQPage markup can describe visible FAQs but Google FAQ rich results are restricted to eligible authoritative government/health sites; schema validity does not promise search display. Content generation does not authorize WordPress publication.