publish-social - SKILL.md Agent Skill

name: publish-social description: "Turn write-social copy into a publishing bundle — per-platform drafts plus scheduler-import files (Typefully / Buffer / Hootsuite / CSV). `--mode=publish` posts live behind a two-stage gate. Covers 9 platforms (X / LinkedIn / Instagram / YouTube / TikTok / Facebook / Bluesky / Threads / Reddit). Not for writing copy (use write-social), media generation (use produce-asset / produce-video), or landing-page placement." argument-hint: "[write-social slug or path]" allowed-tools: Read Edit Write Grep Glob Bash metadata: version: "1.0.2" budget: standard estimated-cost: "$0.40-1.20"

Publish Social — Integration-Aware Bundle Emitter

Converts a write-social artifact into a per-platform draft bundle + scheduler-import files. Auto-detects credentials, picks highest non-publish mode. Routing: routing.yaml · agents + 4-route dispatch: references/agent-manifest.md.

Core question: Can the operator paste one file into their scheduler (or find X drafts in Typefully) without formatting another line?

Critical Gates — load first

Non-negotiable. Full: references/procedures/critical-gates.md.

Auto-detect never publishes — export/draft only; live needs --mode=publish.
Publish opt-in and gated — critic PASS + two-stage confirmation; --dry-run posts nothing.
Credential safety — values NEVER logged/written; .forsvn/credentials/platforms.json gitignored; dim 6 greps _KEY/_TOKEN/_SECRET.
Char-cap — X 280 · Threads 500 · Bluesky 300 · LinkedIn 3000 · IG 2200 · FB 63206 · YouTube 5000 · TikTok 2200 · Reddit 300+40000. One over = FAIL.
Scheduler-format validation — Typefully JSON + Buffer/Hootsuite/generic CSVs parse cleanly (columns, UTF-8, ISO-8601).
Provenance — input_artifacts = write-social + media manifests + brand/BRAND.md; output_eval: null until evaluate-content.
Browser-automation confirm gate (D17) — preview + single-confirm; declined/timeout → export. references/confirmation-gate.md.
Two-stage gate for --mode=publish (D18) — dims 1-7 PASS, Stage 1 body review + Stage 2 typed PUBLISH. Abort → export. references/publish-confirmation-gate.md.

Inputs

Artifact	Req	Provides
write-social (path/slug)	yes	Platforms, body variants, hook, CTA, hashtags, media refs
`brand/BRAND.md`	yes	Voice, sacred elements, archetype
produce-asset / produce-video manifest	opt	Image / video media
`--mode`	opt	`auto` · `export` · `draft` · `publish` (+ `--dry-run`)
Target platforms	opt	Defaults to write-social; subset via flag

Missing write-social → NEEDS_CONTEXT (/write-social). Missing brand/BRAND.md → NEEDS_CONTEXT (/create-brand).

Output

Bundle docs/forsvn/artifacts/marketing/published-social/[slug]/: manifest.md, platforms/[platform].md (per target), scheduler-imports/{typefully.json,buffer.csv,hootsuite.csv,generic.csv}, README.md. Schema: references/format-conventions.md.

Quality Gate

Critic enforces 8-dim rubric. Export/draft → before delivery; --mode=publish → content gate before the confirmation gate.

Pass: ≥56/80 aggregate AND every dim ≥6. FAIL → re-dispatch formatter (or automation for dim 7), max 2 cycles. Persistent publish FAIL → BLOCKED. Per-dim: references/quality-gate.md. Full: references/rubric.md.

Routes

4 routes — full dispatch: references/procedures/dispatch-mechanics.md:

A no credentials: formatter export-all-9 → critic → bundle.
B Typefully key: X via Draft API + 8 export → critic → bundle.
C (D17) browser-automation: formatter → confirm gate → automation (3s pacing, export fallback) → critic → bundle.
D (D18) --mode=publish: formatter + export fallback → critic content gate → --dry-run exits → two-stage gate → publish (Typefully X, automation 8) → dim 8.

Artifact Contract

Root: docs/forsvn/artifacts/marketing/published-social/[slug]/ · Lifecycle: pipeline.
Frontmatter: manifest (16 fields) + per-platform draft (12 fields) — incl. pack_verified/applied_tactics + a per-draft ## Legibility section (convention).
Provenance: input_artifacts = write-social + media manifests + brand/BRAND.md; output_eval: null until evaluate-content.
Cross-stack: schema changes need atomic update across write-social/produce-asset/produce-video. Full: references/format-conventions.md (v2 baseline: _shared/artifact-contract-template.md).

Chain · Re-run · Anti-Patterns

Prev: write-social + create-brand (req), produce-asset/produce-video (opt). Next: see ## Execution; feeds evaluate-content.

Re-run: write-social re-emitted, targets/scheduler changed, credentials first configured, draft rejected.

Anti-patterns: references/anti-patterns.md — top hits: credential leakage (G3/d6), char-cap trunc (G4/d1).

Durable Rules (protected)

Completion Status

DONE — bundle written, critic passed, Gates green; publish posts live + confirmation logged.
DONE_WITH_CONCERNS — critic flagged secondary issues OR one platform fell back to draft/export on publish.
NEEDS_CONTEXT — write-social missing OR brand/BRAND.md missing OR targets not derivable.
BLOCKED — --mode=publish with no credentials; critic FAILed twice (publish: gate never fires; export/draft: spec). Operator-aborted two-stage gate is NOT BLOCKED — ships export bundle as DONE.

Execution

Offer the registry-gated fork (category publish) — Brief-only: follow the manifest's per-route instruction (export · Typefully draft · automation draft · publish); Assisted/Direct need a verified engine. See execution-fork.md; record execution_mode. Session execution profile (single-vs-multi): inherit per references/_shared/execution-policy.md.