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
npx skills add home-assistant/home-assistant.io --skill create-blog-post -a claude-codeWhat 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.mdinto a Home Assistant blog post. - Create a crosspost that redirects readers to the article hosted on another site.
- Run
/create-blog-postand processart.*together withimage2.*.
How to install create-blog-post
1Skills CLI (Vercel)
npx skills add home-assistant/home-assistant.io --skill create-blog-post -a claude-code2Manually: put the files in place
~/.claude/skills/create-blog-post/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/create-blog-post/
1Skills CLI (Vercel)
npx skills add home-assistant/home-assistant.io --skill create-blog-post -a codex2Manually: put the files in place
.agents/skills/create-blog-post/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add home-assistant/home-assistant.io --skill create-blog-post -a cursor2Manually: put the files in place
.cursor/skills/create-blog-post/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install home-assistant/home-assistant.io .claude/skills/create-blog-post2Manually: put the files in place
.github/skills/create-blog-post/SKILL.md1Skills CLI (Vercel)
npx skills add home-assistant/home-assistant.io --skill create-blog-post -a gemini-cli2Platform CLI
gemini skills install https://github.com/home-assistant/home-assistant.io --path .claude/skills/create-blog-postManually: put the files in place
.devin/skills/create-blog-post/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add home-assistant/home-assistant.io --skill create-blog-post -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.