Build in Public - Social Media Post Generator Skill

Build in Public - Social Media Post Generator

This skill helps developers create engaging social media content from their Claude Code sessions for the #BuildingInPublic and #CodingInPublic communities.

Capabilities

Parse Claude Code session transcripts to extract highlights
Generate platform-appropriate posts for:
- Twitter/X: Short posts (280 chars) and threads
- BlueSky: Short posts (300 chars)
- LinkedIn: Medium-length professional updates
- Instagram: Long-form captions with hashtags
- Mastodon: Medium posts with hashtags
Track session metrics (files created, commits, bugs fixed, etc.)
Output both markdown (human-readable) and JSON (for automation)

When to Activate

Activate this skill when the user:

Asks to create social media posts about their coding
Mentions "building in public" or "coding in public"
Wants to share their progress on Twitter, X, BlueSky, LinkedIn, or Instagram
Asks for a session summary to share
Mentions #BuildingInPublic or similar hashtags
Says things like "I want to tweet about this" or "post this to social media"

Commands Available

/build-in-public:generate - Generate posts from the current session
/build-in-public:preview - Preview session activity before generating

How to Generate Posts

When the user wants to create social media content:

Preview first (optional): Run /build-in-public:preview to show them what happened in the session

Generate posts: Run the generation script:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/generate_posts.py" --output . --json

Present the best options: Show the user 1-2 ready-to-post short posts and mention the full file has more options
Offer customization: Ask if they want to emphasize certain aspects or add custom context

Post Formats

Short Posts (Twitter/X, BlueSky)

Max 280 characters
Include 1-2 relevant hashtags
Focus on one key accomplishment
Use emojis sparingly but effectively

Threads (Twitter/X)

4-6 tweets
Start with a hook
End with engagement question
Each tweet under 280 chars

Medium Posts (LinkedIn)

500-700 characters
Professional tone
Bullet points for accomplishments
Include relevant hashtags at the end

Long Form (Instagram)

1000+ characters
Storytelling format
Multiple hashtags (up to 30)
Include call-to-action

Output Files

The generator creates:

build-in-public_[timestamp].md - Human-readable posts with all options
build-in-public_[timestamp].json - Structured data for automation tools

Integration with Publishing Tools

The JSON output can be consumed by automation tools to publish posts. The structure:

{
  "summary": {
    "session_id": "...",
    "project_name": "...",
    "files_created": [...],
    "git_commits": [...],
    ...
  },
  "posts": {
    "short": ["post1", "post2"],
    "thread": ["tweet1", "tweet2", ...],
    "medium": ["linkedin post"],
    "long": ["instagram caption"],
    "hashtags": ["#BuildingInPublic", ...]
  }
}

Tips for Great #BuildingInPublic Content

Be specific: "Added user authentication" beats "worked on the app"
Show numbers: "Fixed 3 bugs, created 5 files" is more engaging
Include the struggle: Bugs fixed = relatable content
End with engagement: "What are you building?" invites responses
Use relevant hashtags: Match the tech stack (#Python, #React, etc.)

Agent Skills: Build in Public - Social Media Post Generator

Skill Files