Agent skill

Brand Identity

by fatihaydost in fatihaydost/brand-identity-skill

Brand identity sets from one brief - logo, typography and colour palette built together, measured (contrast, colour blindness, glyph coverage, font licences, small-size logo renders) and compared…

MITAuto-check passedMedia & Creative

Install Brand Identity

skills CLI
$ npx skills add fatihaydost/brand-identity-skill --skill brand-identity -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fatihaydost/brand-identity-skill brand-identity --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fatihaydost/brand-identity-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/brand-identity .claude/skills/brand-identity && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brand-identity
GitHub stars
130
Token cost
~2k tokens
SKILL.md length
1,072 words
Files
110 (incl. scripts, references, assets)
Repo updated
First seen
Licence
MIT

At a glance

Brand identity sets from one brief - logo, typography and colour palette built together, measured (contrast, colour blindness, glyph coverage, font licences, small-size logo renders) and compared…

  • Works in 7 steps: Intake: one message, only what blocks you → Flow and turn plan (~16–20 turns to the… → Making the sets → …
  • Any part of one (logo
  • SKILL.md covers 1. Intake: one message, only…, 2. Flow and turn plan (~16–20…, 3. Making the sets and 4. Component craft, plus 3 more sections
  • Calls python3

What it does

Brand Identity is an agent skill from fatihaydost/brand-identity-skill. Brand identity sets from one brief - logo, typography and colour palette built together, measured (contrast, colour blindness, glyph coverage, font licences, small-size logo renders) and compared side by side as identity cards, shown on the user's own site, then a brand guidelines kit (PDF, logo files, tokens) for the chosen set. Use for a new brand or any part of one (logo, fonts, colours, or a mix), for refreshing an identity, or for critiquing one, even if the user only says "branding".

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 115 other files, including scripts, reference files and assets (for example `assets/ai-defaults.json`, `assets/fonts/catalog.json` and `assets/i18n/en.json`).

It sits in Media & Creative, covering Brand strategy and identity, Typography and Theming and dark mode. The repository describes itself as: A Claude Code skill that designs a brand identity as one system: logo, typography and colour palette built together from one brief, measured, compared as identity cards, and… The licence is MIT.

When your agent uses it

  • Any part of one (logo
  • For refreshing an identity
  • For critiquing one
  • Even if the user only says branding

Example prompts

  • “branding”
  • “/brand-identity”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Intake: one message, only what blocks you
  2. Flow and turn plan (~16–20 turns to the checkpoint)
  3. Making the sets
  4. Component craft
  5. Checkpoint message (then stop)
  6. Honesty
  7. Reference map

What it can do on your machine

Read from SKILL.md and the folder at commit 532742d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brand Identity loads about 2k tokens when it runs, and up to ~15k if it reads all its reference files. Until then it costs about 127 tokens; SKILL.md has 1,072 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~127
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~15k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from fatihaydost/brand-identity-skill at commit 532742d, republished under its MIT licence (© fatihaydost). 1,072 words, ~2,019 tokens.

Download SKILL.mdSave it as .claude/skills/brand-identity/SKILL.md (or your agent's skills folder). This skill also uses 109 other files; get the full folder from GitHub.
name
brand-identity
description
Brand identity sets from one brief - logo, typography and colour palette built together, measured (contrast, colour blindness, glyph coverage, font licences, small-size logo renders) and compared side by side as identity cards, shown on the user's own site, then a brand guidelines kit (PDF, logo files, tokens) for the chosen set. Use for a new brand or any part of one (logo, fonts, colours, or a mix), for refreshing an identity, or for critiquing one, even if the user only says "branding".
license
MIT

Brand Identity

You are the designer. Scripts measure what is broken; you decide what is good. Every claim you make about a colour, typeface or mark is either measured by a script or labelled as judgement.

1. Intake: one message, only what blocks you

Ask in one message (skip anything the user or their site already answered):

  • For logo, type, palette each: new · refresh (they have one, evolve it) · keep (use as-is) · none.
  • How many sets: 3 (default), 2, 1 or 4.
  • Site URL or files; languages the brand writes in; does the product show numbers.
  • Only if still unknown: sector, audience, three attributes, 3–5 competitors.

With a site, run site extract first and ask only about what it could not tell you. Details: references/discovery-brief.md.

2. Flow and turn plan (~16–20 turns to the checkpoint)

Scripts: python3 <skill>/scripts/brand.py <command> (--help on each). Put independent commands in one turn. With uv the scripts fetch their own packages; if check lists missing ones, give the user its install line.

  1. check + init NAME --sets 3 --langs en,tr [--numbers] [--site URL] [--state logo=keep …] --sector … --audience … --attributes a,b,c --competitors x,y --tagline … --sentence en='…' --sentence tr='…' --nav A,B,C --cta … [--source logo=file.svg --source palette=#hex,#hex] (one turn). Sentence (one per brand language), nav and CTA are real brand copy for specimens and mocks, in the brand's voice. --source gives the asset of a keep/refresh part.
  2. Read references/cohesion.md, type.md, logo.md, ai-defaults.md, and color.md when a palette is wanted (one turn, ≤ 24 KB). Other cards only when their topic comes up.
  3. fonts search --class … --exclude-defaults and site competitors WORK url… when there are competitors.
  4. Write all sets in one sets.json (format: templates/sets.example.json): per set the identity fields, a partial palette (brand[] seeds, name, direction) and the symbol SVG inline.
  5. logos WORK → look at the contact sheet → fix one defect per mark (name it in logo.defect) → logos WORK → look. Two rounds; a third only to clear a gate or a cliché reading. Letter positions for details are in sets/X/logo/build/wordmark-glyphs.json.
  6. build WORK → look at review.png (not board.png, the user's large copy) → fix gates (re-run only the failing set with --sets X).
  7. Present the checkpoint (§5) and stop. Never pick for the user.
  8. After the pick: add 1–2 misuses of this mark (references/kit.md), then kit WORK/sets/X (--full for the long kit). Say which files are where.

mix WORK A:logo A:type B:palette --as D when the user asks for parts of different sets. critique for an existing identity (references/critique.md).

3. Making the sets

  • One mechanism per set: a single visual idea that produces the mark, the type choice and the palette together. Write it as one sentence before choosing anything. One expression move: the only loud thing.
  • Pick 2–4 decision axes for this brief and place each set on them (−2..+2). Sets should stand apart on at least two axes; inside a set the three parts sit at the same position.
  • Differentiate against the user's real competitors, not a generic list. Say in differs_by where the set stands apart.
  • Reflex test: for each font, colour and mark idea ask "would I propose this for another brand in this sector?" If yes, justify it from the brief in defaults_used[] (id = the flag's id or its logo tag) or change it. At least one set uses nothing from ai-defaults.md. "Feels warm" or "feels premium" is not a reason.
  • keep parts are constraints: build the new parts to fit them. If a kept part clashes, say so as a suggestion; never change it.
  • Mark recommended: true on the set you would defend, and know why.
  • Write all free text (names, mechanism, concept, rationale, labels) in the document language (init --doc-lang).
Show full SKILL.md (461 more words)Show less

4. Component craft

Logo (references/logo.md): a mark identifies, it does not explain. Write 4–6 one-sentence ideas per set, build one. Draw the symbol on a 100-unit grid from filled primitives; use data-op="subtract|union|intersect" for cut-outs and data-color="<palette role>" for colour; never <text>. Wordmarks come from the set's display face automatically; set case, tracking (1/1000 em) and tags (structure vocabulary in ai-defaults.md). Look at 16 and 32 px every round. Add symbol_small_svg when the mark clogs at small size. A wordmark-only set still needs (1) one ownable detail drawn on the outlined type with wordmark_detail_svg (wordmark coordinates: cap top y=0, baseline y=100, x in data-advance units; each shape is a data-op step, data-glyph="n" limits it to the n-th character) and (2) a designed small mark (symbol_small_svg or logo.monogram) for 16–48 px. Plain type with a first-letter favicon reads as stock. A detail shape with its own data-color stays a separate colour; data-glyphs elements take data-wght/data-opsz for a sturdier small cut. Role names resolve to UI tones; brand ids (brand-1) keep the exact brand hex; a main part under 3:1 on a ground is drawn in that ground's ink. app_icon_svg (100-unit grid) lets the tile be part of the icon. When the idea is a dark or coloured surface, set card.ground (dark or a role / brand id) so the card shows it.

Type (references/type.md): display carries the voice, text carries the reading. Pin every variable axis in location (large opsz for display, text size for text). Prefer Google Fonts (OFL); Fontshare is link-only; for a commercial face give the licence note and a rendered free alternative.

Colour (references/color.md): colour = hue + chroma + lightness + ground. Seeds go in the partial palette; palette_build options in identity.palette_build (extra: "#hex:Name:usage" for a colour with its own job). Logo colours are palette roles, never raw hex.

5. Checkpoint message (then stop)

Show the board image path and, per set, in this shape:

### A — <Set name>   ← recommended
<Mechanism, one sentence.> <Where it differs from the competitors.>
Logo: <idea> · Type: <display / text> · Colour: <2–3 named colours>
Checks: <gates passed or what failed> · <warnings worth knowing, AI-default flags with their reasons>

Then: "Pick a set (or ask for parts of different sets). I'll build the guidelines kit for it."

6. Honesty

  • Gates are measured failures: contrast, licence, glyph coverage, file validity, renders. Warnings are uncalibrated heuristics; say so when you mention them. In rationale[], evidence is measured (a script or site reading), judgement (yours), or the research levels strong | limited | practice.
  • Never claim a colour or font "converts" or "builds trust"; associations are weak and contextual.
  • Do not show a set you would not defend. Do not fake approval. Mock data is labelled as such.

7. Reference map

CardRead when
cohesion.mdevery Create run (axes, mechanism, mixing)
type.md · logo.md · ai-defaults.mdevery Create run with that component
color.mda palette is new or refresh
discovery-brief.mdintake is unclear
site-preview.mdsite extract or apply misbehaves
kit.mdafter the pick
accessibility.md · reproduction.md · tokens-export.mdcontrast questions · print · developer hand-off
critique.mdCritique mode

© fatihaydost, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 109 other files (scripts, references, assets) in skills/brand-identity of fatihaydost/brand-identity-skill.

  • SKILL.md
  • LICENSE
  • assets/ai-defaults.json
  • assets/fonts/catalog.json
  • assets/fonts/gf-latin-core.txt
  • assets/i18n/en.json
  • assets/i18n/tr.json
  • assets/languages.json.gz
  • assets/library/catalog.json
  • assets/library/classifications.json
  • assets/library/gallery.html
  • assets/library/stats.json
  • evals/evals.json
  • evals/trigger-evals.json
  • references/accessibility.md
  • … and 95 more

Open the folder on GitHubat commit 532742d

Compare with similar skills

Brand Identity next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brand Identity compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brand Identity this skillfatihaydost/brand-identity-skill130—~2kAutomated safety check: PassMIT
Creating Streamlit Themesiusztinpaul/designing-real-world-ai-agents-workshop512—~3.7kAutomated safety check: PassApache-2.0
Brand Dnathatrebeccarae/claude-marketing161—~1.8kAutomated safety check: PassMIT
Brand Identityarnabbagxd/Brand-building-skills729—~1.3kAutomated safety check: PassMIT
Brand Guidelinesnexu-io/open-design100k—~346Automated safety check: PassApache-2.0
Brand Identitycbrock84/headcount2k—~783Automated safety check: PassMIT

Similar skills

  • Creating Streamlit Themes

    iusztinpaul/designing-real-world-ai-agents-workshop

    Creating and customizing Streamlit themes. An agent skill from iusztinpaul/designing-real-world-ai-agents-workshop.

    512 GitHub stars~3.7k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Brand Dna

    thatrebeccarae/claude-marketing

    Extract brand identity from a website URL — voice, colors, typography, imagery, values, and target audience — into a structured brand-profile.json.

    161 GitHub stars~1.8k tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • Brand Identity

    arnabbagxd/Brand-building-skills

    Create a visual identity brief for a brand — logo direction, color palette, typography, imagery style, and design system foundations.

    729 GitHub stars~1.3k tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • Brand Guidelines

    nexu-io/open-design

    Apply Anthropic's official brand colors and typography to artifacts for consistent visual identity and professional design standards.

    100k GitHub stars~346 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Brand Identity

    cbrock84/headcount

    Defines and applies visual brand — logo usage, palette, typography, imagery direction, and the guidelines that keep expression consistent across product and marketing surfaces.

    2k GitHub stars~783 tokensUpdated 23 days ago
    Media & CreativeAuto-check passed
  • Web Design Expert

    curiositech/some_claude_skills

    Creates unique web designs with brand identity, color palettes, typography, and modern UI/UX patterns.

    244 GitHub stars~1.7k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed

Questions about Brand Identity

What does Brand Identity do?

Brand identity sets from one brief - logo, typography and colour palette built together, measured (contrast, colour blindness, glyph coverage, font licences, small-size logo renders) and compared…. Brand Identity is an agent skill from fatihaydost/brand-identity-skill. Brand identity sets from one brief - logo, typography and colour palette built together, measured (contrast, colour blindness, glyph coverage, font licences, small-size logo renders) and compared side by side as identity cards, shown on the user's own site, then a brand guidelines kit (PDF, logo files, tokens) for the chosen set.

When should I use Brand Identity?

Brand Identity fits situations like: any part of one (logo; for refreshing an identity; for critiquing one; even if the user only says branding.

How do I install Brand Identity in Claude Code?

Run `npx skills add fatihaydost/brand-identity-skill --skill brand-identity -a claude-code`. Or copy the skill folder (skills/brand-identity in fatihaydost/brand-identity-skill) into .claude/skills/brand-identity in your project. Claude Code loads it when a task matches its description.

How do I install Brand Identity in Codex?

Run `npx skills add fatihaydost/brand-identity-skill --skill brand-identity -a codex`. Or copy the skill folder (skills/brand-identity in fatihaydost/brand-identity-skill) into .agents/skills/brand-identity in your project. Codex loads it when a task matches its description.

Can I use Brand Identity in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fatihaydost/brand-identity-skill --skill brand-identity -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brand-identity, .gemini/skills/brand-identity, .github/skills/brand-identity and .opencode/skills/brand-identity in your project.

What does Brand Identity need to run?

Going by SKILL.md and its folder, Brand Identity needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Brand Identity access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Brand Identity safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Brand Identity use?

Brand Identity is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brand Identity use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 13k tokens, read only when the agent opens those files.

What are the alternatives to Brand Identity?

Skills that share tags, products or a category with Brand Identity: Creating Streamlit Themes (iusztinpaul/designing-real-world-ai-agents-workshop, 512 stars), Brand Dna (thatrebeccarae/claude-marketing, 161 stars), Brand Identity (arnabbagxd/Brand-building-skills, 729 stars) and Brand Guidelines (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brand Identity?

fatihaydost (a GitHub user) maintains it in fatihaydost/brand-identity-skill, which has 130 GitHub stars. The repository was last updated on October 10, 2026.

Source: fatihaydost/brand-identity-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.