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.