Socialclaw

davepoon/socialclaw

Social media scheduling and publishing for AI agents. Use when the user wants to schedule posts, connect social accounts, upload media, or publish campaigns to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, or Pinterest through SocialClaw.

676 tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

3248

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/davepoon/buildwithclaude --skill socialclaw

The instruction itself

7 sections, as written by the author

SocialClaw

SocialClaw is a workspace-scoped social publishing service at https://getsocialclaw.com.

This skill teaches Claude Code how to:

Validate a workspace API key and confirm SocialClaw access
Connect and disconnect social accounts via browser OAuth
Upload media assets and get SocialClaw-hosted delivery URLs
Validate, preview, apply, and inspect scheduled posts and campaigns
Inspect account capabilities, publish settings, analytics, and workspace health

Runtime Requirements

SC_API_KEY — workspace API key from the SocialClaw dashboard
CLI (optional): npm install -g socialclaw
Active trial or paid plan required for CLI/API execution

Quick Start

# Get a workspace API key
open https://getsocialclaw.com/dashboard

# Set it in your environment
export SC_API_KEY="<workspace-key>"

# Or use the CLI
socialclaw login --api-key <workspace-key>

# List connected accounts
socialclaw accounts list --json

# Upload media and schedule a post
socialclaw assets upload --file ./image.png --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --json

Supported Providers

X, LinkedIn (profile + page), Instagram (Business + standalone), Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest

Install as Skill

npx skills add ndesv21/socialclaw

Key Commands

socialclaw login                                          # Authenticate with workspace API key
socialclaw accounts list --json                          # List connected accounts
socialclaw accounts connect --provider x --open          # Connect X account
socialclaw assets upload --file ./image.png --json       # Upload media
socialclaw validate -f schedule.json --json              # Validate schedule
socialclaw apply -f schedule.json --json                 # Apply schedule / create run
socialclaw status --run-id <id> --json                   # Check run status
socialclaw posts list --json                             # List posts
socialclaw analytics post --post-id <id> --json          # Post analytics
socialclaw workspace health --json                       # Workspace health

How to use it

Copy the folder

Take davepoon/socialclaw from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference npm, npx. Without those the skill loads but fails at the first command.