Blog Post Writing Skill

When to Use This Skill

• Write a blog post or article
• Create a tutorial or how-to guide
• Develop educational long-form content
• Write thought leadership pieces

Research First (Required)

1. Use the

   task

   tool with

   subagent_type: "researcher"

2. In the description, specify BOTH the topic AND where to save:

task(
    subagent_type="researcher",
    description="Research [TOPIC]. Save findings to research/[slug].md"
)

task(
    subagent_type="researcher",
    description="Research the current state of AI agents in 2025. Save findings to research/ai-agents-2025.md"
)

1. After research completes, read the findings file before writing

Output Structure (Required)

blogs/
└── <slug>/
    ├── post.md        # The blog post content
    └── hero.png       # REQUIRED: Generated cover image

blogs/ai-agents-2025/

1. Write the post to

   blogs/<slug>/post.md

2. Generate a cover image using

   generate_image

   and save to

   blogs/<slug>/hero.png

Blog Post Structure

1. Hook (Opening)

• Start with a compelling question, statistic, or statement
• Make the reader want to continue
• Keep it to 2-3 sentences

2. Context (The Problem)

• Explain why this topic matters
• Describe the problem or opportunity
• Connect to the reader's experience

3. Main Content (The Solution)

• Break into 3-5 main sections with H2 headers
• Each section covers one key point
• Include code examples, diagrams, or screenshots where helpful
• Use bullet points for lists

4. Practical Application

• Show how to apply the concepts
• Include step-by-step instructions if applicable
• Provide code snippets or templates

5. Conclusion & CTA

• Summarize key takeaways (3 bullets max)
• End with a clear call-to-action
• Link to related resources

Cover Image Generation

generate_cover

generate_cover(prompt="A detailed description of the image...", slug="your-blog-slug")

blogs/<slug>/hero.png

Writing Effective Image Prompts

1. Subject: What is the main focus? Be specific and concrete.
2. Style: Art direction (minimalist, isometric, flat design, 3D render, watercolor, etc.)
3. Composition: How elements are arranged (centered, rule of thirds, symmetrical)
4. Color palette: Specific colors or mood (warm earth tones, cool blues and purples, high contrast)
5. Lighting/Atmosphere: Soft diffused light, dramatic shadows, golden hour, neon glow
6. Technical details: Aspect ratio considerations, negative space for text overlay

Example Prompts

Isometric 3D illustration of interconnected glowing cubes representing AI agents, each cube has subtle circuit patterns. Cubes connected by luminous data streams. Deep navy background (#0a192f) with electric blue (#64ffda) and soft purple (#c792ea) accents. Clean minimal style, lots of negative space at top for title. Professional tech aesthetic.

Clean flat illustration of hands typing on a keyboard with abstract code symbols floating upward, transforming into lightbulbs and gears. Warm gradient background from soft coral to light peach. Friendly, approachable style. Centered composition with space for text overlay.

Abstract visualization of a human silhouette profile merging with geometric neural network patterns. Split composition - organic watercolor texture on left transitioning to clean vector lines on right. Muted sage green and warm terracotta color scheme. Contemplative, forward-thinking mood.

SEO Considerations

• Include the main keyword in the title and first paragraph
• Use the keyword naturally 3-5 times throughout
• Keep the title under 60 characters
• Write a meta description (150-160 characters)

Quality Checklist

• Post saved to

  blogs/<slug>/post.md

• Hero image generated at

  blogs/<slug>/hero.png

• Hook grabs attention in first 2 sentences
• Each section has a clear purpose
• Conclusion summarizes key points
• CTA tells reader what to do next