brand-yml

SKILL.md

brand.yml Skill

Create and use _brand.yml files for consistent branding across Shiny applications and Quarto documents.

What is brand.yml?

brand.yml is a YAML-based format that translates brand guidelines into a machine-readable file usable across Shiny and Quarto. A single _brand.yml file defines:

Colors - Palette and semantic colors (primary, success, warning, etc.)

Typography - Fonts, sizes, weights, line heights

Logos - Multiple sizes and light/dark variants

Meta - Company name, links, identity information

File Naming Convention

Standard name: _brand.yml (auto-discovered by Shiny and Quarto)

Custom names: Any name like company-brand.yml (requires explicit paths)

Location: Typically at project root, or in _brand/ or brand/ subdirectories