> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shipstar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Write a blog post

> Claude Code skill that brainstorms blog angles from your commits, generates a draft with Shipstar, revises it with you, and publishes to your blog.

`/shipstar:write-blog-post` turns shipped work into a published article:
brainstorm angles from the commits, generate a draft in your project's
voice, revise together, publish when you say so.

## Install

Via the official Claude Code plugin (bundles the MCP connection):

```
/plugin marketplace add shipstar-ai/shipstar-plugin
/plugin install shipstar@shipstar
```

Or install the skills standalone from your dashboard's Agents page
(`curl -fsSL <APP_URL>/agent-skills/install.sh | sh -s -- <APP_URL>`).

## When to use it

Say "write a blog post about what we've been building", "dev-blog entry for
this month's work", or name the exact angle you want covered.

## What the agent does

1. Calls [`generate_blog_post_ideas`](/mcp/generation/generate-blog-post-ideas)
   for the commit window and lets you pick an angle (or takes the one you
   stated).
2. Generates with [`generate_blog_post`](/mcp/generation/generate-blog-post),
   choosing `blog_options` with you — short vs long, SEO mode with a target
   keyword, single-feature deep-dive vs multi-feature roundup — plus any
   audience or scope guidance.
3. Polls [`get_generation_status`](/mcp/lifecycle/get-generation-status),
   shows you the draft, and iterates with
   [`update_content`](/mcp/lifecycle/update-content) until it reads right.
4. Publishes to your blog destination **only on your explicit confirmation**
   via [`approve_content`](/mcp/lifecycle/approve-content) /
   [`publish_content`](/mcp/lifecycle/publish-content).

## Requirements

* Shipstar MCP server connected (see [Set up Shipstar](/mcp/skills/setup-shipstar))
* GitHub connected with at least one tracked repository

The full skill definition is plain markdown:
[`SKILL.md`](https://app.shipstar.ai/agent-skills/write-blog-post/SKILL.md).