higgsfield-brandkit

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Higgsfield Brandkit

Higgsfield 品牌套件

Build a coherent identity and its requested applications. Treat supplied brand facts and official assets as fixed constraints.

构建连贯的品牌标识及所需应用内容。将提供的品牌信息与官方资产视为固定约束条件。

Bootstrap

Resolve

SKILL_ROOT

to this skill's installed directory and create a durable project directory:

bash

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.

higgsfield

is missing, install it only after permission:

bash

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:

bash

higgsfield model get recraft_v4_1 --json
higgsfield model get seedream_v5_pro --json
higgsfield model get gpt_image_2 --json

将

SKILL_ROOT

指向本技能的安装目录，并创建持久化项目目录：

bash

BRANDKIT_WORKDIR="${PWD}/brandkit"
BRANDKIT_STATE="${BRANDKIT_WORKDIR}/state.json"
mkdir -p "${BRANDKIT_WORKDIR}"

阅读前置条件。在需要工具的阶段前检查工具情况。未经用户许可，切勿安装系统包。

若缺少

higgsfield

，仅在获得许可后安装：

bash

curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh

若
```
higgsfield account status
```
因认证或工作区错误失败，请要求用户运行
```
higgsfield auth login
```
或选择工作区，然后等待操作完成。

在付费生成前查看实时模型协议：

bash

higgsfield model get recraft_v4_1 --json
higgsfield model get seedream_v5_pro --json
higgsfield model get gpt_image_2 --json

CLI mapping

CLI 映射

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.

操作	命令
发现模型	`higgsfield model get <model> --json`
生成并轮询	`higgsfield generate create <model> ... --wait --json`
恢复任务	`higgsfield generate wait <job_id> --json`
上传本地资产	`higgsfield upload create <path> --json`
导入网站元数据	`higgsfield marketing-studio brand-kits fetch --url <url> --wait --json`
读写审批状态	`python3 "$SKILL_ROOT/scripts/brandkit.py" state ...`
渲染评审看板	`python3 "$SKILL_ROOT/scripts/brandkit.py" preview ...`
检查选中的标志	`python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect ...`
导出标志文件	`python3 "$SKILL_ROOT/scripts/brandkit.py" logo-export ...`
构建品牌手册	`python3 "$SKILL_ROOT/scripts/brandkit.py" brandbook-build ...`

通过

--image

传入的本地图片路径会自动上传。除非用户明确需要托管副本，否则将HTML、SVG、PPTX和PDF交付件保存为本地项目文件。

User-facing behavior

用户交互行为

Match the user's language. Keep Design Brain reasoning, prompts, state mechanics, scripts, model lookup, and QA internals private.
Send at most one short status sentence per visible generation batch, then stay quiet until the result is ready.
Ask one compact set of only unresolved blocking questions. Never repeat facts or force a complete identity questionnaire for a partial task.
After each palette, logo, typography, or downstream review, stop and wait for ordinary user feedback.
Never infer approval from silence, successful generation, or your own preference.
Preserve exact user copy. Never invent positioning, values, claims, ingredients, prices, certifications, statistics, or regulatory content.

匹配用户使用的语言。Design Brain推理逻辑、提示词、状态机制、脚本、模型查询及QA内部流程均需保密。
每个可见生成批次最多发送一条简短状态语句，之后保持静默直至结果就绪。
仅提出一组简洁的未解决阻塞问题。切勿重复已知信息，或因部分任务而强制用户完成完整的标识调查问卷。
在每次调色板、标志、排版或下游评审后，暂停并等待用户的常规反馈。
切勿从静默、生成成功或自身偏好推断用户已审批。
保留用户提供的原始文案。切勿自行编造定位、价值观、声明、成分、价格、认证、统计数据或合规内容。

Core workflow

核心工作流

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:
bash
```
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.
- logo-only → palette + logo for a new mark; official logo alone for an existing mark
- palette-only → palette
- typography-only → typography
- copy-free mockup/merch → logo; add palette only when color/application requires it
- text-bearing social/packaging/poster/signage → logo + palette + typography
- Brandbook/deck → logo + palette + typography
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:
- mockups
- social graphics
- posters/banners
- packaging
- signage
- merchandise
- presentation decks
- Brandbooks
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.

分类请求
- ```
apply-existing
```
  ：使用提供的官方资产，不进行重新设计。
- ```
extend-partial
```
  ：仅创建请求输出所需的缺失内容。
- ```
create-identity
```
  ：仅在明确请求时创建新标志或品牌标识。
读取状态。运行：
bash
```
python3 "$SKILL_ROOT/scripts/brandkit.py" state \
  --state-file "$BRANDKIT_STATE" --action get_status
```
本地状态是持久化的。当状态文件存在时，切勿粘贴、手动编辑或重新创建审批记录。
执行信息收集与资产分析。阅读信息收集、资产分析、状态路由和精确状态负载。立即锁定用户声明的所有官方标志、调色板和排版内容。
创建品牌锁定。阅读品牌锁定。记录精确拼写、官方资产、颜色、字体、布局/形状规则、请求输出及禁用处理方式。
仅要求输出所需的内容模块
- 仅标志 → 新标志需调色板+标志；现有标志仅需官方标志
- 仅调色板 → 仅调色板
- 仅排版 → 仅排版
- 无文案模型图/周边 → 标志；仅当颜色/应用需要时添加调色板
- 含文字的社交内容/包装/海报/标识 → 标志+调色板+排版
- 品牌手册/演示文稿 → 标志+调色板+排版
构建缺失的基础模块。阅读Design Brain、概念板、内嵌评审，以及仅需的调色板、标志或排版模块。
一旦所需模块获得审批，立即继续执行原始请求。切勿要求用户再次选择范围。
仅加载请求的生产模块：
- 模型图
- 社交图形
- 海报/横幅
- 包装
- 标识
- 周边产品
- 演示文稿
- 品牌手册
QA与审批。阅读QA与迭代。仅修复失败的输出内容。仅在获得明确审批后，保存带有精确基础依赖的下游元素。

New identity sequence

新品牌标识流程

1. Palette

1. 调色板

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.

使用预览负载渲染2-3个精确的调色板选项为确定性HTML。展示PNG截图及可编辑HTML文件并等待用户反馈。在生成标志前，使用

approve_palette

持久化选中的调色板。

2. SVG logo marks

2. SVG标志

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:

bash

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:

bash

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

阅读标志提示词增强器。生成三个完全不同的纯符号方案，每个方案对应一个Recraft提示词。将每个长提示词写入文件并单独提交：

bash

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"

直接使用返回的SVG URL进行评审。选中后，检查精确的SVG内容，不得修改：

bash

python3 "$SKILL_ROOT/scripts/brandkit.py" logo-inspect \
  --source "<选中的Recraft SVG URL或本地绝对路径>"

使用

approve_logo

持久化精确的任务ID、SVG URL、名称、调色板版本及返回的标准几何指纹。

3. Typography

3. 排版

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.

使用提供的字体或已验证的Google Fonts推荐2-3组独特的标题/正文字体组合。通过预览脚本渲染真实品牌名称及示例文案。仅使用

approve_typography

持久化选中的组合。

交互式流程在调色板、标志和排版选择阶段始终会暂停。显式无提问模式可选择并持久化调色板，但仍会展示全部三个SVG标志候选方案并等待用户选择；精确品牌标志绝不会自动审批。

Consistency invariants

一致性规则

Reuse the same approved logo source everywhere. Never redraw an official or selected SVG when deterministic placement/export is possible.
A generated logo depends on the palette revision used to create it. Changing that palette invalidates the generated logo and its dependents; changing typography does not invalidate the symbol mark.
Changing a foundation slot invalidates only downstream elements that list that slot in
```
required_slots
```
.
Copy the same Brand Lock values into every related generation prompt: exact hex, font roles, shape language, placement, clear space, composition, and forbidden treatments.
Use Recraft V4.1 vector mode only for new logo marks.
Use Seedream as the primary photoreal mockup generator. Use GPT Image 2 only for the controlled stage that adds readable text or exact graphic details.
Use local deterministic SVG/PPTX/HTML construction for exact copy and editable layouts. Do not ask an image model to fake editable files.
Do not promise native Figma, Canva, PSD, AI, or EPS files.

所有场景复用同一已审批的标志源。当可进行确定性放置/导出时，切勿重绘官方或选中的SVG。
生成的标志依赖于创建它时使用的调色板版本。修改该调色板会使生成的标志及其依赖内容失效；修改排版不会使符号标志失效。
修改基础模块仅会使在
```
required_slots
```
中列出该模块的下游元素失效。
将相同的品牌锁定值复制到所有相关生成提示词中：精确十六进制颜色、字体角色、形状语言、放置方式、留白、构图及禁用处理方式。
仅在创建新标志时使用Recraft V4.1矢量模式。
使用Seedream作为主要的写实模型图生成器。仅在添加可读文本或精确图形细节的受控阶段使用GPT Image 2。
使用本地确定性SVG/PPTX/HTML构建来实现精确文案和可编辑布局。切勿要求图像模型伪造可编辑文件。
切勿承诺提供原生Figma、Canva、PSD、AI或EPS文件。

Deterministic scripts

确定性脚本

Create JSON input files under

"$BRANDKIT_WORKDIR"

; never interpolate user text directly into shell arguments.

bash

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.

在

"$BRANDKIT_WORKDIR"

下创建JSON输入文件；切勿将用户文本直接插入shell参数。

bash

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"

标志导出需加载标志导出负载。品牌手册仅使用配套的构建器；在确定性协议失败后，切勿使用临时的PowerPoint或PDF生成器替代。

Failure policy

失败处理策略

Retry a failed Recraft or image-generation request once with the same locked concept and corrected contract. Stop after the second equivalent failure.
If preview or logo export fails twice, report the concrete error; never replace it with ad-hoc SVG rewriting.
If the Brandbook template, font, or conversion contract fails, stop immediately. Do not produce a visually different fallback and call it canonical.
If exact typography or official-logo fidelity cannot be preserved, disclose the limitation instead of claiming completion.
Never expose raw auth tokens or credentials in files, logs, or chat.

失败的Recraft或图像生成请求可使用相同的锁定概念和修正后的协议重试一次。第二次等效失败后停止尝试。
若预览或标志导出两次失败，需报告具体错误；切勿用临时SVG重写替代。
若品牌手册模板、字体或转换协议失败，立即停止。切勿生成视觉效果不同的替代方案并声称其为标准版本。
若无法保留精确的排版或官方标志保真度，需披露限制而非声称已完成。
切勿在文件、日志或聊天中暴露原始认证令牌或凭据。

Delivery

交付

For Brandbooks, follow the strict response contract in brandbook: PPTX link/path, PDF link/path, and font-install warning only.

For other outputs return:

The requested visual files and previews.
A compact Brand Lock summary.
Editable versus flattened format labels.
Required-font/import limitations.
Stable variant names for targeted revisions.

品牌手册需遵循品牌手册中的严格响应协议：仅提供PPTX链接/路径、PDF链接/路径及字体安装警告。

其他输出需返回：

请求的视觉文件及预览图。
简洁的品牌锁定摘要。
可编辑格式与扁平化格式的标签。
所需字体/导入限制说明。
用于定向修订的稳定变体名称。

Reference index

参考索引

Prerequisites — stage-specific local dependencies and install commands.
Intake — minimal questions and input routing.
Asset analysis — official/reference classification and measurement.
State routing and state payloads — persistent approvals.
Brand Lock — canonical visual constraints.
Design Brain — private art direction.
Concept boards, preview payloads, and inline reviews — selection stages.
Logo, logo prompt enhancer, and logo export payloads — SVG generation and deterministic variants.
Palette and typography — foundation slots.
Mockups, social graphics, posters/banners, packaging, signage, and merchandise — applications.
Presentation decks and Brandbooks — editable documents.
QA and iteration — preflight, repair, approval, and delivery manifest.

前置条件 — 各阶段的本地依赖及安装命令。
信息收集 — 最少必要问题及输入路由。
资产分析 — 官方/参考内容分类及测量。
状态路由和状态负载 — 持久化审批记录。
品牌锁定 — 标准视觉约束。
Design Brain — 私有艺术指导。
概念板、预览负载和内嵌评审 — 选择阶段。
标志、标志提示词增强器和标志导出负载 — SVG生成及确定性变体。
调色板和排版 — 基础模块。
模型图、社交图形、海报/横幅、包装、标识和周边产品 — 应用场景。
演示文稿和品牌手册 — 可编辑文档。
QA与迭代 — 预检、修复、审批及交付清单。