Skip to content

wshobson/agents / plugins/social-publishing/skills/social-publishing

social-publishing

Verified

Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via the SocialClaw API. Use when the user wants to publish, schedule, or manage social media content programmatically. Requires SOCIALCLAW_API_KEY.

FileKindSize
SKILL.mdskill md3.6 KB
---
name: social-publishing
description: >
  Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram,
  Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via
  the SocialClaw API. Use when the user wants to publish, schedule, or manage social
  media content programmatically. Requires SOCIALCLAW_API_KEY.
license: MIT
metadata:
  version: "1.0.0"
  source: https://github.com/ndesv21/socialclaw
  homepage: https://getsocialclaw.com
---

# 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)
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall