Agent-Skills.md

Agent Skills: Social Publishing

>

UncategorizedID: wshobson/agents/social-publishing

Repository

wshobson/agents
wshobsonLicense: MIT
39,5404,213

Install this agent skill to your local

pnpm dlx add-skill https://github.com/wshobson/agents/tree/HEAD/plugins/social-publishing/skills/social-publishing

Skill Files

Browse the full folder contents for social-publishing.

Download Skill

Loading file tree…

plugins/social-publishing/skills/social-publishing/SKILL.md

Skill Metadata

Name
social-publishing
Description
>

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)