/blog:post

Create a blog post about your work with minimal friction. Gathers context automatically and provides structured templates to reduce blank-page anxiety.

When to Use This Skill

Context

• Blog directory: !find . -maxdepth 1 -type d \( -name blog -o -name posts -o -name _posts \) -print -quit
• Git remotes: !git remote -v
• Recent commits: !git rev-list --count --since="7 days ago" HEAD
• Current branch: !git branch --show-current

Parameters

Parse $ARGUMENTS for:

• type: Post type (quick-update, project-update, retrospective, tutorial, deep-dive)
  • If not provided, ask user to select
• --project <name>: Specify project name (default: detected from git)
• --title <title>: Specify post title (default: ask user)
• --edit: Open in editor after creation (default: show filepath)

Execution

Execute this blog post creation workflow:

Step 1: Gather context

Detect project name and recent git history:

1. Use git log to get recent commits
2. Extract project name from git remote or directory
3. If blog directory doesn't exist, ask where to save posts

Step 2: Determine post type

If type argument not provided, ask user to select from five options:

• Quick Update (5-15 min)
• Project Update (20-45 min)
• Retrospective (45-90 min)
• Tutorial (1-3 hours)
• Deep Dive (2-5 hours)

Step 3: Ask targeted questions based on post type

For each type, ask 1-2 focused questions:

• Quick Update: "What did you just do?"
• Project Update: "Main accomplishment?" and "What was interesting?"
• Retrospective: "What period/project?" and "One thing to remember?"
• Tutorial: "What are you teaching?" and "Why document this?"
• Deep Dive: "What topic?" and "Key insight to share?"

Step 4: Generate post file

1. Determine where to save (blog directory, ~/blog/, or custom path)
2. Generate filename: YYYY-MM-DD-<slugified-title>.md
3. Create file with frontmatter:
   • date: Today
   • project: Detected or specified
   • type: Selected type
   • status: draft
4. Pre-fill content sections with placeholders and git context as comments

Step 5: Offer writing assistance

Ask what user would like to do:

• "Help me write it" → Walk through each section interactively
• "I'll write it myself" → Show filepath
• "Add more context" → Pull more git history and files for reference

Step 6: Finalize post

1. Present review checklist (title, content, tags, next steps)
2. Ask: "Is this post ready to publish?" (draft or published)
3. Output summary with file path and quick actions

Agentic Optimizations

Quick Reference