Generate Doc Template

Generates a branded, print- or screen-ready document template as SVG from the active brand profile, with editable content zones.

Overview

The generate-doc-template skill turns a title (and optional subtitle and body) into a

branded document or deck master. Output is vector SVG, so it scales cleanly, prints

crisply, and needs no account, key, or network call. The generator (lib/doctpl.mjs)

draws a shared margin grid, brand mark, and accent rules, then fills the requested

kind; the skill resolves the active profile, picks the kind, runs the generator, and

saves the file. Convert to PDF or PNG downstream with /brand-export.

Prerequisites

• An active brand profile created with /brand-new (a brand/ directory, or brands/[slug]/). Read loads its color-system.json and typography.json.
• Node.js on the PATH — the generator runs as node lib/doctpl.mjs.
• Write access to an output/ directory in the working repository.
• A title string; subtitle and body are optional parameters.

Instructions

1. Run /brand-status to confirm the active brand; if none exists, tell the user to run /brand-new and stop.
2. Use Glob to locate the active brand directory, then Read and validate the profile with validateProfile. Stop with the offending field if validation fails.
3. Choose the kind — letterhead (default), slide, or one-pager. Ask the user when it is unclear.
4. Generate the template by running the node generator:

   import { loadProfile } from '../../lib/brand.mjs';
   import { buildDoc } from '../../lib/doctpl.mjs';
   const profile = loadProfile(activeDir);
   const { svg, kind } = buildDoc(profile, {
     kind: 'letterhead',
     title: 'Offer of Employment',
     body: 'Dear candidate, we are delighted to extend an offer.',
   });

1. Write the result with the Write tool to output/[slug]-[kind].svg.
2. Hand the file to the visual-guardian subagent for a palette, contrast, and type pass; apply its fixes or surface its flags.
3. Report the saved path and point out the editable zones so the user can customize or adapt the copy: id="title", id="subtitle", and id="body".

Output

One SVG file under output/, named for the slug and kind:

output/northwind-letterhead.svg

• Sized to the chosen kind — letterhead and one-pager at 816×1056 (US Letter @96dpi), slide at 1280×720 (16:9).
• Content sits in editable zones

Generate Graphic

Generates an on-brand marketing graphic through an image model — the one opt-in feature that reaches the network — optionally stamped with the brand logo and a caption.

Overview

The generate-graphic skill is the opt-in raster engine. Everything else in brand-forge

(logos, social, docs) stays vector and zero-permission; this skill is the only path

that calls an external image provider, so it runs only when a user explicitly wants a

photographic or illustrative graphic. The generator builds a brand-aware prompt with

lib/raster.mjs, calls the provider with lib/genimage.mjs, and can composite a crisp

vector logo and caption over the result with lib/composite.mjs. Text is deliberately

kept out of the image and added as vector on top.

Prerequisites

• An active brand profile created with /brand-new. Read loads its color-system.json, typography.json, and visual-identity.md.
• Two opt-in signals, both required: BRANDFORGERASTER=1 and a provider key (GEMINIAPIKEY by default, or OPENAIAPIKEY). The 30-preflight emitter surfaces this at session start.
• Authentication: the provider api key is read from that environment variable and sent as a request header, never placed in the URL. No credentials are written to disk.
• Node.js on the PATH and Write access to an output/ directory.

Instructions

1. Verify both opt-in signals are set. If either is missing, stop, explain how to enable raster, and offer the vector path (generate-social or a template) instead, which needs neither.
2. Use Glob to locate the active brand directory, then Read and validate the profile with validateProfile.
3. Build the prompt with lib/raster.mjs (no network). It encodes the palette in words, the imagery style, and the tone, and turns the brand's don't-rules into an "Avoid:" clause. Warn the user when literal text is requested and route text-heavy work to the vector engine.

   import { loadProfile } from '../../lib/brand.mjs';
   import { buildRasterPrompt } from '../../lib/raster.mjs';
   const profile = loadProfile(activeDir);
   const prompt = buildRasterPrompt(profile, { subject: 'a mountain trail at dawn' });

1. Generate the image (the network call). The provider is swappable and failures retry with backoff, never leaving a half-written file:

   import { generateImage } from '../../lib/genimage.mjs';
   await generateImage({ prompt, outPath: 'output/northwind-hero.png', provider: 'gemini' });

1. Optionally composite the brand logo and a capt

Generate Logo

Generates on-brand, editable SVG logo assets — wordmark, monogram, and favicon — from the active brand profile as pure vector output.

Overview

The generate-logo skill turns a saved brand profile into three ready-to-use logo

variants that reuse the brand's exact palette and heading font. Output is vector SVG,

so every asset scales without loss and needs no account, key, or network call. The

generator (lib/logo.mjs) draws each variant deterministically; the skill resolves

the active profile, runs that generator, saves the files, and routes them through

review. Raster copies are produced only on demand through the /brand-export command.

Prerequisites

• An active brand profile created with /brand-new (a brand/ directory, or brands/[slug]/ with a brand/.active pointer). Read loads its color-system.json and typography.json.
• Node.js on the PATH — the generator runs as node lib/logo.mjs.
• Write access to an output/ directory in the working repository.
• Optional: the sharp dependency, only if PNG copies are wanted later.

Instructions

1. Run /brand-status (or resolveActive in lib/brand.mjs) to confirm which brand is active; if none exists, tell the user to run /brand-new and stop.
2. Use Glob to locate the active brand directory, then Read and validate the profile with validateProfile. Stop with the offending field if validation fails, for example a non-hex color.
3. Decide the logo text — the optional text argument, defaulting to the brand name. Ask the user when it is ambiguous.
4. Generate the three variants by running the deterministic node generator:

   import { loadProfile } from '../../lib/brand.mjs';
   import { buildLogos } from '../../lib/logo.mjs';
   const profile = loadProfile(activeDir);
   const { wordmark, monogram, favicon } = buildLogos(profile, { text: 'Northwind' });

1. Write each variant with the Write tool: output/[slug]-wordmark.svg, output/[slug]-monogram.svg, and output/[slug]-favicon.svg.
2. Hand the files to the visual-guardian subagent for a palette, contrast, and clear-space pass; apply its fixes or surface its flags.
3. Report the saved paths and describe each variant. To customize sizing or adapt the geometry, edit the SVG directly or consult the reference below.

Output

Three SVG files under output/, one per variant:

output/northwind-wordmark.svg
output/northwind-monogram.svg
output/northwind-favicon.svg

Generate Social

Generates a platform-sized, on-brand social template as SVG from the active brand profile, with editable text zones the user can tweak afterward.

Overview

The generate-social skill turns a headline (and optional subhead and call-to-action)

into a correctly sized social graphic that uses the brand's palette and fonts. Output

is vector SVG, so it scales cleanly and needs no account, key, or network call. The

generator (lib/social.mjs) lays out a brand band, a wrapped headline, an optional

subhead, and an optional accent pill; the skill resolves the active profile, picks the

platform, runs the generator, and saves the file. For a photographic background behind

the template, the raster path lives in the generate-graphic skill.

Prerequisites

• An active brand profile created with /brand-new (a brand/ directory, or brands/[slug]/). Read loads its color-system.json and typography.json.
• Node.js on the PATH — the generator runs as node lib/social.mjs.
• Write access to an output/ directory in the working repository.
• A headline string; subhead and call-to-action are optional parameters.

Instructions

1. Run /brand-status to confirm the active brand; if none exists, tell the user to run /brand-new and stop.
2. Use Glob to locate the active brand directory, then Read and validate the profile with validateProfile. Stop with the offending field if validation fails.
3. Choose the platform preset — instagram-square (default), instagram-story, og-card, or youtube-thumb. Ask the user when unspecified.
4. Generate the template by running the node generator:

   import { loadProfile } from '../../lib/brand.mjs';
   import { buildSocial } from '../../lib/social.mjs';
   const profile = loadProfile(activeDir);
   const { svg, platform } = buildSocial(profile, {
     platform: 'instagram-square',
     headline: 'We just raised our Series A',
     subhead: 'Building the future of logistics',
     cta: 'Read the story',
   });

1. Write the result with the Write tool to output/[slug]-[platform].svg.
2. Hand the file to the visual-guardian subagent for a palette, contrast, and type pass; apply its fixes or surface its flags.
3. Report the saved path and point out the editable zones so the user can customize or adapt the copy: id="headline", id="subhead", and id="cta".

Output

One SVG file under output/, named for the slug and platform:

output/northwind-