Terminal
Terminal/Skill
Builds a complete visual brand system through the Higgsfield CLI, with palettes, logo marks, typography, mockups, packaging and a brandbook PDF or PPTX.
By Higgsfield AI
Works with
npx skills add higgsfield-ai/skills --skill higgsfield-brandkitBuild a coherent identity and its requested applications. Treat supplied brand facts and official assets as fixed constraints.
Resolve SKILL_ROOT to this skill's installed directory and create a durable project directory:
BRANDKIT_WORKDIR="${PWD}/brandkit"
BRANDKIT_STATE="${BRANDKIT_WORKDIR}/state.json"
mkdir -p "${BRANDKIT_WORKDIR}"
Read prerequisites. Check tools before the stage that needs them. Never install system packages without the user's permission.
If higgsfield is missing, install it only after permission:
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
If higgsfield account status fails with an authentication or workspace error, ask the user to run higgsfield auth login or select a workspace, then wait.
Inspect live model contracts before paid generation:
higgsfield model get recraft_v4_1 --json
higgsfield model get seedream_v5_pro --json
higgsfield model get gpt_image_2 --json
| Operation | Command |
|---|---|
| Discover a model | higgsfield model get <model> --json |
| Generate and poll | higgsfield generate create <model> ... --wait --json |
| Resume a job | higgsfield generate wait <job_id> --json |
| Upload a local asset | higgsfield upload create <path> --json |
| Import website metadata | higgsfield marketing-studio brand-kits fetch --url <url> --wait --json |
| Read/write approval state | python3 "$SKILL_ROOT/scripts/brandkit.py" state ... |
| Render review boards | python3 "$SKILL_ROOT/scripts/brandkit.py" preview ... |
| Inspect selected logo | python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect ... |
| Export logo files | python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export ... |
| Build a Brandbook | python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build ... |
Local image paths passed with --image are auto-uploaded. Keep HTML, SVG, PPTX, and PDF deliverables as local project files unless the user explicitly needs a hosted copy.
Classify the request.
apply-existing: use supplied official assets without redesigning them.extend-partial: create only missing slots required by the requested output.create-identity: create a new logo or identity only when explicitly requested.Read state. Run:
python3 "$SKILL_ROOT/scripts/brandkit.py" state \
--state-file "$BRANDKIT_STATE" --action get_status
Local state is durable. Never paste, hand-edit, or recreate approvals when the state file exists.
Run intake and asset analysis. Read intake, asset analysis, state routing, and exact state payloads. Lock every user-declared official logo, palette, and typography slot immediately.
Create the Brand Lock. Read Brand Lock. Record exact spelling, official assets, colors, fonts, layout/shape rules, requested outputs, and forbidden treatments.
Require only the slots the output uses.
Build missing foundation slots. Read Design Brain, concept boards, inline reviews, and only the needed palette, logo, or typography module.
Continue the original request as soon as its required slots are approved. Never ask the user to choose scope again.
Load only the requested production module:
QA and approval. Read QA and iteration. Repair only the failing output. Save a downstream element only after explicit approval with its exact foundation dependencies.
Render 2–3 exact palette options as deterministic HTML using preview payloads. Show PNG screenshots plus editable HTML files and wait. Persist the selected palette with approve_palette before logo generation.
Read logo prompt enhancer. Produce exactly three distinct symbol-only mechanisms and one Recraft prompt for each. Write each long prompt to a file and submit separately:
higgsfield generate create recraft_v4_1 \
--model_type vector \
--colors @"${BRANDKIT_WORKDIR}/logo-colors.json" \
--background_color '#F7F7F5' \
--aspect_ratio 1:1 \
--resolution 2k \
--wait --json < "${BRANDKIT_WORKDIR}/logo-candidate-1.txt"
Use the returned SVG URLs directly for review. After selection, inspect the exact SVG without altering it:
python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect \
--source "<selected Recraft SVG URL or absolute local path>"
Persist the exact job ID, SVG URL, name, palette revision, and returned canonical geometry fingerprint with approve_logo.
Propose 2–3 unique display/body pairs using supplied fonts or verified Google Fonts. Render the real brand name and sample copy through the preview script. Persist only the selected pair with approve_typography.
Interactive flows always stop for palette, logo, and typography selections. Explicit no-question mode may choose and persist a palette, but it still shows all three SVG logo candidates and stops for the user's logo selection; exact brand marks are never self-approved.
required_slots.Create JSON input files under "$BRANDKIT_WORKDIR"; never interpolate user text directly into shell arguments.
python3 "$SKILL_ROOT/scripts/brandkit.py" preview \
--input "$BRANDKIT_WORKDIR/reviews.json" \
--output-dir "$BRANDKIT_WORKDIR/reviews"
python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export \
--input "$BRANDKIT_WORKDIR/logo-export.json" \
--output-dir "$BRANDKIT_WORKDIR/logo"
python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build \
--state-file "$BRANDKIT_STATE" \
--input "$BRANDKIT_WORKDIR/brandbook.json" \
--output-dir "$BRANDKIT_WORKDIR/brandbook"
For logo export, load logo export payloads. For Brandbooks, use the bundled builder only; never substitute an improvised PowerPoint or PDF generator after a deterministic contract failure.
For Brandbooks, follow the strict response contract in brandbook: PPTX link/path, PDF link/path, and font-install warning only.
For other outputs return: