brand-yml SKILL.md skillA

brand-yml from posit-dev/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add posit-dev/skills/brand-yml@v1.1

Pins v1.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
posit-dev/skills
Path
brand-yml/SKILL.md
Versions recorded
4
Latest version
v1.1, committed Apr 20, 2026
First version recorded
Nov 21, 2025
Size
11,396 bytes
Repository stars
552
License
MIT

Create and use brand.yml files for consistent branding across Shiny apps and Quarto documents. Covers: (1) Creating new _brand.yml files, (2) Applying to Shiny (R and Python), (3) Using in Quarto, (4) Modifying existing files, and (5) Troubleshooting. Includes complete specifications and integration guides.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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

## Decision Tree

Determine the user's goal and follow the appropriate workflow:

1. **Creating a new _brand.yml file?** → Follow "Creating brand.yml Files"
2. **Using brand.yml in Shiny for R?** → Read `references/shiny-r.md`
3. **Using brand.yml in Shiny for Python?** → Read `references/shiny-python.md`
4. **Using brand.yml in Quarto?** → Read `references/quarto.md`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add posit-dev/skills/brand-yml@sha256:2fe8e36738342a42

The line at the top of this page pins the label v1.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7rajykzdvqkde4au.svg)](https://markdownregistry.com/a/art_7rajykzdvqkde4au)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Nov 21, 2025 and Apr 20, 2026, about one every 50 days.

versioncommittedcommitsizeaudit
v1.1 latest2026-04-20 28ffd91 11,396 BA view · diff
v1.12026-04-20 98af5ce 11,393 BA view · diff
v1.02026-02-20 0fabf07 11,729 BA view · diff
git:20251121.a9705652025-11-21 a970565 11,648 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11396 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

posit-dev/skills · 552 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7rajykzdvqkde4au
GET https://markdownregistry.com/api/v1/resolve?ref=posit-dev/skills/brand-yml
GET https://markdownregistry.com/api/v1/blob/2fe8e36738342a420e0df9bca550dc11d0dfe0edbb521b2cc6061cfafc8eb24d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from posit-dev/skills

AGENTS.md AGENTS.md file
posit-dev/skills · AGENTS.md
git:20261007.4d770f9 · audit A · 552 stars
alt-text SKILL.md skill
posit-dev/skills · alt-text/SKILL.md · Generate and improve accessible alt text for data visualizations and images in R packages and Quarto documents. Use…
v1.0 · audit A · 552 stars
deploy-to-connect SKILL.md skill
posit-dev/skills · connect/deploy-to-connect/SKILL.md · Deploy or publish Python and R content to a Posit Connect server using rsconnect-python or the R rsconnect package…
v4.0 · audit A · 552 stars
ggsql SKILL.md skill
posit-dev/skills · ggsql/ggsql/SKILL.md · Write ggsql queries — a grammar of graphics for SQL. Use when the user wants to create, modify, or understand a ggsql…
v1.1 · audit A · 552 stars
pr-create SKILL.md skill
posit-dev/skills · github/pr-create/SKILL.md · Creates a pull request from current changes, monitors GitHub CI, and debugs any failures until CI passes. Activate when…
v1.5 · audit A · 552 stars
pr-threads-address SKILL.md skill
posit-dev/skills · github/pr-threads-address/SKILL.md · Address PR review feedback by systematically working through every unresolved PR review thread on the current branch's…
v1.0 · audit A · 552 stars
pr-threads-resolve SKILL.md skill
posit-dev/skills · github/pr-threads-resolve/SKILL.md · Bulk resolve unresolved PR review threads on the current branch’s PR — typically after threads have been addressed…
v1.0 · audit A · 552 stars
create-release-checklist SKILL.md skill
posit-dev/skills · open-source/create-release-checklist/SKILL.md · Create a release checklist and GitHub issue for an R package. Use when the user asks to "create a release checklist" or…
v1.0 · audit A · 552 stars
maintainer-decline SKILL.md skill
posit-dev/skills · open-source/maintainer-decline/SKILL.md · Guide for drafting issue closure and decline responses as an open-source package maintainer. Use when helping compose a…
git:20260521.928d934 · audit A · 552 stars
release-post SKILL.md skill
posit-dev/skills · open-source/release-post/SKILL.md · Create professional package release blog posts following Tidyverse or Shiny blog conventions. Use when the user needs…
v1.0 · audit A · 552 stars
critical-code-reviewer SKILL.md skill
posit-dev/skills · posit-dev/critical-code-reviewer/SKILL.md · Rigorously review code or pull requests for correctness, security, accessibility, maintainability, tests, and edge…
v1.2 · audit A · 552 stars
describe-design SKILL.md skill
posit-dev/skills · posit-dev/describe-design/SKILL.md · Research a codebase and create architectural documentation describing how features or systems work. Use when the user…
v1.1 · audit A · 552 stars

Every file in posit-dev/skills

Browse by kind, by grade A, or by owner.