social-kit

# Social Kit One command → X variants + LinkedIn variants + a graphic. A thin orchestrator that chains `create-x-content`, `create-linkedin-content`, and `goose-graphics`, with sensible defaults and a pre-flight check for voice guides. ## Invocation Full args: ``` /social-kit --brief "..." --format poster --style matt-gray --output ./content/2026-04-21-my-topic/ ``` Partial (asks for format): ``` /social-kit --brief "..." ``` Interactive: ``` /social-kit ``` ## Inputs | Flag | Required | Default | |------|----------|---------| | `--brief` | Yes (asked if missing) | — | | `--format` | No | Asked with recommendations | | `--style` | No | `matt-gray` if the user has no stated preference; otherwise asked | | `--output` | No | `./content/YYYY-MM-DD-<topic-slug>/` | | `--variants-x` | No | `create-x-content` decides | | `--variants-linkedin` | No | `create-linkedin-content` decides | | `--skip-graphic` | No | false | | `--skip-x` | No | false | | `--skip-linkedin` | No | false | ## Workflow ### Step 1 — Intake 1. Resolve the brief (prompt if missing). 2. Derive a `topic-slug` from the brief (short kebab-case, 2–4 words). 3. Resolve `<output>` — default `./content/YYYY-MM-DD-<topic-slug>/`. Create the directory if it doesn't exist. ### Step 2 — Pre-flight voice guide check Check `~/.goose-skills/config.json` for `voice_guides.x` and `voice_guides.linkedin`. If either is missing and that platform isn't skipped: ``` Missing voice guide for <platform>. (a) Generate one now via /generate-voice-guide --platforms <platform> (b) Paste an existing path (c) Skip <platform> for this run ``` Do not proceed without resolving every non-skipped platform. ### Step 3 — Draft X variants Invoke `/create-x-content` with: ``` --brief "<brief>" --output <resolved-output> [--variants <N>] ``` Wait for completion. Capture the list of created files + the most substantive variant for use in Step 5's graphic brief. Skip if `--skip-x`. ### Step 4 — Draft LinkedIn variants Invoke `/create-linkedin-content` with the same args. Wait for completion. Skip if `--skip-linkedin`. ### Step 5 — Pick a graphic format If `--format` was passed, use it. Otherwise, analyse the brief and recommend 1–2 formats using this heuristic: | Brief shape | Recommended format | |-------------|-------------------| | One strong claim, stat, or launch announcement | **poster** (1080×1350) | | Numbered steps, how-to, or sequential process | **carousel** (1080×1080 per slide) | | Mechanism/data/timeline with multiple sections | **infographic** (1080×variable) | | Single testimonial, quote, or result metric | **tweet** (1080×1080) | | Vertical, mobile-first, under 6 beats | **story** (1080×1920) | | Widescreen presentation or demo | **slides** (1920×1080) | | Chart or data visualization | **chart** (1080×1080) | Present recommendations as a short menu: ``` Based on the brief, I'd recommend one of these: 1. poster — single strong claim, fits the "X costs $0.01 to run" shape 2. carousel — if you want to walk through the how-it-works steps Which? (or paste another format name) ``` Skip this step if `--skip-graphic`. ### Step 6 — Pick a style If `--style` was passed, use it. Otherwise, default to `matt-gray` unless the user stops the skill to pick another. To change the default per-user, a future enhancement can add a `style_default` key to `~/.goose-skills/config.json`. ### Step 7 — Generate the graphic Invoke `/goose-graphics` with: ``` --style <style> --format <format> --brief "<distilled-brief>" ``` Point output at `<resolved-output>/graphic/`. The distilled brief should include: - The headline/hook from the most substantive X variant - 2–4 key beats (steps, numbers, or sections) - Any specific strings that must appear verbatim (tool names, commands, prices) Wait for completion. Capture paths to PNG exports + index.html. Skip if `--skip-graphic`. ### Step 8 — Deliver Print a summary: ``` Social kit ready at <resolved-output>/ X drafts (N variants): - variant-a-<framing>.md - variant-b-<framing>.md - ... LinkedIn drafts (N variants): - linkedin-a-<framing>.md - linkedin-b-<framing>.md - ... Graphic (<format>, <style>): - graphic/slides/ (HTML source) - graphic/exports/ (PNG files, N files) - graphic/index.html (preview in browser) Next steps: - Open graphic/index.html to review visuals - Open any variant-*.md to copy/paste - Pair a variant with a graphic for LinkedIn/X ``` ## Output Layout ``` content/YYYY-MM-DD-<topic>/ ├── variant-a-<framing>.md # X drafts ├── variant-b-<framing>.md ├── ... ├── linkedin-a-<framing>.md # LinkedIn drafts ├── linkedin-b-<framing>.md └── graphic/ ├── slides/ # HTML source (1+ files depending on format) ├── exports/ # PNG exports └── index.html # preview ``` ## Dependencies Required skills: - `create-x-content` - `create-linkedin-content` - `goose-graphics` Recommended: - `generate-voice-guide` (create voice guides once before first use of social-kit) Voice guides + config at `~/.goose-skills/voice-guides/` and `~/.goose-skills/config.json` are discovered automatically. ## Examples **Typical run (format asked):** ``` /social-kit --brief "Claude can now verify email deliverability for $0.01 per check. Install gooseworks and ask. Runs MX, SMTP, RCPT TO, catch-all, disposable, blocklist checks." ``` → Drafts X + LinkedIn variants → asks "poster or carousel?" → generates graphic → delivers. **Full args (one-shot):** ``` /social-kit --brief "Someone vibe-coded a full lead gen tool in Claude Code in 2 weeks. Scrapes every business off Google Maps with 30+ data fields, pulls verified emails, reads up to 50 reviews to find pain points. Running $4200 ACV deals." --format carousel --style heatwave-orange ``` → Runs end-to-end with no prompts. **Skip graphic:** ``` /social-kit --brief "..." --skip-graphic ``` → Just the X + LinkedIn drafts. ## Tips - **First-time users:** run `/generate-voice-guide` once before your first `/social-kit` invocation. This is a one-time setup. - **When the recommended format feels off, it probably is.** The heuristic is a starting point — trust your read of the brief more than the recommendation. - **Pair drafts with graphics intentionally.** A long `mechanism-breakdown` X variant pairs with a carousel. A short `hype` variant pairs with a poster. The file naming makes these pairings easy to spot. - **Iterate on voice before iterating on content.** If your drafts feel off, 80% of the fix is re-running `/generate-voice-guide` with more recent posts or more iterations — not rewriting the skill prompts. - **Output path convention:** uses a standard `content/YYYY-MM-DD-<topic>/` layout. Keep it consistent for easier cross-referencing later.