1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | brand-yml-posit-dev-skills |
| 项目自述名称 | brand-yml |
| 作者/维护者 | Garrick Aden-Buie（@gadenbuie，Posit 工程师） |
| 来源链接 | https://github.com/posit-dev/skills/tree/main/brand-yml |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars | 443（合集仓库整体数字；属整个 posit-dev/skills 合集，不代表本技能自身热度） |
| Forks | 35（同上，合集整体） |
| 最新版本 | 1.1（SKILL.md 元数据） |
| 安装方式 | 见第 10 节 |
2. 功能介绍与亮点
brand-yml 帮助创建和维护 _brand.yml——用 YAML 描述配色、字体、Logo 等品牌规范的机器可读格式，一份文件同时驱动 Shiny 应用与 Quarto 文档的视觉呈现。
核心能力：从零指导生成规范文件；分别覆盖 Shiny（R）、Shiny（Python）、Quarto 三条集成路径；支持修改已有文件；内置故障排查指南（未生效、颜色不匹配、字体加载失败、YAML 语法错误）。
亮点：官方 Posit 出品，由规范核心贡献者亲自维护；一份声明式配置跨 Shiny/Quarto 两类产出、R/Python 双语言复用，无需为每个项目重写主题代码；主 SKILL.md 外配 5 篇专题参考文档，示例丰富；在仓库 README 中同时归入 Shiny 与 Quarto 两个分类，体现跨场景定位。
3. 适用场景
所属分类：前端与设计
适合需要为 Shiny 应用或 Quarto 文档统一视觉规范的 R/Python 开发者与数据科学团队：机构或产品要保持配色、字体、Logo 一致，且这套规范需跨多个项目、多种输出格式（网页、看板、幻灯片、PDF）复用时，用一份 _brand.yml 替代逐项目手写主题代码。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | SKILL.md 规范原生识别；仓库提供 /plugin marketplace add 与 /plugin install 官方安装路径 |
| Codex | ⚠️ 需适配 | 未见原生识别；通用安装工具 npx skills add（vercel-labs/skills）官方支持列表含 Codex，可经其转换安装 |
| OpenClaw | ⚠️ 需适配 | 同上，该工具为 OpenClaw 提供专用目录 ~/.openclaw/skills/ |
| Hermes Agent | ⚠️ 需适配 | 同上，该工具为 Hermes Agent 提供专用目录 ~/.hermes/skills/ |
5. 推荐理由
品牌一致性是很多团队做内部工具、数据看板、技术文档时容易被忽视又反复被要求补的一件事。这个技能把“改配色改字体”从每次手写主题代码变成维护一份 YAML，同时应用到 Shiny 应用和 Quarto 文档——对既要产出交互看板又要产出静态报告的团队尤其省心。官方出品、文档齐全、纯配置无代码执行风险。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 官方 Posit 出品，作者为 Posit 全职工程师、在 R 社区有一定关注度；近期被多篇独立技术博客提及，并有开发者受其启发另行实现了功能相近的个人版本；但作为合集中的单一子技能，尚未见到针对它自身的第三方 PR 或 Issue 讨论 |
| 可用性 | 8 | SKILL.md 与 5 篇参考文档结构完整、示例丰富，覆盖创建/修改/排错全流程；最近维护在 2026-04-20；纯 YAML 配置无付费依赖，仅 Shiny-Python 场景需额外安装 shiny[theme] |
| 安全性 | 9 | 该技能目录仅含 Markdown 参考文件，不含任何可执行脚本，不产生 shell 执行也不主动联网外发；MIT 许可证明确 |
安全检查清单： ① Shell 命令/权限：无，全部为指令文本与代码示例，由用户自行抄写执行 ② 联网外发：无（YAML 中引用 Google Fonts 属用户自身应用行为） ③ API Key/凭据：不涉及 ④ 可疑指令：已通读 SKILL.md 及全部 5 篇参考文档，未发现隐藏指令或混淆代码 ⑤ 作者信誉：Posit 全职工程师，身份公开可查 ⑥ License：MIT，明确 ⑦ 最近维护：2026-04-20（约 3 个月前）
综合评分（三项均值）：7.7
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与 brand-yml 的差异 |
|---|---|---|
| shiny-bslib-theming（posit-dev/skills 同仓库姊妹技能） | 专注单一 Shiny 应用内、用 bslib API 做程序化主题定制 | 需为每个 Shiny 项目单独写主题代码；brand-yml 用一份声明式 YAML 同时驱动 Shiny 与 Quarto，且跨 R/Python |
| Shadcnblocks-Skill（masonjames） | 面向 React + shadcn/ui + Tailwind，产出预制前端组件代码块 | 技术圈层完全不同，不覆盖 Shiny/Quarto 场景 |
8. 用户评价
该技能目前在第三方平台尚无针对其自身实现的具名用户评价。其所依据的 _brand.yml 规范已引起独立开发者关注——一位独立技术博主曾撰文介绍并另行实现了功能相近的个人版本 Skill，侧面反映该规范在 R/Quarto 社区已有一定认知度。
9. 其他补充
该技能在仓库 README 中同时归入 Shiny 与 Quarto 两个分类，体现跨场景复用定位；支持 R 与 Python 双语言生态。
10. 安装使用方式
- Claude Code Marketplace：
/plugin marketplace add posit-dev/skills，再经 UI 安装shiny或quarto分类 - Claude Code 直接安装：
/plugin install shiny@posit-dev-skills或/plugin install quarto@posit-dev-skills - 手动安装：
git clone https://github.com/posit-dev/skills.git，再cp -r skills/brand-yml ~/.config/claude-code/skills/ - 通用 CLI（多 Agent）：
npx skills add posit-dev/skills --skill brand-yml，可用--agent指定目标 Agent
安装后无需重启，编写 Shiny 应用或 Quarto 文档时提及品牌配色/字体/Logo 需求即可触发。Shiny-R 需 bs_theme(brand = TRUE)；Shiny-Python 需先 pip install "shiny[theme]" 并调用 ui.Theme.from_brand(__file__)；Quarto 在文档或 _quarto.yml 中声明 brand: _brand.yml 即可自动发现。
11. 注意事项
- 该技能来自多技能合集仓库，仓库整体 443 stars 为合集共享数字，不代表该子技能自身热度
- 最近一次维护在 2026-04-20，建议后续关注该子目录是否有新提交
- Light/Dark 双色模式目前仅 Quarto（1.8+）支持，R 与 Python 的 brand.yml 包尚未支持
- 覆盖范围限定在 Shiny 与 Quarto 两类产出，其他前端框架需自行改造消费逻辑