1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | shiny-bslib | GitHub API / SKILL.md |
| 作者/维护者 | Posit PBC（官方 posit-dev/skills 仓库），主要作者 Garrick Aden-Buie（Posit Shiny 工程师） |
GitHub API / 作者资料 |
| 来源链接 | https://github.com/posit-dev/skills/tree/main/shiny/shiny-bslib | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 所属仓库 443★ / 35 forks（该数字属整个 posit-dev/skills 合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | SKILL.md 标注 version 1.0；子目录最近一次提交 2026-05-28 | 仓库提交历史 / SKILL.md |
| 安装方式 | npx skills add 或 Claude Code 插件市场一条命令安装（见第 9 章） |
仓库 README |
2. 功能介绍与亮点
shiny-bslib 是 Posit 官方 Agent Skills 合集中专攻 Shiny 应用现代化界面搭建的技能，覆盖 bslib（R 的 Bootstrap 5 封装包）的核心用法。
核心能力：
- 页面布局函数选型：
page_sidebar()、page_fluid()、page_navbar()等现代页面结构 - 响应式栅格系统
layout_column_wrap()、卡片card()、指标卡value_box()、侧边栏、填充式布局的组合方式 - 现代交互组件：accordion、tooltip、popover、toast 及 bslib 风格输入控件
- 主题基础用法（与姊妹技能 shiny-bslib-theming 衔接进阶定制）
- legacy 迁移指南：从
fluidPage/fluidRow/column/tabsetPanel/wellPanel/shinythemes等旧版 Shiny 写法对照迁移到 bslib 现代写法
亮点：由负责 Shiny 本身开发的 Posit 工程师撰写并持续维护；2026-05-28 的一批提交专门同步了 bslib 0.11.0 版本发布带来的接口变化，说明该技能紧跟上游真实版本节奏，而非一次性生成后搁置。同仓库另有 brand-yml、shiny-bslib-theming 两个姊妹技能可配合做进一步的品牌与主题定制。
3. 适用场景
固定分类：前端与设计
- 用 R Shiny 构建仪表盘或应用界面、希望采用 Bootstrap 5 现代样式而非陈旧
fluidPage写法的开发者 - 需要把存量 Shiny 应用从 legacy 布局迁移到 bslib 的团队
- 需要卡片、指标卡、侧边栏导航等标准仪表盘组件、又不想手写 CSS 的数据科学从业者
- 需要 tooltip、popover、accordion 等现代交互控件、提升 Shiny 应用可用性的场景
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库 README 给出
/plugin marketplace add posit-dev/skills与/plugin install shiny@posit-dev-skills两种一条命令安装路径 - Codex：官方 README 将 Codex 列为
npx skills add通用安装 CLI 支持的 agent 之一（“Claude Code, Codex, Cursor, Cline, and many more”），理论支持，但未见针对 Codex 的专用清单目录佐证 - OpenClaw：未验证——官方材料未提及，技能遵循标准 SKILL.md 格式，理论上可通用安装
- Hermes Agent：未验证——官方材料未提及
（仅基于已抓取材料判断，未为兼容性单独发起搜索）
5. 推荐理由
Shiny 是 R 生态最主流的交互式 Web 应用框架之一，但许多开发者与 agent 仍停留在 fluidPage 等十年前的旧 API 上，写出的界面样式陈旧、缺乏响应式布局。bslib（Bootstrap 5 封装）是 Shiny 官方推出的现代化 UI 方案，但 page_sidebar()、layout_column_wrap()、value_box() 等新 API 与 legacy 写法差异较大，agent 缺乏专项指导时容易混用两套体系或漏用新特性。shiny-bslib 由负责 Shiny 开发的 Posit 工程师本人整理，把现代页面布局、组件与 legacy 迁移路径收敛成可直接复制的代码模板，能帮助初中级 Shiny 开发者快速搭出美观、响应式的仪表盘界面。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Posit PBC 官方仓库出品（RStudio/Shiny/Quarto 的制造商），主要作者是 Posit 现任 Shiny 工程师；子目录自身 9 次提交，最近一次（2026-05-28）对应 bslib 0.11.0 版本发布的同步更新；仓库 issue 区有 ≥3 位独立具名开发者参与技术讨论，其中包括 R 生态知名开发者 |
| 可用性 | 9 | 一条命令（npx skills add 或 Claude Code 插件市场）即可安装；SKILL.md 含 Quick Start 代码示例与 legacy 迁移对照表；2026-05-28 有实质性更新，维护活跃；纯开源 R 包指导，无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① 执行 shell 命令——无 scripts/ 目录，SKILL.md 内容为供用户复制进自己项目的 R 代码示例，技能自身不执行任意 shell 命令
② 联网外发数据——技能本身不联网，仅指导用户在 R 代码中调用公开 CRAN 包（bslib）
③ API key/凭据——不涉及任何凭据
④ 未发现可疑指令——抓取 SKILL.md 全文未见 prompt injection 或混淆代码迹象
⑤ 作者信誉——Posit PBC 官方仓库，主要提交者 GitHub 资料确认现任 Posit Shiny 工程师
⑥ License——MIT，明确
⑦ 维护时间——最近一次提交 2026-05-28，在近 3 个月内
综合评分：8.3（三项均值）
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 shiny-bslib 的差异 |
|---|---|---|
| frontend-design（anthropics/skills） | Anthropic 官方通用前端美学指导技能，面向任意 Web 框架给出配色、字体、动效等设计方向建议 | 面向“任意框架的视觉美感”，不涉及具体组件 API；shiny-bslib 聚焦 R Shiny 这一特定框架，直接给出可复制的 bslib 函数调用与迁移路径，是更具体的实现层指导 |
| Shadcnblocks-Skill（masonjames） | 面向 React/Next.js 生态，基于 shadcn/ui 组件库批量拼装页面区块 | 服务前端 JS/TS 技术栈；shiny-bslib 服务 R 数据科学技术栈，两者面向完全不同的开发者群体与语言生态 |
| shiny-bslib-theming（同合集内） | 姊妹技能，专攻 bslib 进阶主题定制（Bootswatch、自定义 Sass、暗色模式） | 解决“布局与组件怎么搭”；shiny-bslib-theming 解决“搭好之后怎么调配色主题”，两者互补、可配合使用 |
差异化总结：shiny-bslib 的定位是“R Shiny 生态的现代化组件与布局指南”，填补了主流 agent 技能库里少见的 R/Shiny 前端开发场景，而不是在已经拥挤的 React/Vue 组件生态里再添一个同质技能。
8. 用户评价
该技能目前在第三方平台尚无针对 shiny-bslib 子技能本身的具名评价。Posit 官方仓库 issue 区可见独立开发者对整个 posit-dev/skills 技能集合的正面反馈：R 生态知名开发者 wlandau 就技能测试与验证规范发起过技术讨论；另一位开发者在阅读该仓库后表示计划参考其经验为自己团队搭建类似的技能集合，并认为其完整度好于自己此前手写的同类文档。以上两条评论针对整个技能集合，非专门评价 shiny-bslib 子技能。
9. 安装使用方式
- Agent Skills CLI：
npx skills add posit-dev/skills --skill shiny-bslib（仅装该子技能）或npx skills add posit-dev/skills --all（装全部技能） - Claude Code 插件市场：
/plugin marketplace add posit-dev/skills，再执行/plugin install shiny@posit-dev-skills - 手动安装：
git clone https://github.com/posit-dev/skills.git后，将shiny/shiny-bslib目录复制到对应 agent 的技能目录
安装后注意事项：按插件方式安装会连带装入同目录下的 shiny-bslib-theming 子技能；若只需要本技能，可单独复制 shiny/shiny-bslib 目录（内容不依赖姊妹技能）。安装后无需重启，agent 会在涉及 Shiny UI 布局、bslib 组件、Bootstrap 5 仪表盘搭建的对话中自动触发。SKILL.md 明确假设使用者已具备基本 Shiny 知识。
10. 注意事项
- 该技能面向 R 语言 Shiny 框架，不适用于其他语言或前端框架的 UI 开发
- Codex 支持基于官方 README 的文字列举，未见专用清单目录佐证，建议使用前自行验证实际安装效果
- OpenClaw、Hermes Agent 的兼容性目前均无官方或可靠第三方材料佐证，两个生态的用户使用前建议先自行验证基本安装流程
- 该技能所属仓库自 2025 年 11 月创建以来历史较短（约 8 个月），长期维护稳定性有待观察
- 主题深度定制（暗色模式、自定义 Sass、Bootswatch 换肤）超出本技能范围，由姊妹技能 shiny-bslib-theming 覆盖