@synchronex/marketing-skills

Synchronex Marketing Skills

Local agent skills for generating branded marketing assets from a connected Tractic brand kit.

Install

npx @synchronex/marketing-skills install

The installer copies the skill folders into:

• ~/.claude/skills/ for Claude Code
• ~/.agents/skills/ for the open Agent Skills location used by Codex and Gemini
• ~/.gemini/skills/ for Gemini CLI

Gemini gives ~/.agents/skills/ precedence when the same skill name exists in both locations, so the duplicate Gemini install is intentionally redundant.

Recipes

marketing-quote-card

Generates a quote or testimonial graphic.

node ./scripts/render.mjs --quote "The quote" --author "Author Name"
node ./scripts/render.mjs --quote "The quote" --author "Author Name" --aspect portrait

Outputs quote-card-{timestamp}.png.

marketing-carousel-slide

Generates one 1080x1350 PNG per slide.

node ./scripts/render.mjs --slides "[{\"headline\":\"Slide title\",\"body\":\"Slide body\"}]"

Outputs carousel-slide-{N}-{timestamp}.png.

marketing-stat-callout

Generates a big-number callout graphic.

node ./scripts/render.mjs --big-number "42" --unit "%" --label "More qualified leads"

Outputs stat-callout-{timestamp}.png.

marketing-captioned-reel

Generates a vertical 1080x1920 captioned MP4 with local ffmpeg.

node ./scripts/render.mjs --caption "Launch faster with one local bridge" --headline "Product update"
node ./scripts/render.mjs --mode with-voice --voice neutral --caption "Launch faster with one local bridge"

No-voice mode does not call an AI API. With-voice mode uses OpenAI TTS through the bridge key file or OPENAI_API_KEY.

marketing-branded-video

Generates a branded MP4 announcement in vertical, LinkedIn portrait, or horizontal format.

node ./scripts/render.mjs --headline "Track every property" --subtitle "NOI and cash flow in one place"
node ./scripts/render.mjs --headline "Track every property" --aspect horizontal

marketing-audiogram

Generates a square or vertical audiogram MP4 from a still image and OpenAI TTS narration.

node ./scripts/render.mjs --script "A short narration" --voice neutral --image ./image.png

Default TTS model: gpt-4o-mini-tts.

marketing-narrated-explainer

Generates a narrated explainer MP4 from a script and branded still frame.

node ./scripts/render.mjs --script "Step one. Step two." --headline "How it works" --voice warm-male-educator

marketing-hero-image

Generates a PNG image with OpenAI or Gemini.

node ./scripts/render.mjs --prompt "A photorealistic rental dashboard in a modern office" --platform instagram-feed --provider openai

OpenAI image calls use gpt-image-2, low|medium|high|auto quality, and request sizes rounded down to multiples of 16.

marketing-photo-with-overlay

Generates an AI image and applies a brand overlay.

node ./scripts/render.mjs --prompt "A property operations team reviewing analytics" --headline "Portfolio clarity" --platform linkedin-square

Brand Kit

When run through the Synchronex/Tractic local agent bridge, BRIDGE_BRAND_KIT_PATH points to a JSON file:

{
  "primaryColor": "#059669",
  "secondaryColor": "#1f2937",
  "logoSvg": "<svg>...</svg>",
  "logoPng": "data:image/png;base64,...",
  "fonts": {
    "headline": "Inter Bold",
    "body": "Inter Medium"
  },
  "tagline": "Your tagline here"
}

Outputs are written to BRIDGE_OUTPUT_DIR. For local development, they fall back to ./output/.

AI Keys And ffmpeg

When run through the local agent bridge, recipes that need provider keys read BRIDGE_AI_KEYS_PATH. For local development, set OPENAI_API_KEY and/or GEMINI_API_KEY.

Video and audio recipes require ffmpeg on PATH, or FFMPEG_PATH pointing to the ffmpeg executable.

Notes

The SKILL.md files intentionally avoid provider-specific directives. They document ordinary shell commands so Claude Code, Codex CLI, and Gemini CLI can each invoke the same scripts.