Create brand tokens for apps and documents
brand-ymlskillsetup L2★352
posit-dev/skills ↗What it does
Create and use brand.yml files for consistent app/document branding
Best for
Design system owners ensuring Shiny apps and Quarto documents use consistent brand tokens without duplicating CSS.
Inputs
- · Brand guidelines: colors (primary, secondary, semantic), fonts (families, sizes), logos, company meta
- · Existing _brand.yml file path (for modification)
- · Brand context: company name, links, social
Outputs
- · YAML _brand.yml file with color palette, typography, logo paths, meta
- · Specification reference to brand-yml-spec.md
- · Integration instructions for Shiny (R/Python), Quarto, R Markdown
Requires
- · YAML-compliant editor
- · Shiny (R or Python) or Quarto for consumption
Preconditions
- · Brand guidelines document available
- · Logo files at known relative paths
- · Google Fonts or local font sources specified
Failure modes
- · Hex color format invalid (missing # or uppercase) → parsing silent failure
- · Font family referenced before defined in palette → undefined color reference
- · File paths relative instead of absolute → images/fonts not found at runtime
Trust signals
- · Decision tree with 7 explicit paths
- · Step-by-step file creation from brand guidelines
- · Minimum viable YAML example + progressively enhanced versions
- · Named best practices: hex format, lowercase hyphens, color palette before reference