Draft voice-tuned X (Twitter) post variants from a free-form brief. Reads a personal voice guide (generated via generate-voice-guide), produces 2–5 variants with distinct framings (simple-howto, problem-first, hype, mechanism-breakdown, etc.), and self-checks against the voice guide's banned phrases before returning.
npx gooseworks install --all # then, in Claude Code, Cursor, or Codex: /gooseworks use the create-x-content skill
Draft X/Twitter post variants that sound like you, not like an AI. Reads a voice guide the user has already generated (or prompts to create one), produces multiple framings of the same idea, and saves each variant as its own markdown file with frontmatter.
This is an agent-executed skill — the agent does the drafting and self-check inline. No Python script.
/create-x-content --brief "New open-source CLI that turns Figma files into React components. Called figma2react. Free, MIT licensed."Or interactively:
/create-x-content| Flag | Required | Default |
|---|---|---|
--brief | Yes (asked interactively if missing) | — |
--variants | No | Skill decides based on brief richness (2–5) |
--voice-guide | No | Resolved via chain below |
--output | No | ./content/YYYY-MM-DD-<topic-slug>/ |
--topic | No | Derived from brief |
Resolve in this order, stop at first hit:
--voice-guide <path> flag~/.goose-skills/config.json → voice_guides.x~/.goose-skills/voice-guides/voice-x.md (default path)/generate-voice-guide --platforms x now to create one (recommended)Never silently skip the voice guide. Generic posts are the failure mode to avoid.
Read the resolved voice guide into context. Extract, for use throughout drafting:
Decide variant count by richness:
If --variants is explicitly set, respect it. Otherwise pick the smallest count where each variant genuinely adds a different angle. Quality > quantity. 2 strong variants beat 5 watered-down ones.
Each variant gets a distinct framing label that determines its structure and hook:
| Framing | Structure | When to use |
|---|---|---|
simple-howto | Bare steps, no mechanism | Tool install + usage, 2–3 line how-to |
howto-plus-mechanism | How-to + "here's how it works" breakdown | Tools where the mechanism is interesting |
problem-first | Open with the pain, then solution | When the problem is visceral/relatable |
hype | Punchy "someone just dropped X" energy | Launches, new OSS releases, cool builds |
mechanism-breakdown | Focus on the how | Technical builds, systems, architectures |
ecosystem-map | Curated list of N related tools/companies | Landscape posts |
contrarian | "Most people do X wrong" opener | Opinion pieces with a clear counter-take |
personal-experience | "We've been doing X. Here's what I learned" | Field notes, lessons learned |
Use framings the voice guide's hook patterns actually support. Don't force framings the user never employs.
Before saving, run each variant through these checks:
If a variant fails any check and two rewrite attempts don't fix it, drop the variant rather than ship something weak.
Write each variant as its own .md file. File naming:
variant-<letter>-<framing-slug>.mdExamples: variant-a-simple-howto.md, variant-b-problem-first.md.
Frontmatter schema:
---
id: <topic-slug>-<letter>
platform: x
format: short | long
topic: <slug>
framing: <framing-slug>
status: draft
---Body: just the post text. No commentary, no surrounding markdown.
Print to the user:
/social-kit for a matching graphic)<output>/variant-<letter>-<framing>.md per variantSimple brief:
/create-x-content --brief "npx goose-skills install claude-code-hooks — a new skill that adds pre-commit, pre-tool-use, and post-response hooks to Claude Code so you can enforce coding standards automatically."→ 3 variants (howto, hype, mechanism)
Rich brief:
/create-x-content --brief "Built a Claude-driven lead gen system. Scrapes Reddit for people asking about email deliverability, finds their domains, verifies their business email via Hunter, drafts a personalized DM. 47 leads in 6 hours at $0.03/lead."→ 5 variants (personal-experience, mechanism-breakdown, hype, problem-first, simple-howto)
generate-voice-guide skill (for creating one when missing)Assemble an expert/educator motion-graphic LISTICLE video ad from a config — a spoken authoritative voiceover carries a numbered listicle while N web-animated hyperframe beats (HTML plus the Web Animations API, one branded design system of alternating tiles, big hero numerals, and glass-pill callouts) are rendered frame-by-frame via Playwright and anchored to the VO's word-level timestamps, periodic color-graded B-roll windows give visual breath, and captions burn ONLY inside those B-roll windows (2-word chunks, ASS Format header carrying a Name field so none drop) with the VO mixed under a low music bed. This is the FREE deterministic assembly stage (Playwright beat render plus ffmpeg concat plus window-masked caption burn plus VO-and-music mix plus final composite) — the VO, the music bed, and the stock B-roll come from create-vo-elevenlabs, create-music-elevenlabs, and media-proxy. Use for the vo-anchored-motion-listicle format.
Assemble a stop-motion hand-swatch-cycle product-demo ad from a config — a sequence of still PLATES (one hand swiping a single-barrel cosmetic across a cream skin-patch, the barrel + swatch changing per plate while the hand, background, crop, and lighting stay locked) is PNG→mp4 loop-encoded at each plate's own stop-motion hold (fast motion frames 150–250ms, per-shade ~380ms, hero beats 1100–1800ms), concat-demuxed with HARD cuts into a silent master, closed on a Playwright HTML-rendered branded end card (serif tagline + sans subtitle + real logo SVG over a hero BG, never AI-rendered text), and muxed with a pre-sourced music track playing under the end card with a fade tail (no VO). This is the FREE deterministic assembly stage (loop-encode + concat-demux + end-card render + music mux); the master-anchor plate, shade plates, and end-card BG come from create-image-gpt-image-fal and the track from create-music-elevenlabs. Use for the stopmotion-hand-swatch-cycle format.
Assemble a split-screen creator ad from a config — a two-zone vertical composite where a supplied AI-creator lip-sync take fills the BOTTOM ~48% while real 16:9 product/demo clips run uncropped in the TOP ~52%, each top clip contain-fit with a darkened blurred cover-scale fill of the same clip (never black bars), a 3px brand-color divider between the zones, the creator slice cover-fit per the per-scene VO timing, scenes hard-concatenated with the body audio being the concatenated creator VO slices, an end card held on the last sharp frame ~3s, then the ASSEMBLED cut transcribed with local Whisper (not the raw VO — concat drops inter-scene silence) and word-level captions burned in the chosen style. This is the FREE deterministic assembly + caption stage (two-zone composite + blurred fill + divider + hard-concat + end card + captions); the VO comes from create-vo-elevenlabs, the anchor from create-image-gpt-image-fal, and the whole-VO lip-sync from a paid VEED Fabric 1.0 take (a no-atom upstream input). Use for the split-screen-creator format.