brand-yml

Create branded themes from _brand.yml for Shiny and Quarto projects.

466|38|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/posit-dev/skills --skill brand-yml
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brand-yml
Source: https://github.com/posit-dev/skills/tree/main/brand-yml
Command: npx skills add https://github.com/posit-dev/skills --skill brand-yml

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Centralizes branding assets and guidelines into a portable, auto-discoverable brand.yml file, enabling consistent styling across Shiny and Quarto projects.

Core Features & Use Cases

  • Centralizes color palettes, typography, logos, and meta information in a single _brand.yml.
  • Enables automatic discovery by Shiny (bslib) and Quarto for coherent branding across UIs and documents.
  • Supports light/dark variants, logo variants, and cross-framework usage for R and Python environments.

Quick Start

Place a _brand.yml at your project root and reference it in Shiny or Quarto frontmatter to apply a branded theme across projects.

Frequently Asked Questions about brand-yml

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I centralize branding assets for Shiny and Quarto projects?

You can centralize branding by creating a _brand.yml file that defines color palettes, typography, logos, and meta information, enabling consistent styling across Shiny and Quarto projects.

How does brand.yml apply consistent themes across R and Python environments?

The brand.yml specification validates your YAML frontmatter, allowing Shiny (bslib) and Quarto to automatically discover and apply coherent branded themes across R and Python environments.

Can I define light and dark theme variants in a single brand.yml file?

Yes, the _brand.yml file supports defining light and dark variants, along with logo variants, to ensure your branding adapts correctly across different UI modes and documents.

What is the best way to apply a branded theme to a Shiny application?

Place a _brand.yml file at your project root and reference it in your Shiny or Quarto frontmatter to automatically apply a validated, coherent branded theme across projects.

Does Quarto automatically discover branding settings from brand.yml?

Yes, Quarto automatically discovers the _brand.yml file to apply coherent branding and styling directly to your documents without requiring extensive manual configuration.

Why use a single _brand.yml file for project theming instead of separate configs?

Using a single _brand.yml file centralizes your branding guidelines into a portable format, preventing inconsistencies and ensuring coherent UI and document branding across Shiny and Quarto.