Agent Skills: /blog:post

/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

| Use this skill when... | Use alternative when... | |------------------------|--------------------------| | Capturing work quickly into a blog post | Need detailed documentation -> Project wiki/docs | | Want templates to reduce blank-page anxiety | Writing a technical tutorial -> /blog:post tutorial | | Need git context auto-populated | Creating portfolio summary -> Different workflow |

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

| Context | Command | |---------|---------| | Get project name | git remote get-url origin 2>/dev/null \| sed 's/.*\///' \| sed 's/\.git$//' | | Recent commits | git log --since="7 days ago" --format="%h %s" 2>/dev/null \| head -10 | | Find blog directory | ls -d blog/ posts/ content/blog/ content/posts/ _posts/ 2>/dev/null \| head -1 | | Current date | date +%Y-%m-%d | | Get today's commits | git log --since="1 day ago" --format="- %s" 2>/dev/null |

Quick Reference

| Post Type | Time | Use Case | |-----------|------|----------| | Quick Update | 5-15 min | Small wins, log entries | | Project Update | 20-45 min | Milestone, feature complete | | Retrospective | 45-90 min | Reflection on period/project | | Tutorial | 1-3 hours | Teach how to do something | | Deep Dive | 2-5 hours | Explain complex concepts |