mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-06-22 21:30:03 +08:00
db7f2a6fd5
The official Agent Skills spec (agentskills.io/specification) whitelists exactly 6 top-level frontmatter keys (name/description/license/compatibility/metadata/ allowed-tools). A top-level `origin` key fails the official validator (anthropics/skills quick_validate.py ALLOWED_PROPERTIES; skills-ref validate). This moves `origin: X` -> `metadata.origin: X` across the canonical skills/ tree, preserving each value verbatim. Frontmatter-only, minimal diff. - 251 SKILL.md updated (242 new metadata block, 9 appended to existing metadata) - origin values preserved verbatim (verified 251/251) - YAML validated on all changed files - scoped to canonical skills/ only (docs/<lang> translations + tool mirrors .cursor/.kiro/.agents left untouched; presumably regenerated from canonical) Addresses #2233
118 lines
3.0 KiB
Markdown
118 lines
3.0 KiB
Markdown
---
|
|
name: social-publisher
|
|
description: Agent-driven scheduling and publishing of social media posts across 13 platforms via SocialClaw. Use when the user wants to publish to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, or Pinterest — or when managing campaigns, uploading media, or monitoring post delivery status.
|
|
metadata:
|
|
origin: community
|
|
---
|
|
|
|
# Social Publisher (SocialClaw)
|
|
|
|
Connects Claude Code to [SocialClaw](https://getsocialclaw.com) for agent-driven social media publishing across 13 platforms through a single workspace API key.
|
|
|
|
## When to Activate
|
|
|
|
- publish content to X, LinkedIn, Instagram, TikTok, or other platforms
|
|
- schedule a post campaign across multiple platforms at once
|
|
- upload media for use in social posts
|
|
- validate a post schedule before going live
|
|
- monitor publishing run status and delivery analytics
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
# Required: workspace API key from https://getsocialclaw.com/dashboard
|
|
export SC_API_KEY="<workspace-key>"
|
|
|
|
# Verify access
|
|
printf 'header = "Authorization: Bearer %s"\n' "$SC_API_KEY" |
|
|
curl -sS -K - https://getsocialclaw.com/v1/keys/validate
|
|
|
|
# Install CLI (optional but recommended)
|
|
npm install -g socialclaw@0.1.12
|
|
socialclaw login --api-key <workspace-key>
|
|
```
|
|
|
|
## Core Workflow
|
|
|
|
### 1. List connected accounts
|
|
```bash
|
|
socialclaw accounts list --json
|
|
```
|
|
|
|
If not connected:
|
|
```bash
|
|
socialclaw accounts connect --provider x --open
|
|
socialclaw accounts connect --provider linkedin --open
|
|
```
|
|
|
|
### 2. Upload media (optional)
|
|
```bash
|
|
socialclaw assets upload --file ./image.png --json
|
|
# → { "asset_id": "..." }
|
|
```
|
|
|
|
### 3. Build schedule.json
|
|
```json
|
|
{
|
|
"posts": [
|
|
{
|
|
"provider": "x",
|
|
"account_id": "<account-id>",
|
|
"text": "Post text here",
|
|
"scheduled_at": "2026-06-01T10:00:00Z"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
### 4. Validate before publishing
|
|
```bash
|
|
socialclaw validate -f schedule.json --json
|
|
```
|
|
|
|
### 5. Publish
|
|
```bash
|
|
socialclaw apply -f schedule.json --json
|
|
# → { "run_id": "..." }
|
|
```
|
|
|
|
### 6. Monitor
|
|
```bash
|
|
socialclaw status --run-id <run-id> --json
|
|
socialclaw posts list --json
|
|
```
|
|
|
|
## Supported Providers
|
|
|
|
| Provider | Key |
|
|
|----------|-----|
|
|
| X (Twitter) | `x` |
|
|
| LinkedIn profile | `linkedin` |
|
|
| LinkedIn page | `linkedin_page` |
|
|
| Instagram Business | `instagram_business` |
|
|
| Instagram standalone | `instagram` |
|
|
| Facebook Page | `facebook` |
|
|
| TikTok | `tiktok` |
|
|
| YouTube | `youtube` |
|
|
| Reddit | `reddit` |
|
|
| WordPress | `wordpress` |
|
|
| Discord | `discord` |
|
|
| Telegram | `telegram` |
|
|
| Pinterest | `pinterest` |
|
|
|
|
## Security
|
|
|
|
- Outbound requests go to `getsocialclaw.com` only
|
|
- Provider OAuth is in the SocialClaw dashboard — no per-provider secrets exposed to the agent
|
|
- `SC_API_KEY` is a workspace-scoped key
|
|
|
|
## Related Skills
|
|
|
|
- `x-api` — direct X/Twitter API operations
|
|
- `social-graph-ranker` — network analysis for outreach targeting
|
|
|
|
## Source
|
|
|
|
- npm: `npm install -g socialclaw@0.1.12`
|
|
- Dashboard: [SocialClaw dashboard](https://getsocialclaw.com/dashboard)
|