Blog Writing Mastery

The ultimate skill for creating blog content that sounds human, ranks organically, and converts readers.

Quick Reference

This skill combines 5 specialized skills. Read them for deep knowledge:

The Blog Writing Workflow

Phase 1: Research & Planning

Phase 2: Writing

Phase 3: Optimization

Phase 4: Final Review

Phase 5: Cover Image Generation

Generate a cover image using the generate_image tool.

Prompt Template:

Modern, professional blog cover image for: "[BLOG_TITLE]"
Style: Clean, minimalist, abstract illustration
Theme: [KEY_VISUAL_THEME]
Colors: Vibrant gradients (avoid purple), blues, teals, oranges
No text overlay. High quality, 16:9 aspect ratio.

Execution:

1. •Use the generate_image tool with the above prompt
2. •Save image to public/blog-covers/[slug].webp
3. •If image generation limit is exceeded, provide the prompt to the user

Fallback Prompt (when limit exceeded):

🎨 Cover Image Prompt (generate manually):
---
Title: [BLOG_TITLE]
Prompt: [FULL_PROMPT_FROM_TEMPLATE_ABOVE]
Suggested size: 1200x630px (16:9)
Save to: public/blog-covers/[slug].webp
---

Phase 6: Draft to Database

Blog Data File: scripts/blog_data.js Seed Script: scripts/seed_blogs.js

Step 1: Add blog entry to blog_data.js

{
    "title": "[BLOG_TITLE]",
    "slug": "[url-safe-slug]",
    "excerpt": "[150-char compelling excerpt]",
    "content": "[FULL_MARKDOWN_CONTENT]",
    "coverImage": "/blog-covers/[slug].webp"  // Local path or assets URL
}

Step 2: Run seed script

node scripts/seed_blogs.js

Step 3: Verify

• •Blog appears in database as draft
• •Cover image loads correctly

Execution Checklist

Use this checklist when writing a new blog:

Blog Creation

• • Research — Target keyword + intent identified
• • Outline — H1 + H2s + key points drafted
• • Write — Apply organic voice + hook + structure
• • Links — 3 max, paragraph text only
• • Anti-AI — Run banned phrases check
• • Quality — Score 32+/40 on rubric

Cover Image

• • Generate — Use generate_image tool
• • Fallback — If limit hit, provide prompt to user
• • Save — To public/blog-covers/[slug].webp

Database

• • Add entry — Update scripts/blog_data.js
• • Seed — Run node scripts/seed_blogs.js
• • Verify — Blog appears as draft

Anti-AI Checklist

Run this before EVERY publish:

Banned Phrases (Search & Remove)

• • "In today's [digital/fast-paced] world"
• • "Furthermore", "Moreover", "Additionally"
• • "It's worth noting", "Needless to say"
• • "In conclusion", "To sum up"
• • "Let's dive in", "Without further ado"
• • "Leverage", "Utilize", "Optimize" (use simpler words)

Human Signals (Must Have)

• • At least 3 uses of "I" (personal experience)
• • At least 5 uses of "you" (direct address)
• • Contractions used naturally (don't, you'll, it's)
• • At least 1 specific, personal example or anecdote
• • At least 1 opinion/stance (not just neutral facts)
• • Sentence length varies (short + medium + long)
• • At least 1 fragment for emphasis

The Friend Test

Read the intro aloud. Would you say this to a friend over coffee? If no → Rewrite until yes.

Linking Strategy

Rules

Link Placement

Anchor Text

Quality Rubric

Score each element 1-5, target: 35+ total

Minimum passing: 32/40 (80%)

Markify Brand Voice Guide

Tone

Voice Examples

Key Messages

Content Templates

Template: How-To Post

# How to [Achieve Specific Outcome]

[Hook: 2-sentence pain point or question]

[Promise: What they'll learn/achieve]

## Why [Topic] Matters
[Brief context, connect to their pain]

## Step 1: [Action]
[Explanation + screenshot/example]

## Step 2: [Action]
[Explanation + screenshot/example]

## Step 3: [Action]
[Explanation + screenshot/example]

## Pro Tips
- Tip 1
- Tip 2

## Wrapping Up
[1-2 sentence summary]

[CTA: Try Markify / Related post]

## FAQ
### Q1?
A1.
### Q2?
A2.

Template: Comparison Post

# [Product A] vs [Product B]: Which Is Better in 2025?

[Hook: "Choosing between X and Y? Here's what you need to know."]

## Quick Verdict
[Winner + 1-sentence reason for readers in a hurry]

## Overview
| Feature | [Product A] | [Product B] |
|---------|-------------|-------------|
| ... | ... | ... |

## [Comparison Point 1]
[Analysis]

## [Comparison Point 2]
[Analysis]

## [Comparison Point 3]
[Analysis]

## Who Should Use [Product A]?
[Ideal user profile]

## Who Should Use [Product B]?
[Ideal user profile]

## Final Verdict
[Recommendation + CTA]

Common Mistakes

Remember: The best blog post is one that helps the reader AND sounds like it came from a real person who cares about them.