social-publishing

Social Publishing

Agent-first social media publishing via SocialClaw. One workspace API key, 13 platforms, zero per-platform OAuth setup.

When to Use This Skill

Use this skill when the user wants to:

• Publish or schedule posts across multiple social media platforms
• Orchestrate a multi-platform content campaign
• Upload and attach media to social posts
• Retrieve post-level engagement analytics
• Manage a content calendar programmatically

Supported Platforms

Platform	Notes
X (Twitter)	Profile posts, threads
LinkedIn	Profile posts + Company pages
Instagram	Business + standalone accounts
Facebook Pages	Page posts with link previews
TikTok	Video descriptions
Discord	Channel targeting, embeds
Telegram	Channel/group messaging
YouTube	Video descriptions and metadata
Reddit	Subreddit posts with flair
WordPress	Blog posts with SEO metadata
Pinterest	Pins with board targeting

Setup

# Install via npx
npx skills add ndesv21/socialclaw

# Or install as package
npm install socialclaw@0.1.12

# Set your workspace API key
export SOCIALCLAW_API_KEY=your_key_here

Get a workspace API key at getsocialclaw.com.

Workflow

Step 1: Define Campaign

Specify platforms, message content, schedule, and any media attachments.

Step 2: Draft Platform Variants

Claude generates platform-optimized copy for each channel (character limits, hashtag norms, tone).

Step 3: Upload Media (Optional)

Upload images or videos once — SocialClaw stores them for reuse across platforms.

Step 4: Validate Schedule

Claude checks platform-specific timing rules and rate limits before submitting.

Step 5: Publish or Schedule

Posts queue via the SocialClaw API. Receive post IDs and scheduled times for confirmation.

Step 6: Analytics

Pull engagement metrics (impressions, clicks, reactions) 24–48 hours after publishing.

Usage Examples

Single Platform Post

Post to our company LinkedIn page:
"Excited to announce our Q2 product roadmap — here's what's coming next.
[roadmap image]"

Multi-Platform Campaign

Announce our beta launch on X, LinkedIn, Instagram, and Discord.
Message: "Our beta is live! 100 spots available — sign up at example.com #launch"
Schedule for tomorrow 9am PST

Content Series

Create a 5-day drip campaign for our feature launch week.
Platforms: X and LinkedIn.
I'll provide copy for each day.

Guidelines

1. One key, all platforms — SOCIALCLAW_API_KEY authenticates across all connected accounts
2. Platform-native copy — Adapt tone and format for each platform rather than copy-pasting
3. Validate timing — Always confirm schedule before submission to avoid rate limit errors
4. Media reuse — Upload assets once and reference by ID across multiple posts

Limitations

• Requires active SocialClaw account with connected social accounts
• Platform availability depends on workspace tier
• Some platforms require video content for optimal reach (TikTok, YouTube, Instagram Reels)