Guide · Agent skill
How to use the Social Publishing agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Social Publishing skill lets an AI agent draft, schedule and publish social media posts across 13 platforms, including X, LinkedIn, Instagram and Discord, through the SocialClaw service. It is written for marketers, small teams and creators who want one place to send the same announcement to several channels. After reading this guide you will know what the skill does, how to install it, what it needs before it works, and how to ask for posts in plain language. An agent skill is a folder containing a SKILL.md file with instructions that an AI agent such as Claude loads when a request matches the skill's description. This skill's files consist of SKILL.md alone.
Social Publishingwshobson/agents · MIT Download the skill Quick start
- 1Get your API key. Create or sign in to a SocialClaw account at getsocialclaw.com and copy a workspace API key.
- 2Connect your social accounts. Connect the networks you plan to publish to inside SocialClaw, since the skill cannot post without them.
- 3Install the skill. Download the ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills in the Claude apps.
- 4Set the environment variable. Export SOCIALCLAW_API_KEY with your key so the skill can authenticate across all connected accounts.
- 5Ask for a post in plain language. Name the platforms, the message, and the schedule, and attach any media.
- 6Review the drafts and schedule. Read each platform variant and confirm the timing before the agent submits it.
- 7Check the results. Note the post IDs and scheduled times in the confirmation, then pull engagement metrics 24 to 48 hours after publishing.
What the Social Publishing skill makes the agent do
Once installed, the agent can draft posts tailored to each social network, attach images or videos, and schedule or publish them to many platforms at once. Publishing goes through the SocialClaw API using one workspace API key, so you do not set up a separate login or OAuth connection for each network.
The agent can also pull post-level engagement metrics such as impressions, clicks and reactions, usually 24 to 48 hours after publishing. The posts are sent from the social accounts you have connected in SocialClaw.
- Draft platform-specific copy for each channel (character limits, hashtag norms, tone)
- Upload images or videos once and reuse them across platforms
- Validate schedule timing and rate limits before submitting
- Receive post IDs and scheduled times as confirmation
- Retrieve engagement analytics for published posts
Which platforms are supported?
The skill covers 13 platforms: X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress and Pinterest. Each has its own notes, for example LinkedIn supports profile posts and Company pages, Reddit supports subreddit posts with flair, and WordPress supports blog posts with SEO metadata.
Platform availability depends on your SocialClaw workspace tier, according to the skill's limitations section.
- X (Twitter): profile posts, threads
- LinkedIn: profile posts and Company pages
- Instagram: business and standalone accounts
- Facebook Pages: page posts with link previews
- TikTok: video descriptions
- Discord: channel targeting, embeds
- Telegram: channel or group messaging
- YouTube: video descriptions and metadata
- Reddit: subreddit posts with flair
- WordPress: blog posts with SEO metadata
- Pinterest: pins with board targeting
What you need before you start
The skill cannot work without a SocialClaw account, a workspace API key, and social accounts connected inside SocialClaw. Get the API key at getsocialclaw.com. The skill reads it from an environment variable named SOCIALCLAW_API_KEY.
The skill also needs npx or npm, because the setup uses them to install the skill and the socialclaw package (version 0.1.12 is referenced in the source).
- A SocialClaw account with connected social media accounts
- A workspace API key, stored in the SOCIALCLAW_API_KEY environment variable
- npx or npm available on your machine
How do you install the skill?
There are two routes. The first is to download the skill ZIP from this directory page, unzip it, and place the folder in ~/.claude/skills/ for personal use, or in a project's .claude/skills/ folder to share it with that project. The second is to upload the ZIP in the Claude apps under Settings → Capabilities → Skills.
The upstream source also documents an install using npx. Run the command below, then set your key. Replace the placeholder with your own key; never commit it to a file or share it.
Install the skill and package and set your key in your shell:
npx skills add ndesv21/socialclaw
npm install socialclaw@0.1.12
export SOCIALCLAW_API_KEY=your_key_hereHow do you trigger the skill with a natural request?
You do not call the skill by name. The agent loads it when your request matches its description, which covers publishing, scheduling, managing social media content programmatically, uploading media, running multi-platform campaigns, retrieving engagement analytics and managing a content calendar.
Name the platforms, give the message, and say when it should go out. Include the image or video if you have one. The agent will draft variants and check timing before anything is submitted.
- Say which platforms you want, for example X and LinkedIn
- Give the message or the topic, or ask the agent to write it
- State the schedule, such as tomorrow at 9am PST
- Attach or name the media you want included
Examples of requests
These patterns are taken from the skill's usage examples. A single-platform post goes to one channel. A multi-platform campaign sends one message to several networks at a set time. A content series spreads copy over several days.
- Single platform: post to your company LinkedIn page with an announcement and a roadmap image
- Multi-platform: announce a beta launch on X, LinkedIn, Instagram and Discord, scheduled for tomorrow 9am PST
- Content series: create a 5-day drip campaign for a feature launch week on X and LinkedIn, where you provide the copy for each day
Safety notes: scripts and network access
This skill runs scripts and uses the network. It sends requests to the SocialClaw service on your behalf, and those posts appear from your connected accounts. Anything published is public, and mistakes cannot be quietly undone.
The workspace API key grants access to all connected accounts in the workspace, so do not share it or use this skill where you cannot share that key. Review every draft and confirm the schedule before the agent submits it. The skill's own guidelines say to always confirm the schedule before submission to avoid rate limit errors.
- Review every draft before scheduling or publishing
- Keep SOCIALCLAW_API_KEY out of shared files and repositories
- Only use the skill with accounts you are authorised to post from
- Remember that one key covers every connected account in the workspace
Tips for better results
Ask for platform-native copy rather than one message pasted everywhere. The skill's guidelines recommend adapting tone and format for each platform. Upload media once and reuse it, since the skill stores assets for reuse across platforms.
Some platforms do best with video. The source notes that TikTok, YouTube and Instagram Reels often need video content for optimal reach, so plan assets for those channels early.
- Adapt copy per platform instead of copy-pasting
- Upload each image or video once and reference it across posts
- Plan video assets early for TikTok, YouTube and Instagram Reels
- Check engagement metrics 24 to 48 hours after posts go out
What people use it for
- Announcing a product launch on X, LinkedIn, Instagram and Discord from one request
- Running a five-day drip campaign for a feature launch with different copy each day
- Publishing a company update to a LinkedIn Company page with an attached image
- Sending a blog announcement to WordPress with SEO metadata alongside social posts
- Reviewing basic engagement numbers for last week's posts
Frequently asked questions
Is the Social Publishing skill free?
The source does not state pricing or licence fees for SocialClaw. The skill itself is released under the MIT licence. Check getsocialclaw.com for SocialClaw's plans, since platform availability depends on workspace tier.
What do I need to install the social-publishing skill?
You need a SocialClaw account, a workspace API key stored as SOCIALCLAW_API_KEY, connected social accounts, and npx or npm. Install by unzipping the downloaded ZIP into ~/.claude/skills/ or a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills.
Which social networks does the skill support?
It supports 13 platforms: X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress and Pinterest. Each platform has its own supported post types, such as Reddit subreddit posts with flair or Pinterest pins with board targeting.
Does the skill work without SocialClaw?
No. The skill publishes through the SocialClaw API and cannot work without a SocialClaw account and connected social accounts.
Is it safe to give the agent my API key?
The key grants access to all connected accounts in the workspace, so only use it where you can share that access. Keep it in an environment variable, not in shared files, and review every draft before it is scheduled or published.
How does it compare to logging in to each platform separately?
The skill uses one workspace API key for all connected networks instead of separate logins or OAuth setup per platform. The source does not compare it with other scheduling tools, so check their features yourself before choosing.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Choose this skill if you run launches or campaigns across several channels and want one request to draft, schedule and track posts in a single place. Skip it if you want to publish without reviewing text, cannot share a workspace API key, or do not have a SocialClaw account with connected accounts.
Download the skill