Social Publishing
Publish or schedule the same campaign across many social platforms through one SocialClaw API key.
Overview
Social Publishing is an agent skill most often used in Launch (also Grow) that schedules and publishes posts to 13 social platforms via the SocialClaw API.
Install
npx skills add https://github.com/wshobson/agents --skill social-publishingWhat is this skill?
- 13 platforms: X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest
- Single workspace API key via SocialClaw—no per-platform OAuth wiring in the agent
- Schedule posts and orchestrate multi-platform campaigns programmatically
- Upload and attach media to posts
- Retrieve post-level engagement analytics
- 13 supported social platforms
Adoption & trust: 1 installs on skills.sh; 36.5k GitHub stars.
What problem does it solve?
You have content ready to ship but wiring OAuth and APIs for every social network burns days you do not have as a solo builder.
Who is it for?
Builders running multi-channel launch announcements or recurring content calendars with one API key and agent-driven orchestration.
Skip if: Teams that need only one network with native tooling, lack SOCIALCLAW_API_KEY, or want organic SEO/GEO research instead of social APIs.
When should I use this skill?
User wants to publish, schedule, or manage social media content programmatically and has SOCIALCLAW_API_KEY.
What do I get? / Deliverables
Posts are scheduled or live across selected platforms with media and metadata attached, plus optional analytics retrieval for follow-up iterations.
- Scheduled or published posts per platform
- Media attachments and platform-specific metadata
- Post-level engagement analytics when requested
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Launch is when builders push announcements and coordinated posts to channels that drive first traffic. Distribution is the shelf for multi-channel publishing and calendar execution, not deep SEO tooling.
Where it fits
Blast a product launch thread on X plus LinkedIn and Discord channel posts in one scripted run.
Schedule a week of TikTok descriptions and Pinterest pins from a single content batch.
Pull post-level analytics after a campaign to decide what to repost or retire.
How it compares
Agent integration skill for SocialClaw—not a standalone MCP server or manual browser posting playbook.
Common Questions / FAQ
Who is social-publishing for?
Solo and indie builders who want their agent to push or schedule social posts across many platforms without maintaining separate OAuth apps.
When should I use social-publishing?
At Launch for coordinated announcements, in Grow for content calendars and analytics checks, or anytime the user asks to publish or schedule social media programmatically.
Is social-publishing safe to install?
It requires a live API key and network access to SocialClaw; review the Security Audits panel on this page and scope the key to least privilege in SocialClaw.
SKILL.md
READMESKILL.md - 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)