What is build-in-public?

The Build in Public skill automates the transformation of technical coding sessions into engaging social media content. By parsing session transcripts and tracking metrics like commits and bug fixes, it generates platform-optimized posts for Twitter, LinkedIn, and Instagram, helping developers build their personal brand and maintain a consistent online presence with minimal effort.

When should I use build-in-public?

build-in-public is useful in the following scenarios: • Generating a multi-tweet thread on Twitter/X that breaks down a complex feature implementation or a successful debugging session. • Creating professional LinkedIn updates that highlight project milestones, architectural decisions, and technical accomplishments. • Drafting storytelling-focused Instagram captions or BlueSky posts to share the 'behind-the-scenes' progress of a development project. • Extracting session-specific metrics such as files created and bugs fixed to provide data-driven updates for the #BuildingInPublic community. • Repurposing Claude Code session highlights into structured JSON for integration with automated social media scheduling tools.

name	build-in-public
description	Generate social media posts for building in public, coding in public, or dev content creation. Activate when user mentions Twitter, X, BlueSky, LinkedIn, Instagram posts about coding, sharing progress, social media content for developers, or wants to share what they built.
version	1.0.0

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.)

build-in-public

When & Why to Use This Skill

Use Cases