langchain-ai avatar

Blog Post

A structured workflow for writing blog posts that enforces good habits: it requires you to delegate research to a researcher subagent first, then writes the post with a proper hook/context/solution structure, and generates a cover image using detailed prompts before calling it done. The output is always a folder with post.md and hero.png. The opinionated part is that it won't let you skip the research step or forget the cover image, which honestly keeps you from half-finishing drafts. Includes solid prompt engineering examples for cover images with specific guidance on style, composition, and color palettes. Best for technical blogs, tutorials, and thought leadership pieces where you want consistent quality without thinking through the structure every time.

skills.sh installs
2.2K
GitHub stars
31.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add langchain-ai/deepagents --skill blog-post --agent claude-code

Installs into .claude/skills of the current project.

Files

Blog Post Writing Skill

Research First (Required)

Before writing any blog post, you MUST delegate research:

  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"
)

Example:

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)

Every blog post MUST have both a post AND a cover image:

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

Example: A post about "AI Agents in 2025" → blogs/ai-agents-2025/

You MUST complete both steps:

  1. Write the post to blogs/<slug>/post.md
  2. Generate a cover image using generate_image and save to blogs/<slug>/hero.png

A blog post is NOT complete without its cover image.

Blog Post Structure

Every blog post should follow this structure:

Sponsors

Details

Repository
github.com/langchain-ai/deepagents
Categories
Documentation, AI & Agent Building, Marketing & SEO
First seen
Apr 16, 2026

More from langchain-ai/deepagents

All 12
1metabase avatardocs-reviewmetabase/metabaseReview documentation changes for compliance with the Metabase writing style guide. Use when reviewing pull requests, files, or diffs containing documentation ma2Kskills.sh installs
2bytedance avatarcode-documentationbytedance/deer-flowUse this skill when the user requests to generate, create, or improve documentation for code, APIs, libraries, repositories, or software projects. Supports READ1.9Kskills.sh installs
3mcollina avatardocumentationmcollina/skillsCreates, structures, and reviews technical documentation following the Diátaxis framework (tutorials, how-to guides, reference, and explanation pages). Use when1.9Kskills.sh installs
4nvidia avatarnemo-rl-docsnvidia/skillsDocumentation conventions for NeMo-RL. Covers docs/index.md updates and docstring format. Do NOT use for: bug fixes, test fixes, dependency bumps, refactoring, 1.8Kskills.sh installs
5pika-labs avatarexplainerpika-labs/pika-pluginsUse when the user asks for explainer or a task matching the examples below. ~60-80s explainer video for any URL — GitHub repo, product page, docs site, blog pos1.7Kskills.sh installs
6botpress avataradk-docsbotpress/skillsguidelines for creating, reviewing, updating, and searching ADK documentation - use when users ask about writing, maintaining, or auditing ADK bot docs1.6Kskills.sh installs