Skip to main content
skill CX Codex

create-blog-post — Claude Code skill: what it does, install

create-blog-post turns a Google Docs Markdown draft into a Home Assistant blog post and can create crossposts that send readers to an article on another site.

CC-BY-SA-4.0 1 installs ★ 10,221 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add home-assistant/home-assistant.io --skill create-blog-post -a claude-code
Open on GitHub

What create-blog-post does

The skill reads a Markdown draft from create-blog-post/, pulls out the title, author, date, category, and Social/OpenGraph fields, then writes a Jekyll-front-matter post under source/_posts/. It also removes preparation notes, changes the read-more marker to <!--more-->, and formats links for the Home Assistant site.

The art.* file becomes the hero and OpenGraph image. Optional image2.*, image3.*, and later files are processed as additional images. Image conversion uses cwebp; external links are changed to HTML links that open in a new tab, while internal Home Assistant links stay in Markdown.

Put a Markdown draft and the required art.* image in create-blog-post/ before running it. Without art.*, the skill cannot prepare the hero image; image conversion also depends on cwebp being available.

What it helps with

  • convert a Google Docs Markdown draft into a Home Assistant post
  • extract metadata and build Jekyll front matter
  • turn hero and extra images into WebP files
  • replace the read-more marker with <!--more-->
  • format external links to open in a new tab

Example prompts for the agent

  • Convert create-blog-post/draft.md into a Home Assistant blog post.
  • Create a crosspost that redirects readers to the article hosted on another site.
  • Run /create-blog-post and process art.* together with image2.*.

How to install create-blog-post

1Skills CLI (Vercel)

npx skills add home-assistant/home-assistant.io --skill create-blog-post -a claude-code

2Manually: put the files in place

~/.claude/skills/create-blog-post/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/create-blog-post/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about create-blog-post

How do I install create-blog-post in Claude Code?

Run npx skills add home-assistant/home-assistant.io --skill create-blog-post -a claude-code, then use ~/.claude/skills/create-blog-post/SKILL.md.

What does create-blog-post do?

It turns a Markdown draft into a formatted Home Assistant blog post, handling metadata, images, links, and Jekyll front matter before writing the result to source/_posts/.

What files does create-blog-post need?

Place a Markdown draft and an art.* hero/OpenGraph image in create-blog-post/. Extra images such as image2.* are optional, and image conversion requires cwebp.

Similar skills

All skills for Writing and docs →

More in the catalog

Project sponsors

Companies that keep this analytics open