mirror of
https://github.com/wshobson/agents
synced 2026-06-21 14:13:58 +00:00
Merge pull request #558 from ndesv21/add-social-publishing
feat: add social-publishing plugin via SocialClaw
This commit is contained in:
Seth Hobson
@@ -6,7 +6,7 @@
|
||||
"url": "https://github.com/wshobson"
|
||||
},
|
||||
"metadata": {
|
||||
"description": "Production-ready workflow orchestration with 83 marketplace plugins, 191 local specialized agents, and 155 local skills - optimized for granular installation and minimal token usage",
|
||||
"description": "Production-ready workflow orchestration with 84 marketplace plugins, 192 local specialized agents, and 156 local skills - optimized for granular installation and minimal token usage",
|
||||
"version": "1.7.1"
|
||||
},
|
||||
"plugins": [
|
||||
@@ -699,6 +699,19 @@
|
||||
"license": "MIT",
|
||||
"category": "marketing"
|
||||
},
|
||||
{
|
||||
"name": "social-publishing",
|
||||
"source": "./plugins/social-publishing",
|
||||
"description": "Schedule and publish social media posts across 13 platforms (X, LinkedIn Profile + Page, Instagram Business + Standalone, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via SocialClaw — one workspace API key covers everything",
|
||||
"version": "1.0.0",
|
||||
"author": {
|
||||
"name": "ndesv21",
|
||||
"url": "https://github.com/ndesv21"
|
||||
},
|
||||
"homepage": "https://getsocialclaw.com",
|
||||
"license": "MIT",
|
||||
"category": "marketing"
|
||||
},
|
||||
{
|
||||
"name": "blockchain-web3",
|
||||
"source": "./plugins/blockchain-web3",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# claude-agents — multi-harness agentic plugin marketplace
|
||||
|
||||
Production-ready agentic-workflow building blocks: **83 plugins** (81 local + 2 external), **191 agents**, **155 skills**, **102 commands**. Native source-of-truth for Claude Code; also consumed by OpenAI Codex CLI, Cursor, OpenCode, and Gemini CLI from a single Markdown source.
|
||||
Production-ready agentic-workflow building blocks: **84 plugins** (82 local + 2 external), **192 agents**, **156 skills**, **102 commands**. Native source-of-truth for Claude Code; also consumed by OpenAI Codex CLI, Cursor, OpenCode, and Gemini CLI from a single Markdown source.
|
||||
|
||||
This file is the canonical context file. Codex / Cursor / OpenCode read it directly. Claude Code reads it via `CLAUDE.md`, a symlink to this file. Gemini CLI reads it via `gemini-extension.json` (`contextFileName`) / `.gemini/settings.json`.
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Agentic Plugin Marketplace
|
||||
|
||||
> Production-ready agentic workflow building blocks: **83 plugins**, **191 agents**,
|
||||
> **155 skills**, **102 commands** — built for Claude Code and consumed natively by
|
||||
> Production-ready agentic workflow building blocks: **84 plugins**, **192 agents**,
|
||||
> **156 skills**, **102 commands** — built for Claude Code and consumed natively by
|
||||
> OpenAI Codex CLI, Cursor, OpenCode, Gemini CLI, and GitHub Copilot from a single Markdown source.
|
||||
|
||||
[](#claude-code) [](docs/harnesses.md) [](docs/harnesses.md) [](docs/harnesses.md) [](GEMINI.md) [](docs/harnesses.md)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Agent Skills
|
||||
|
||||
Agent Skills are modular packages that extend Claude's capabilities with specialized domain knowledge, following Anthropic's [Agent Skills Specification](https://github.com/anthropics/skills/blob/main/agent_skills_spec.md). This plugin ecosystem includes **155 local specialized skills** across 41 plugins, enabling progressive disclosure and efficient token usage.
|
||||
Agent Skills are modular packages that extend Claude's capabilities with specialized domain knowledge, following Anthropic's [Agent Skills Specification](https://github.com/anthropics/skills/blob/main/agent_skills_spec.md). This plugin ecosystem includes **156 local specialized skills** across 41 plugins, enabling progressive disclosure and efficient token usage.
|
||||
|
||||
## Overview
|
||||
|
||||
@@ -336,6 +336,12 @@ Skills provide Claude with deep expertise in specific domains without loading ev
|
||||
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
|
||||
| **protect-mcp-setup** | Configure Cedar policy enforcement and Ed25519 signed receipts for tool calls; example policies for research/dev/production |
|
||||
|
||||
### Social Publishing (1 skill)
|
||||
|
||||
| Skill | Description |
|
||||
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ |
|
||||
| **social-publishing** | Schedule and publish social media posts across 13 platforms via the SocialClaw API |
|
||||
|
||||
## How Skills Work
|
||||
|
||||
### Activation
|
||||
|
||||
+2
-1
@@ -1,6 +1,6 @@
|
||||
# Agent Reference
|
||||
|
||||
Complete reference for all **191 local specialized AI agents** organized by category with model assignments.
|
||||
Complete reference for all **192 local specialized AI agents** organized by category with model assignments.
|
||||
|
||||
## Agent Categories
|
||||
|
||||
@@ -186,6 +186,7 @@ Complete reference for all **191 local specialized AI agents** organized by cate
|
||||
| Agent | Model | Description |
|
||||
| --------------------------------------------------------------------------------- | ------ | -------------------------------------------- |
|
||||
| [content-marketer](../plugins/content-marketing/agents/content-marketer.md) | sonnet | Blog posts, social media, email campaigns |
|
||||
| [social-publishing-publisher](../plugins/social-publishing/agents/social-publishing-publisher.md) | haiku | Multi-platform social media publishing via SocialClaw |
|
||||
| [sales-automator](../plugins/customer-sales-automation/agents/sales-automator.md) | haiku | Cold emails, follow-ups, proposal generation |
|
||||
|
||||
#### Support & Legal
|
||||
|
||||
+3
-2
@@ -1,6 +1,6 @@
|
||||
# Complete Plugin Reference
|
||||
|
||||
Browse all **83 marketplace plugins** organized by category: 81 local plugins plus 2 externally hosted `git-subdir` entries (`pensyve`, `qa-orchestra`).
|
||||
Browse all **84 marketplace plugins** organized by category: 82 local plugins plus 2 externally hosted `git-subdir` entries (`pensyve`, `qa-orchestra`).
|
||||
|
||||
## Quick Start - Essential Plugins
|
||||
|
||||
@@ -251,7 +251,7 @@ Next.js, React + Vite, and Node.js project setup with pnpm and TypeScript best p
|
||||
| **api-scaffolding** | REST/GraphQL API generation | `/plugin install api-scaffolding` |
|
||||
| **api-testing-observability** | API testing and monitoring | `/plugin install api-testing-observability` |
|
||||
|
||||
### 📢 Marketing (4 plugins)
|
||||
### 📢 Marketing (5 plugins)
|
||||
|
||||
| Plugin | Description | Install |
|
||||
| ------------------------------ | --------------------------------------- | -------------------------------------------- |
|
||||
@@ -259,6 +259,7 @@ Next.js, React + Vite, and Node.js project setup with pnpm and TypeScript best p
|
||||
| **seo-technical-optimization** | Meta tags, keywords, and schema markup | `/plugin install seo-technical-optimization` |
|
||||
| **seo-analysis-monitoring** | Content analysis and authority building | `/plugin install seo-analysis-monitoring` |
|
||||
| **content-marketing** | Content strategy and web research | `/plugin install content-marketing` |
|
||||
| **social-publishing** | Multi-platform social media publishing | `/plugin install social-publishing` |
|
||||
|
||||
### 💼 Business (4 plugins)
|
||||
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
{
|
||||
"name": "social-publishing",
|
||||
"version": "1.0.0",
|
||||
"description": "Schedule and publish social media posts across 13 platforms (X, LinkedIn Profile + Page, Instagram Business + Standalone, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, Pinterest) via SocialClaw — one workspace API key covers everything",
|
||||
"author": {
|
||||
"name": "ndesv21",
|
||||
"url": "https://github.com/ndesv21"
|
||||
},
|
||||
"homepage": "https://getsocialclaw.com",
|
||||
"license": "MIT"
|
||||
}
|
||||
@@ -0,0 +1,81 @@
|
||||
---
|
||||
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
|
||||
@@ -0,0 +1,113 @@
|
||||
---
|
||||
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.
|
||||
|
||||
## 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
|
||||
|
||||
```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](https://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)
|
||||
Reference in New Issue
Block a user