brand.yml Branding Helper
Creates and maintains _brand.yml files so Shiny apps and Quarto documents share consistent colors, typography, and logos.
Design & UIIntermediate★ 473⑂ 40AI score 9/10Last updated: Aug 17, 2026
What it does
- Turns brand guidelines (hex colors, fonts, logos) into a valid
_brand.ymlfile, built up incrementally from a minimal example. - Provides integration steps for Shiny for R (
bs_theme(brand = TRUE)), Shiny for Python (ui.Theme.from_brand()), and Quarto (document- and project-level). - Safely edits existing brand files while preserving palette and semantic color references.
- Includes troubleshooting checklists for branding not applying, mismatched colors, missing fonts, and YAML syntax errors.
- Ships common patterns: light/dark color modes, logo variants, multiple font weights, and color aliases mapped to Bootstrap names.
Who it's for
- R or Python developers and analysts building Shiny dashboards that must follow a corporate brand.
- Researchers and data teams publishing Quarto reports, slides, and dashboards.
- Design-system owners who want one reusable set of design tokens across projects.
Examples
- "Create a _brand.yml with primary #0066cc and the Inter font" → generates a minimal file, then extends typography and logos.
- "Apply this brand to my Shiny for Python app" → inserts
ui.Theme.from_brand(__file__)and reminds you topip install "shiny[theme]". - "Quarto isn't picking up my branding" → walks through file name, location,
_quarto.ymlpresence, and theme layering order.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/posit-dev/skills/HEAD/brand-yml/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the brand-yml folder from the GitHub repo posit-dev/skills into my ~/.claude/skills/brand-yml/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/posit-dev/skills.git /tmp/posit-skills && mkdir -p ~/.claude/skills && cp -r /tmp/posit-skills/brand-yml ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal (Terminal on macOS/Linux, Git Bash on Windows).
- Clone the repository:
git clone https://github.com/posit-dev/skills.git - Make sure the skills folder exists:
mkdir -p ~/.claude/skills - Copy this skill:
cp -r skills/brand-yml ~/.claude/skills/— keep the nestedreferences/folder intact. - Restart Claude Code and ask something like "create a _brand.yml for my company colors" to trigger the skill.
- For Shiny for Python usage, also run
pip install "shiny[theme]".
View source on GitHub ↗License: MIT