> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trybloom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Explore a Brand Skill

> Inspect a production-generated Brand Skill, download its complete folder, and give it to an agent.

A Brand Skill is a portable folder of instructions, references, and assets for one brand. It lets another agent or application work from the brand that lives in Bloom instead of reconstructing that context for every task. `SKILL.md` is the entry point: it tells an agent which supporting files matter.

This example was generated by Bloom from [Verso Coffee](https://www.verso.cafe/), a fictional demo brand owned by Bloom. It is an unmodified production export, not a template. Its supporting filenames, content, and assets are specific to Verso; other Brand Skills will differ.

<Note>
  A Brand Skill contains one brand's identity. The optional [Bloom
  Skill](https://github.com/trybloomai/bloom-skills) teaches an agent how to
  use Bloom.
</Note>

<Card title="Download the example Brand Skill" icon="download" href="/downloads/verso-brand-skill.zip">
  Download the unmodified production export shown below, then extract it as one folder.
</Card>

## Inside the folder

This is how the Verso example is organized. Every guidance filename is shown; repeated asset filenames are collapsed to one example.

<Tree>
  <Tree.File name="SKILL.md" />

  <Tree.Folder name="references" defaultOpen>
    <Tree.File name="brand-imagery.md" />

    <Tree.File name="brand-voice.md" />

    <Tree.File name="color-palette.md" />

    <Tree.File name="merchandise.md" />

    <Tree.File name="product-lineup.md" />

    <Tree.File name="typography.md" />

    <Tree.File name="ui-components.md" />
  </Tree.Folder>

  <Tree.Folder name="assets" defaultOpen>
    <Tree.File name="manifest.json" />

    <Tree.Folder name="images">
      <Tree.File name="1abf4261-61d0-4324-9477-45795da43fd9.png" />
    </Tree.Folder>

    <Tree.Folder name="fonts">
      <Tree.File name="830ea186acff-00-Bebas-Neue-400.ttf" />
    </Tree.Folder>

    <Tree.Folder name="favicon">
      <Tree.File name="2271cd7319612ea7.png" />
    </Tree.Folder>
  </Tree.Folder>
</Tree>

This ZIP contains nine brand images, ten font files, and one favicon. Those counts describe Verso, not a fixed Brand Skill schema. Keep the folder together: its Markdown uses relative paths to reach the references and packaged assets.

* `SKILL.md` is the entry point. It states the brand's core rules and routes each task to the right reference files.
* `references/` separates focused guidance so an agent can load only what the task needs.
* `assets/manifest.json` records the packaged image and font paths, descriptions, roles, and usage.
* `assets/images/`, `assets/fonts/`, and `assets/favicon/` keep the source material available locally.

## Selected contents

These excerpts show the route an agent follows: start with `SKILL.md`, then load the focused reference files needed for the task. `brand-voice.md` is one example of that second layer.

### `SKILL.md`

Every Brand Skill starts here. The entry point identifies the Skill, states its most important rules, and routes work to the supporting files:

```markdown theme={null}
---
name: verso-brand
description: Applies Verso's visual identity and voice to creative work that should have the company's look and feel. Use whenever company style or brand standards apply.
---

Verso is an artisan coffee company founded in 2019 that specializes in freshly roasted, single-origin coffee beans sourced directly from select farms and delivered to customers' doors.

### Global Brand Principles

- Emphasize freshness, direct trade ethics, small-batch roasting, and the morning brewing ritual across all creative touchpoints.

## Skill navigation

| Task | Required | Consider |
| --- | --- | --- |
| Write brand copy | [Brand voice](references/brand-voice.md) | [Merchandise](references/merchandise.md), [Product lineup](references/product-lineup.md) |
```

### `references/brand-voice.md`

For a writing task, `SKILL.md` routes the agent here for focused voice guidance. Other tasks route to other references:

```markdown theme={null}
Verso speaks with an artisan, warm, confident, and ritual-oriented tone that celebrates deliberate craft and daily morning habits.

- Core Slogan: "Freshly roasted single-origin coffee delivered to your door."
- Brand Motto: "Sourced With Purpose. Roasted To Order."
```

## Use it with an agent

A Brand Skill makes the same brand context reusable beyond Bloom. Instead of restating the brand in every prompt, extract the ZIP, give the folder to your agent, and ask for something concrete:

**Write**

```text theme={null}
Use the Verso Brand Skill to write a
product-launch email for Golden Hour.
```

**Design**

```text theme={null}
Use the Verso Brand Skill to design a
landing-page hero for Golden Hour.
Follow its color, typography, and imagery
guidance, and use a relevant packaged image.
```

**Review**

```text theme={null}
Review this campaign draft against the
Verso Brand Skill. Identify what is off-brand,
then revise it.
```

The agent starts with `SKILL.md`, then follows its routes to the guidance and assets needed for that request. For example, the email calls for voice and product guidance, while the landing page also needs imagery, color, and typography.

## Use your own brand

Use a Brand Skill through either Bloom interface:

* **MCP** — Ask a connected agent to inspect it. [Connect an agent to Bloom](/mcp/getting-started).
* **API** — Retrieve it for another system, either as structured data or a complete ZIP. [See the Brand Skill API guide](/guides/use-brand-skill).