create-blog-post

Convert Google Docs Markdown drafts into Jekyll-ready Home Assistant blog posts.

9.7k|8.4k|Updated Dec 21, 2014
One-click install
npx skills add https://github.com/home-assistant/home-assistant.io --skill create-blog-post
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-blog-post
Source: https://github.com/home-assistant/home-assistant.io/tree/main/.claude/skills/create-blog-post
Command: npx skills add https://github.com/home-assistant/home-assistant.io --skill create-blog-post

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill converts a draft blog post Markdown file from Google Docs into a production-ready Home Assistant blog post.

Core Features & Use Cases

  • Metadata extraction and standardization (title, author, publish date, category)
  • Content transformation into Jekyll-ready format with proper front matter and layout
  • Hero and additional image handling, external link adjustments, and content cleanup

Quick Start

Place your draft blog post markdown in the create-blog-post/ directory, then run: /create-blog-post

Frequently Asked Questions about create-blog-post

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a Google Docs draft into a Jekyll blog post for Home Assistant?

The skill standardizes blog post metadata by extracting the title, author, publish date, and category from your draft Markdown file, then formats them into proper Jekyll front matter for home-assistant.io publication.

What image files do I need to prepare for a Home Assistant blog post conversion?

You need a hero image named art.webp, plus optional image2.png and image3.png files. The skill converts the additional PNG images to WebP format and places all media under source/images/blog/YYYY-MM-slug.

Does the Home Assistant blog post converter require any specific dependencies?

No specific dependencies are required to run the converter. You only need to provide the draft Markdown file and the required hero image in the correct directory to generate the Jekyll-ready output.

Can I publish content directly to home-assistant.io from Google Docs markdown?

Yes, you can prepare content from Google Docs for home-assistant.io by supplying the exported draft Markdown. The skill performs content cleanup and external link adjustments to make it production-ready.

What are the limitations when formatting markdown for the Home Assistant blog?

The conversion requires a strict file structure: a draft Markdown file in create-blog-post/ and a mandatory art.webp hero image. Content outside this specified directory structure or missing the hero image will not process correctly.