Schedule and publish social media posts across 13 platforms

Social publishing

by wshobson · MIT license · ★ 39,857 on GitHub · updated Sep 21

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,…

---
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.

Overview

Agent-first social media publishing via SocialClaw. One workspace API key, 13 platforms, zero per-platform OAuth setup.

Manual install (npx, ZIP)

Claude Codenpx skills add wshobson/agents --skill social-publishing -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/wshobson/agents/tar.gz/4236bb91f839 \
  | tar -xz -C ~/.claude/skills --strip-components=4 agents-4236bb91f839/plugins/social-publishing/skills/social-publishing

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/cae121141e513894fcf4/social-publishing.zip" -OutFile "$env:TEMP\social-publishing.zip"; Expand-Archive "$env:TEMP\social-publishing.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md3.6 KB

Read the files here

wshobson/4236bb91 file

SKILL.md3.6 KB

SKILL.md

Show the full text114 lines

social-publishing/SKILL.md114 lines · 3.6 KB

PreviewCode

Outline

RawView on GitHub

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 [email protected]

# 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

One key, all platforms — SOCIALCLAW_API_KEY authenticates across all connected accounts
Platform-native copy — Adapt tone and format for each platform rather than copy-pasting
Validate timing — Always confirm schedule before submission to avoid rate limit errors
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)

1	---
2	name: social-publishing
3	description: >
4	Schedule and publish social media posts across 13 platforms (X, LinkedIn, Instagram,
5	Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via
6	the SocialClaw API. Use when the user wants to publish, schedule, or manage social
7	media content programmatically. Requires SOCIALCLAW_API_KEY.
8	license: MIT
9	metadata:
10	version: "1.0.0"
11	source: https://github.com/ndesv21/socialclaw
12	homepage: https://getsocialclaw.com
13	---
14
15	# Social Publishing
16
17	Agent-first social media publishing via [SocialClaw](https://getsocialclaw.com). One workspace API key, 13 platforms, zero per-platform OAuth setup.
18
19	## When to Use This Skill
20
21	Use this skill when the user wants to:
22	- Publish or schedule posts across multiple social media platforms
23	- Orchestrate a multi-platform content campaign
24	- Upload and attach media to social posts
25	- Retrieve post-level engagement analytics
26	- Manage a content calendar programmatically
27
28	## Supported Platforms
29
30	\| Platform \| Notes \|
31	\|----------\|-------\|
32	\| X (Twitter) \| Profile posts, threads \|
33	\| LinkedIn \| Profile posts + Company pages \|
34	\| Instagram \| Business + standalone accounts \|
35	\| Facebook Pages \| Page posts with link previews \|
36	\| TikTok \| Video descriptions \|
37	\| Discord \| Channel targeting, embeds \|
38	\| Telegram \| Channel/group messaging \|
39	\| YouTube \| Video descriptions and metadata \|
40	\| Reddit \| Subreddit posts with flair \|
41	\| WordPress \| Blog posts with SEO metadata \|
42	\| Pinterest \| Pins with board targeting \|
43
44	## Setup
45
46	```bash
47	# Install via npx
48	npx skills add ndesv21/socialclaw
49
50	# Or install as package
51	npm install [email protected]
52
53	# Set your workspace API key
54	export SOCIALCLAW_API_KEY=your_key_here
55	```
56
57	Get a workspace API key at [getsocialclaw.com](https://getsocialclaw.com).
58
59	## Workflow
60
61	### Step 1: Define Campaign
62	Specify platforms, message content, schedule, and any media attachments.
63
64	### Step 2: Draft Platform Variants
65	Claude generates platform-optimized copy for each channel (character limits, hashtag norms, tone).
66
67	### Step 3: Upload Media (Optional)
68	Upload images or videos once — SocialClaw stores them for reuse across platforms.
69
70	### Step 4: Validate Schedule
71	Claude checks platform-specific timing rules and rate limits before submitting.
72
73	### Step 5: Publish or Schedule
74	Posts queue via the SocialClaw API. Receive post IDs and scheduled times for confirmation.
75
76	### Step 6: Analytics
77	Pull engagement metrics (impressions, clicks, reactions) 24–48 hours after publishing.
78
79	## Usage Examples
80
81	### Single Platform Post
82	```
83	Post to our company LinkedIn page:
84	"Excited to announce our Q2 product roadmap — here's what's coming next.
85	[roadmap image]"
86	```
87
88	### Multi-Platform Campaign
89	```
90	Announce our beta launch on X, LinkedIn, Instagram, and Discord.
91	Message: "Our beta is live! 100 spots available — sign up at example.com #launch"
92	Schedule for tomorrow 9am PST
93	```
94
95	### Content Series
96	```
97	Create a 5-day drip campaign for our feature launch week.
98	Platforms: X and LinkedIn.
99	I'll provide copy for each day.
100	```
101
102	## Guidelines
103
104	1. One key, all platforms — SOCIALCLAW_API_KEY authenticates across all connected accounts
105	2. Platform-native copy — Adapt tone and format for each platform rather than copy-pasting
106	3. Validate timing — Always confirm schedule before submission to avoid rate limit errors
107	4. Media reuse — Upload assets once and reference by ID across multiple posts
108
109	## Limitations
110
111	- Requires active SocialClaw account with connected social accounts
112	- Platform availability depends on workspace tier
113	- Some platforms require video content for optimal reach (TikTok, YouTube, Instagram Reels)
114