Publish social

Skill hungv47/meta-skills/skills/marketing/publish-social

Turn your coding agent into a full product team — composable skills across research, marketing, product, and process. One install, every editor (Claude Code, Cursor, Codex, Windsurf, Gemini CLI, VS Code).

Install

npx -y skills add hungv47/meta-skills --skill publish-social

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

13 stars13 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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.

SKILL.md

6.5 KB, as published. Nobody here has run it

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.