social-publish

Files (1)

• SKILL.md

SKILL.md (first lines)

# social-publish

Orchestrates a multi-platform content campaign from a single brief or source
video. Supports the following platforms:

**Platforms**
- `x` — X (Twitter) thread, 280 chars/post, uses playwright-x
- `x-article` — X long-form article, uses playwright-x
- `linkedin` — LinkedIn newsletter or post, uses playwright-linkedin
- `medium` — Medium long-form post, uses playwright-medium

> **Note**: `bluesky` agents (`social-bluesky-writer`, `social-bluesky-poster`)
> + `scripts/bluesky-post.py` shipped 2026-05-31 (S17, commit `d721e33`) but
> are **INERT — user opted out 2026-05-31**. Code remains on disk for
> reference but is not part of the active platform list. Do NOT dispatch
> the bluesky agents from this skill.

## Process

1. **Gather** raw materials: transcript, screenshots, diagrams, README excerpt.
   Ask the user for the source video URL or local path if not provided.

2. **Generate diagrams** if needed via `codex-image-gen`.

3. **Write** per-platform content by dispatching the platform writer agent:
   - `social-x-writer` for X threads
   - `social-x-article-writer` for X long-form
   - `social-linkedin-writer` for LinkedIn
   - `social-medium-writer` for Medium

4. **Review** all drafts together. Present to the user for approval if running
   interactively. In autonomous mode, proceed directly to posting.

5. **Post** by dispatching the platform poster agent for each approved draft:
   - `social-x-poster` for X
   - `social-x-article-poster` for X long-form
   - `social-linkedin-poster` for LinkedIn
   - `social-medium-poster` for Medium

## Platform selection

The user can specify a subset of platforms. Default is all four. Examples:
- "ship to X and LinkedIn" → x, linkedin only
- "LinkedIn + Medium" → linkedin, medium only
- "everywhere" → all four

## Credential requirements

| Platform  | Auth method                              | Credential file                  |
|-----------|------------------------------------------|----------------------------------|
| X         | Playwright session (pw-login.js)         | ~/.claude-pw/state-x.json        |
| LinkedIn  | Playwright session (pw-login.js)         | ~/.claude-pw/state-linkedin.json |
| Medium    | Playwright session (pw-login.js)         | ~/.claude-pw/state-medium.json   |

If a required credential file is missing, skip that platform and report which
one needs re-auth.

## Output

Report the final status of each platform:
- Posted: the canonical URL or AT URI of the published post
- Skipped: reason (missing creds, user excluded, draft rejected)
- Failed: error summary

From techfreakworm/claude-soma, MIT.

More from techfreakworm/claude-soma