AgentSkillsCN

BlogWriter

撰写并发布博客文章至 yourdomain.com。当出现“写一篇博客文章”、“写博客”、“发布博客”、“把这项工作写成博客”、“把这件事变成博客文章”或“起草一篇帖子”时使用。分析工作背景,生成带有主图的 Docusaurus MDX 文章,并部署到 GitHub Pages。

SKILL.md
--- frontmatter
name: BlogWriter
description: Write and publish blog posts to yourdomain.com. USE WHEN "write a blog post" OR "blog about" OR "publish blog" OR "blog this work" OR "turn this into a blog post" OR "draft a post". Analyzes work context, generates Docusaurus MDX posts with hero images, deploys to GitHub Pages.

BlogWriter

General-purpose blog writing skill for yourdomain.com. Can generate posts from scratch on any topic, or analyze recent git work in the current repo to turn engineering achievements into polished narrative posts. Handles the full pipeline: research, writing, hero image generation, build verification, deployment, and live-site confirmation.

Workflow Routing

WorkflowTriggerFile
WriteFromTopic"write a blog post about X", "blog about X"Workflows/WriteFromTopic.md
WriteFromWork"blog this", "blog this work", "turn this into a post"Workflows/WriteFromWork.md
Publish"publish the blog post", "push the post live"Workflows/Publish.md

IMPORTANT: WriteFromTopic and WriteFromWork automatically chain into Publish. The full pipeline runs end-to-end autonomously — do NOT pause between workflows. Publish can also be invoked standalone for a pre-written post.

Examples

Example 1: Blog about a topic

code
User: "Write a blog post about how we built our FHIR integration"
→ Invokes WriteFromTopic workflow
→ Researches the topic (reads code, docs, web if needed)
→ Drafts post in Jon's voice, generates hero image
→ Asks user to review before publishing

Example 2: Turn recent work into a post

code
User: "Blog this" (from inside a repo after building a feature)
→ Invokes WriteFromWork workflow
→ Analyzes recent git commits and changed files
→ Extracts the narrative: problem → insight → solution → results
→ Drafts post, generates hero image, asks for review

Example 3: Publish a drafted post

code
User: "Publish the blog post"
→ Invokes Publish workflow
→ Writes post to remote blog repo via SSH
→ Generates/places hero image, runs build test
→ Commits, pushes, verifies live site

Quick Reference

SettingValue
Blog repo (remote server)~/Documents/git/jon/your-org/your-blog-repo
SSH hostyour-dev-server
Post formatDocusaurus .mdx
Post directoryblog/YYYY-MM-DD-slug/index.mdx
Image directorystatic/img/blog/YYYY-MM-DD-slug/
Author[jon]
Site URLhttps://yourdomain.com/blog/<slug>
Image format.jpg only (homepage hardcodes this)