social-publishing

# Social Publishing Agent-first social media publishing via [SocialClaw](https://getsocialclaw.com). 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 ```bash # 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](https://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)