higgsfield-brandkit
Create and extend complete visual brand systems through the Higgsfield CLI and bundled deterministic local tooling: palettes, SVG logo marks, typography, mockups, social graphics, packaging, signage, merchandise, posters, presentation decks, and editable PPTX/PDF brandbooks.
Install / Use
npx skills add higgsfield-ai/skills --skill higgsfield-brandkitInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of higgsfield-brandkit
higgsfield-brandkit scores 91/100 on our quality scale, 1094th of 4,700 Development & Engineering skills we index (top 24%).
Its SKILL.md is 12 KB long, well organised into 14 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 1,120 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so higgsfield-brandkit is actively maintained.
- Our last check on 2026-10-29 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
ReviewOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review judged it risky: Line 28 instructs the agent to run `curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh`, which is a skill-file command to pipe a remote script into a shell.
- noteInstalls by piping a downloaded script into a shellline 28
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
AI review: risky
- Line 28 instructs the agent to run `curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh`, which is a skill-file command to pipe a remote script into a shell.
- The skill authorizes the Bash tool and directs execution of an external CLI (`higgsfield`) that uploads local assets and performs paid generations, increasing trust surface.
- The overall purpose is legitimate brand-kit generation, but the remote curl-to-shell install weakens safeguards regardless of the stated permission step.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
higgsfield-brandkit compared with similar skills
All 4 of these similar skills score higher than higgsfield-brandkit; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| higgsfield-brandkit (this skill)by higgsfield-ai | 91 | 1.1k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install higgsfield-brandkit?
- Run
npx skills add higgsfield-ai/skills --skill higgsfield-brandkit. The install tabs above show the steps for each supported agent. - Which AI agents does higgsfield-brandkit work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is higgsfield-brandkit safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review judged it risky: Line 28 instructs the agent to run
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh, which is a skill-file command to pipe a remote script into a shell. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand. - Is higgsfield-brandkit still maintained?
- The repository was last updated about 2 months ago, so higgsfield-brandkit is actively maintained.
Skill content
View source on GitHubversion: 0.13.0 name: higgsfield-brandkit description: | Create and extend complete visual brand systems through the Higgsfield CLI and bundled deterministic local tooling: palettes, SVG logo marks, typography, mockups, social graphics, packaging, signage, merchandise, posters, presentation decks, and editable PPTX/PDF brandbooks. Preserves official supplied assets, persists approvals locally, and regenerates only dependent outputs. Use when: "create a brand kit", "make a visual identity", "design a logo and brandbook", "apply this logo to branded assets", "make packaging or signage", or "extend our existing branding". Chain with higgsfield-generate for general image production and Marketing Studio brand-kits when importing website metadata for ads. NOT for unbranded image generation (use higgsfield-generate), product catalog photography (use higgsfield-product-photoshoot), website implementation (use higgsfield-websites), or native Figma/Canva/PSD/AI delivery. argument-hint: "[brand brief or existing assets] [requested deliverables]" allowed-tools: Bash
Higgsfield Brandkit
Build a coherent identity and its requested applications. Treat supplied brand facts and official assets as fixed constraints.
Bootstrap
-
Resolve
SKILL_ROOTto 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
higgsfieldis missing, install it only after permission:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh -
If
higgsfield account statusfails with an authentication or workspace error, ask the user to runhiggsfield auth loginor 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
CLI mapping
| 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.
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.
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:
python3 "$SKILL_ROOT/scripts/brandkit.py" state \ --state-file "$BRANDKIT_STATE" --action get_statusLocal 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:
-
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.
New identity sequence
1. Palette
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. SVG logo marks
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.
3. Typography
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.
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.
Deterministic scripts
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.
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.
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.
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](references/logo-export-
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
