Social Publishing

SkillCommunication

This is a skill that lets an AI agent schedule and publish social media posts across 13 platforms through the SocialClaw API. It handles drafting platform-specific copy, uploading media once for reuse, validating timing rules, and pulling engagement metrics after posting. It requires a SocialClaw account with connected social profiles and a workspace API key.

Then ask your AI: use the Social Publishing skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Create a SocialClaw account and connect the social profiles you want to publish to.

What your AI can do with it

  • Publish or schedule posts to 13 social platforms via the SocialClaw API
  • Draft platform-optimized copy for each channel
  • Upload images or videos once for reuse across platforms
  • Validate platform-specific timing rules and rate limits
  • Retrieve post-level engagement analytics after publishing
  • Manage a content calendar programmatically

Getting started

  1. Create a SocialClaw account and connect the social profiles you want to publish to.
  2. Obtain a workspace API key from your SocialClaw account.
  3. Install the skill using npx skills add ndesv21/socialclaw or npm install socialclaw@0.1.12.
  4. Set the SOCIALCLAW_API_KEY environment variable to your workspace API key.
  5. Define a campaign with platforms, message content, schedule, and any media attachments.

What this skill tells your AI

The instructions your AI receives, as published by wshobson/agents in plugins/social-publishing/skills/social-publishing/SKILL.md and read by Ahel’s review.

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

PlatformNotes
X (Twitter)Profile posts, threads
LinkedInProfile posts + Company pages
InstagramBusiness + standalone accounts
Facebook PagesPage posts with link previews
TikTokVideo descriptions
DiscordChannel targeting, embeds
TelegramChannel/group messaging
YouTubeVideo descriptions and metadata
RedditSubreddit posts with flair
WordPressBlog posts with SEO metadata
PinterestPins 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)

Signals

GitHub stars
40k
Forks
4k
Last commit
Oct 2026

Ahel review

  • K1binfo
    installs-packages

Automated review, not a security audit. Ruleset v1+k2.

Questions

What do I need before using this skill?
You need a SocialClaw account with connected social profiles and a workspace API key set as the SOCIALCLAW_API_KEY environment variable.
Which platforms are supported?
X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest.
Can I schedule posts for a future time?
Yes. You can specify a schedule, and the skill checks platform-specific timing rules and rate limits before submitting.
Can I upload media once and use it on multiple platforms?
Yes. Upload images or videos once and SocialClaw stores them for reuse across platforms.
Advanced
Item type
skill
Key
social-publishing
Source
github.com/wshobson/agents