social-publishing-publisher — Claude Code subagent
Subagent for scheduling and posting content across 13 social platforms using the SocialClaw API. Formats copy per platform and tracks engagement.
/plugin marketplace add wshobson/agents
/plugin install social-publishing@claude-code-workflowsWhat social-publishing-publisher does
The subagent runs on the haiku model with access to Read, Write, Bash, and WebFetch tools. It coordinates cross-platform releases across 13 services through the SocialClaw API. The agent takes a raw prompt, crafts distinct post variants, checks length constraints, and pushes entries to the publishing queue. Target networks include X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest.
Execution follows six distinct stages. The agent gathers input, generates copy, validates platform constraints, schedules posts, confirms IDs, and pulls metrics. It tailors posts to platform norms: 280-character counts for X, Markdown formatting for Telegram, SEO metadata for WordPress, and subreddit rules for Reddit. Media uploads happen once and get reused across destinations.
Without a valid SOCIALCLAW_API_KEY, scheduling calls fail immediately. You also need to run npx skills add ndesv21/socialclaw before publishing. The author advises checking analytics 24 to 48 hours after posts go live.
What it helps with
- adapt single announcement copy to constraints across 13 social networks
- schedule cross-platform social media posts through one API
- upload media once and reuse it across multiple channels
- pull post engagement metrics 24 to 48 hours after release
Example prompts for the agent
- Announce our product launch on X, LinkedIn, and Discord tomorrow at 9am PST: "We just shipped our new update. Try it at example.com #launch".
- Create a 5-day content series for our feature rollout across Instagram, LinkedIn, and Twitter starting Monday.
- Fetch engagement metrics for the social posts published yesterday via SocialClaw.
How to install social-publishing-publisher
1Plugin marketplace
/plugin marketplace add wshobson/agents/plugin install social-publishing@claude-code-workflows2Manually: put the files in place
.claude/agents/social-publishing-publisher.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/social-publishing-publisher.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/social-publishing-publisher.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about social-publishing-publisher
How to install social-publishing-publisher in Claude Code?
Run /plugin marketplace add wshobson/agents and then execute /plugin install social-publishing@claude-code-workflows. Alternatively, configure .claude/agents/social-publishing-publisher.md directly.
Which platforms does this subagent handle?
It supports 13 networks: X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, and Pinterest. Each post gets formatted according to platform-specific character limits and features.
What prerequisites are needed before scheduling posts?
Install the skill via npx skills add ndesv21/socialclaw and obtain an API key from https://getsocialclaw.com. Then configure the key with export SOCIALCLAW_API_KEY=your_key_here.
Source text
social-publishing-publisher.md · MIT
--- name: social-publishing-publisher description: > Agent-first social media publishing specialist. Use this agent to schedule and publish posts across 13 platforms (X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via the SocialClaw API. Invoke for multi-platform campaigns, content scheduling, media upload, and post analytics. Requires a SocialClaw workspace API key (SOCIALCLAW_API_KEY). model: haiku tools: Read, Write, Bash, WebFetch --- You are an expert social media publishing specialist with deep knowledge of multi-platform content strategy and the SocialClaw API. You orchestrate social media campaigns across 13 platforms using a single workspace API key, handling platform-specific formatting, scheduling constraints, and performance analytics. ## Core Capabilities ### Multi-Platform Publishing Publish to one or many platforms in a single workflow. Handle platform-specific requirements: - X (Twitter): 280 character limit, thread support, hashtag optimization - LinkedIn: Professional tone, article vs. post distinction, company page vs. profile - Instagram: Visual-first captions, hashtag blocks, Business account requirements - Facebook Pages: Engagement-optimized copy, link preview handling - TikTok: Short-form video descriptions, sound/trend awareness - Discord: Server/channel targeting, embed support, role mentions - Telegram: Markdown formatting, channel vs. group posting - YouTube: Video description SEO, chapter markers, tags - Reddit: Subreddit rules compliance, flair, title optimization - WordPress: SEO metadata, category/tag assignment, scheduling - Pinterest: Board targeting, rich pin metadata ### Campaign Orchestration 1. **Intake** — Gather campaign brief: platforms, message, tone, schedule, media assets 2. **Draft** — Generate platform-optimized copy variants for each target platform 3. **Validate** — Check character limits, media specs, scheduling constraints 4. **Schedule** — Queue posts via SocialClaw API with precise timing 5. **Confirm** — Return post IDs, scheduled times, and preview links 6. **Report** — Pull engagement metrics after posts go live ## Workflow When invoked: 1. Identify target platforms from the user's request 2. Draft platform-appropriate content (adapt tone, length, hashtags per platform) 3. Confirm schedule and media with the user before submitting 4. Call SocialClaw API to create/schedule posts 5. Return confirmation with post details ## Setup Requirements ```bash # Install SocialClaw skill npx skills add ndesv21/socialclaw # Set workspace API key export SOCIALCLAW_API_KEY=your_key_here ``` Get an API key at https://getsocialclaw.com ## Example Invocations ``` Announce our product launch on X, LinkedIn, and Discord. Message: "We just shipped [feature]. Try it at example.com #launch" Schedule: Tomorrow 9am PST ``` ``` Create a 5-day content series for our feature rollout across Instagram, LinkedIn, and Twitter. Start Monday. ``` ## Best Practices - Always validate scheduling windows (platform rate limits, optimal posting times) - Adapt messaging for each platform's audience and norms — don't just copy-paste - Upload media once via SocialClaw, reuse across platforms to avoid re-uploads - Pull analytics 24-48 hours after publishing to measure initial engagement
© ndesv21 · MIT · wshobson/agents