Agent skill

Social Publishing

by wshobson in wshobson/agents

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.

MITAuto-check passedWriting & Content

Install Social Publishing

skills CLI
$ npx skills add wshobson/agents --skill social-publishing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wshobson/agents social-publishing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wshobson/agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/social-publishing/skills/social-publishing .claude/skills/social-publishing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
social-publishing
GitHub stars
40k
Token cost
~914 tokens
SKILL.md length
306 words
Files
1
Skills in repo
142
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 6 steps: Define Campaign → Draft Platform Variants → Upload Media (Optional) → …
  • The user wants to publish
  • SKILL.md covers When to Use This Skill, Supported Platforms, Setup and Workflow, plus 3 more sections
  • Calls npx and npm; needs SOCIALCLAW_API_KEY

What it does

Social Publishing is an agent skill from wshobson/agents. 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 SOCIALCLAWAPIKEY.

Its SKILL.md is about 910 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Social media posts and Social publishing and cross-posting. It works with Reddit, WordPress, Discord and Instagram. The repository describes itself as: Multi-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, Google Antigravity, and Pi. The licence is MIT.

When your agent uses it

  • The user wants to publish
  • Manage social media content programmatically

Example prompts

  • “/social-publishing”

Requirements

  • Node.js
  • A credential in SOCIALCLAW_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Define Campaign
  2. Draft Platform Variants
  3. Upload Media (Optional)
  4. Validate Schedule
  5. Publish or Schedule
  6. Analytics

What it can do on your machine

Read from SKILL.md and the folder at commit 46891e7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • getsocialclaw.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SOCIALCLAW_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Social Publishing loads about 914 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 306 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~914

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wshobson/agents at commit 46891e7, republished under its MIT licence (© wshobson). 306 words, ~914 tokens.

Download SKILL.mdSave it as .claude/skills/social-publishing/SKILL.md (or your agent's skills folder).
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
metadata.source
https://github.com/ndesv21/socialclaw
metadata.homepage
https://getsocialclaw.com

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

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

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.

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)

© wshobson, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/social-publishing/skills/social-publishing of wshobson/agents.

Open the folder on GitHubat commit 46891e7

Compare with similar skills

Social Publishing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Social Publishing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Social Publishing this skillwshobson/agents40k—~914Automated safety check: PassMIT
Social Publisheraffaan-m/ECC277k1 repos~1.1kAutomated safety check: PassMIT
Happycapy Social Publisherhappycapy-ai/Happycapy-skills137—~3.6kAutomated safety check: NotesMIT
Socialclawsickn33/agentic-awesome-skills47k1 repos~871Automated safety check: PassMIT
Socialclawdavepoon/buildwithclaude3.6k—~677Automated safety check: PassMIT
Upload Postdavepoon/buildwithclaude3.6k—~1.6kAutomated safety check: PassMIT

Similar skills

  • Social Publisher

    affaan-m/ECC

    Agent-driven scheduling and publishing of social media posts across 13 platforms via SocialClaw.

    277k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Happycapy Social Publisher

    happycapy-ai/Happycapy-skills

    HappyCapy-specific skill for publishing content to 13+ social media platforms (Instagram, Twitter, LinkedIn, Threads, Facebook, TikTok, YouTube, Pinterest, Reddit, Telegram, Discord, etc.)…

    137 GitHub stars~3.6k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes
  • Socialclaw

    sickn33/agentic-awesome-skills

    Agent-first social media publishing skill — schedule and publish posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest)…

    47k GitHub starsUsed in 1 repo~871 tokens
    Auto-check passed
  • Socialclaw

    davepoon/buildwithclaude

    Social media scheduling and publishing for AI agents. An agent skill from davepoon/buildwithclaude.

    3.6k GitHub stars~677 tokensUpdated 2 days ago
    Auto-check passed
  • Upload Post

    davepoon/buildwithclaude

    Publish and schedule content to 15 social platforms through one Upload-Post API call: TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Reddit, Discord, Telegram…

    3.6k GitHub stars~1.6k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Postfast

    LeoYeAI/openclaw-master-skills

    Schedule and manage social media posts across TikTok, Instagram, Facebook, X (Twitter), YouTube, LinkedIn, Threads, Bluesky, Pinterest, and Telegram using the PostFast API.

    2.2k GitHub stars~4.8k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed

More from wshobson/agents

All 142 skills in this repo
  • Cuts cloud spend across AWS, Azure, GCP and OCI with cost tagging, rightsizing, commitment and spot pricing models, and architecture changes.

    40k GitHub starsUsed in 14 repos~1.7k tokens
    Auto-check passed
  • Billing Automation

    wshobson/agents

    Covers building subscription billing: billing cycles, subscription states, invoice generation, proration, tax handling and dunning for failed payments.

    40k GitHub starsUsed in 13 repos~473 tokens
    Auto-check passed
  • Profiles slow Python code with cProfile and memory profilers, then applies targeted fixes for CPU, memory, I/O and query bottlenecks.

    40k GitHub starsUsed in 13 repos~814 tokens
    Auto-check passed
  • Writes unit tests for shell scripts with Bats: error-condition tests, fixtures and mocks, cross-shell checks, parallel runs, helper files and CI integration.

    40k GitHub starsUsed in 12 repos~1.3k tokens
    Auto-check passed
  • Distributed Tracing

    wshobson/agents

    Implement distributed tracing with Jaeger and Tempo to track requests across microservices and identify performance bottlenecks.

    40k GitHub starsUsed in 12 repos~527 tokens
    Auto-check passed
  • Reference for designing and tuning production LLM prompts: few-shot examples, chain-of-thought, structured outputs, templates and system prompts.

    40k GitHub stars~1.3k tokensUpdated 6 days ago
    Auto-check passed

Questions about Social Publishing

What does Social Publishing do?

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. Social Publishing is an agent skill from wshobson/agents. 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.

When should I use Social Publishing?

Social Publishing fits situations like: the user wants to publish; manage social media content programmatically.

How do I install Social Publishing in Claude Code?

Run `npx skills add wshobson/agents --skill social-publishing -a claude-code`. Or copy the skill folder (plugins/social-publishing/skills/social-publishing in wshobson/agents) into .claude/skills/social-publishing in your project. Claude Code loads it when a task matches its description.

How do I install Social Publishing in Codex?

Run `npx skills add wshobson/agents --skill social-publishing -a codex`. Or copy the skill folder (plugins/social-publishing/skills/social-publishing in wshobson/agents) into .agents/skills/social-publishing in your project. Codex loads it when a task matches its description.

Can I use Social Publishing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wshobson/agents --skill social-publishing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/social-publishing, .gemini/skills/social-publishing, .github/skills/social-publishing and .opencode/skills/social-publishing in your project.

What does Social Publishing need to run?

Going by SKILL.md and its folder, Social Publishing needs the command-line tools its instructions call (npx and npm) and credentials named SOCIALCLAW_API_KEY. Our summary lists: Node.js; A credential in SOCIALCLAW_API_KEY.

Does Social Publishing access the network?

SKILL.md names 1 domain. As links in the text: getsocialclaw.com. This is read from the text; nothing was executed.

Is Social Publishing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Social Publishing use?

Social Publishing is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Social Publishing use?

About 914 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Social Publishing?

Skills that share tags, products or a category with Social Publishing: Social Publisher (affaan-m/ECC, 277k stars), Happycapy Social Publisher (happycapy-ai/Happycapy-skills, 137 stars), Socialclaw (sickn33/agentic-awesome-skills, 47k stars) and Socialclaw (davepoon/buildwithclaude, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Social Publishing?

wshobson (a GitHub user) maintains it in wshobson/agents, which has 40,314 GitHub stars. The repository holds 142 skills in this directory. The repository was last updated on October 5, 2026.

Source: wshobson/agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.