Agent skill

Openprd Diagram Review

by DavidLam-oss in DavidLam-oss/obsidian-wechat-converter

生成并迭代 OpenPrd 图示产物,供用户确认或理解。适用于解释型 SVG、架构图、产品流程图、用户旅程、流程图、系统边界图、依赖图,以及 freeze 前的可视化评审场景。

MITAuto-check passed

Install Openprd Diagram Review

skills CLI
$ npx skills add DavidLam-oss/obsidian-wechat-converter --skill openprd-diagram-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install DavidLam-oss/obsidian-wechat-converter openprd-diagram-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/DavidLam-oss/obsidian-wechat-converter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/openprd-diagram-review .claude/skills/openprd-diagram-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
openprd-diagram-review
GitHub stars
335
Token cost
~724 tokens
SKILL.md length
185 words
Files
5 (incl. references)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

生成并迭代 OpenPrd 图示产物,供用户确认或理解。适用于解释型 SVG、架构图、产品流程图、用户旅程、流程图、系统边界图、依赖图,以及 freeze 前的可视化评审场景。

  • Works in 4 steps: 读取 skills/openprd-shared/SKILL.md → 重建当前工作区状态,判断用户究竟想确认什么 → 决定用户需要的是 → …
  • Tasks that involve Diagrams
  • SKILL.md covers 概览, 动手前, 图示类型选择 and 解释型 SVG 规则, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Openprd Diagram Review is an agent skill from DavidLam-oss/obsidian-wechat-converter. 生成并迭代 OpenPrd 图示产物,供用户确认或理解。适用于解释型 SVG、架构图、产品流程图、用户旅程、流程图、系统边界图、依赖图,以及 freeze 前的可视化评审场景。

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/cocoon-patterns.md`, `references/diagram-contracts.md` and `references/explanation-svg-patterns.md`).

The repository describes itself as: Obsidian 公众号排版(支持自定义 CSS和公众号贴图)、飞书云同步与多平台(小红书、知乎等)发布插件。Markdown 转微信文章 / Feishu docs / 知乎、小红书、今日头条等草稿,支持数学公式、本地图片、GIF 和 Mermaid。 The licence is MIT.

When your agent uses it

  • Tasks that involve Diagrams

Example prompts

  • “/openprd-diagram-review”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 读取 skills/openprd-shared/SKILL.md
  2. 重建当前工作区状态,判断用户究竟想确认什么
  3. 决定用户需要的是
  4. 不要虚构今天还不存在的 OpenPrd diagram 命令

What it can do on your machine

Read from SKILL.md and the folder at commit 3fef612. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Openprd Diagram Review loads about 724 tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 28 tokens; SKILL.md has 185 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~724
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from DavidLam-oss/obsidian-wechat-converter at commit 3fef612, republished under its MIT licence (© DavidLam-oss). 185 words, ~724 tokens.

Download SKILL.mdSave it as .claude/skills/openprd-diagram-review/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
openprd-diagram-review
description
生成并迭代 OpenPrd 图示产物,供用户确认或理解。适用于解释型 SVG、架构图、产品流程图、用户旅程、流程图、系统边界图、依赖图,以及 freeze 前的可视化评审场景。
<!-- OPENPRD:GENERATED
adapter=codex
source=openprd-diagram-review
version=0.1.19
checksum=d083b33bb31703a8
-->

OpenPrd Diagram Review

概览

这份 skill 用来判断当前需要哪种图:轻量解释图、正式 diagram contract,或需要用户往返确认的评审循环。不要把所有图都当成 freeze 前评审图;很多时候用户只是需要先看懂问题。

动手前

  1. 读取 skills/openprd-shared/SKILL.md
  2. 重建当前工作区状态,判断用户究竟想确认什么
  3. 决定用户需要的是:
    • explanation-svg 轻量解释图
    • architecture 视图
    • product-flow 视图
  4. 不要虚构今天还不存在的 OpenPrd diagram 命令

图示类型选择

当用户在问这些内容时,优先选 explanation-svg:

  • 为什么会这样
  • 这两个方案差在哪里
  • 当前状态怎么走到目标状态
  • 过去、现在、未来的关系
  • 因果、依赖、边界、风险传播
  • Agent 要向用户解释需求场景、问题结构、决策取舍或下一步路径

explanation-svg 是对话辅助。它可以用内联 SVG、HTML 片段或 Markdown 中的 SVG 代码块表达;它不需要写入 .openprd/engagements/active/,也不替代 openprd diagram、review.html、visual-compare 或测试证据。

当用户在问这些内容时,选 architecture:

  • 模块
  • 系统边界
  • 服务
  • 外部依赖
  • 可靠性 / 合规性问题
  • handoff 形态

当用户在问这些内容时,选 product-flow:

  • 用户步骤
  • 决策点
  • 正常路径 / 错误路径
  • onboarding 或旅程流程
  • 页面到页面、步骤到步骤的推进

如果两者都出现:

  • 当用户行为和流程仍不清楚时,先做 product-flow contract
  • 流程清楚后,再做架构评审
  • 如果只是为了让用户先理解取舍,不进入定稿评审,先给 explanation-svg

解释型 SVG 规则

  • 输出顺序优先是:一句结论、SVG 图、最多 3 条补充说明或开放问题。
  • 图中每个节点只放短标签和 1 行例子;正文解释放到图下,不要把 SVG 变成文字墙截图。
  • 优先使用 2 到 5 个节点、明确箭头、颜色分组、虚线边界、少量图例;避免复杂渐变、装饰背景和难读小字。
  • 适合的图形包括:双栏对比、时间线、状态转移、边界/责任图、决策树、风险传播、因果反推。
  • 图中用户可见文案跟随用户当前主语言;中文语境用简体中文,专有名词可保留,但不要在中文语境下整句英文。
  • 如果没有足够事实支撑图中的节点或箭头,先把缺口写成“待确认”,不要把推测画成事实。
  • 需要模板时读取 references/explanation-svg-patterns.md。

当前工具能力

当前 OpenPrd CLI 提供:

  • openprd diagram <path> [--open] [--json]

现在它主要渲染面向架构的 HTML / JSON 产物。

因此:

  • 对 explanation-svg,直接在对话或临时 HTML/SVG artifact 中生成轻量图,不声称已进入正式 diagram 评审
  • 对 architecture,直接调用内置命令
  • 对 product-flow,即使还没有专门渲染器,也先生成结构化 contract 和评审清单
  • 如果工具还没有专用流程渲染器,就不要假装它已经存在

语言规则

  • 所有用户可见标签和评审说明都跟随用户当前主语言
  • Diagram contract 是用户可见产物。当 locale 为 zh-CN 时,以下可见字段必须写成简体中文:
    • title、subtitle
    • components[].name、components[].subtitle、components[].details
    • flows[].label
    • summaryCards[].title、summaryCards[].items
    • sidePanels[].title、sidePanels[].items
    • reviewInstructions
  • 专有名词、产品名、协议名、API 名称、框架名和云服务名在翻译会降低清晰度时保持原样
  • 像 MotiClaw、Electron、TypeScript、CLI、API、JSON、NDJSON、dry-run、Host API、schema、waiting_approval 这类必要术语可以保留,但周围句子必须译成简体中文
  • 不要在 zh-CN diagram contract 里写完整英文句子。运行 openprd diagram --input 前,至少人工检查一遍并把英文偏重的可见文本改成简体中文
  • 如果对话语言混合,优先跟随最近几轮需求澄清中占主导的语言

评审循环

生成图示产物后:

  1. 展示或打开图示产物
  2. 请用户确认:
    • 是否缺了组件或步骤
    • 系统边界或泳道是否画错
    • 是否遗漏依赖或路径
    • 是否缺少错误路径或签核点
  3. 把未解决项继续保留为假设或开放问题
  4. 只有在可视化评审收敛后,才建议 freeze

需要时阅读这些参考资料

  • references/diagram-contracts.md:架构图和产品流程图 contract
  • references/explanation-svg-patterns.md:解释型 SVG 的触发场景、图形模板和文案边界
  • references/review-checklist.md:渲染后应该问用户什么
  • references/cocoon-patterns.md:从 Cocoon-AI/architecture-diagram-generator 借来的可复用模式

© DavidLam-oss, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in .codex/skills/openprd-diagram-review of DavidLam-oss/obsidian-wechat-converter.

  • SKILL.md
  • references/cocoon-patterns.md
  • references/diagram-contracts.md
  • references/explanation-svg-patterns.md
  • references/review-checklist.md

Open the folder on GitHubat commit 3fef612

Compare with similar skills

Openprd Diagram Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Openprd Diagram Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openprd Diagram Review this skillDavidLam-oss/obsidian-wechat-converter335—~724Automated safety check: PassMIT
Archify Diagramstt-a1i/archify82k—~2.9kAutomated safety check: PassMIT
JSON Canvasheyitsnoah/claudesidian2.6k18 repos~3.5kAutomated safety check: PassMIT
Diagram Designcathrynlavery/diagram-design49k1 repos~7.6kAutomated safety check: PassMIT
Fireworks Tech Graphtisfeng/Easydict15k1 repos~1.4kAutomated safety check: PassMIT
Excalidraw Diagramcoleam00/excalidraw-diagram-skill5k2 repos~6.1kAutomated safety check: PassNone

Similar skills

  • Archify Diagrams

    tt-a1i/archify

    Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.

    82k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • JSON Canvas

    heyitsnoah/claudesidian

    Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections.

    2.6k GitHub starsUsed in 18 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    49k GitHub starsUsed in 1 repo~7.6k tokens
    DevelopmentAuto-check passed
  • Fireworks Tech Graph

    tisfeng/Easydict

    Create precise SVG technical diagrams, export PNG or offline HTML, and animate supported semantic SVGs to GIF.

    15k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Excalidraw Diagram

    coleam00/excalidraw-diagram-skill

    Create Excalidraw diagram JSON files that make visual arguments.

    5k GitHub starsUsed in 2 repos~6.1k tokens
    DevelopmentAuto-check passed
  • Draw.io Diagram Studio

    Agents365-ai/drawio-skill

    Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.

    10k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check: notes

More from DavidLam-oss/obsidian-wechat-converter

All 14 skills in this repo
  • Openprd UI Context

    DavidLam-oss/obsidian-wechat-converter

    OpenPrd UI Context skill:区分 greenfield、brownfield 与局部修正,基于已确认 PRD、可选 CodeGraph 和本地证据提出专业 UI/UX 方向,并在用户确认后编译 PRODUCT.md、DESIGN.md 和 Impeccable handoff。

    335 GitHub stars~899 tokensUpdated yesterday
    Auto-check passed
  • Wechat AI Layout

    DavidLam-oss/obsidian-wechat-converter

    为 Obsidian 微信公众号转换器生成受约束的 AI 编排结果。只在需要把文章内容映射为公众号安全 block JSON、诊断编排结果、优化 layout schema、分析 fallback 介入原因时使用。遇到教程、案例、产品介绍、截图型内容时应优先考虑这个 skill。

    335 GitHub stars~498 tokensUpdated yesterday
    Auto-check passed
  • Openprd Test Strategy

    DavidLam-oss/obsidian-wechat-converter

    OpenPrd 测试策略分流 skill:按风险把任务分到单元、集成、端到端、人工、视觉、小程序、性能和安全验证,并要求 evidence-plan。

    335 GitHub stars~578 tokensUpdated yesterday
    Auto-check passed
  • Project Release

    DavidLam-oss/obsidian-wechat-converter

    Release workflow for obsidian-wechat-converter (version bump, release notes, tag and publish).

    335 GitHub stars~597 tokensUpdated yesterday
    Auto-check passed
  • Openprd Frontend Design

    DavidLam-oss/obsidian-wechat-converter

    OpenPrd 前端设计框架 skill:为界面、页面、视觉、样式和前端体验任务提供设计资产框架、审美立意、反 AI 味门禁和实现前方向评审规则。

    335 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed
  • Openprd Requirement Intake

    DavidLam-oss/obsidian-wechat-converter

    OpenPrd 需求入口与 PRD 分流 skill:判断用户可见需求类型和内部 L0/L1/L2 路由码,决定直接澄清、mini-plan 或正式 PRD,并选择通用 / 面向个人消费者场景 / 面向企业服务场景 / 以 Agent 为主要使用场景的 PRD 视角。对用户复述时不要直接把 consumer / b2b / agent 当展示词;这些枚举值只用于内部记录和命令。

    335 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

Questions about Openprd Diagram Review

What does Openprd Diagram Review do?

生成并迭代 OpenPrd 图示产物,供用户确认或理解。适用于解释型 SVG、架构图、产品流程图、用户旅程、流程图、系统边界图、依赖图,以及 freeze 前的可视化评审场景。. Openprd Diagram Review is an agent skill from DavidLam-oss/obsidian-wechat-converter.

When should I use Openprd Diagram Review?

Openprd Diagram Review fits situations like: tasks that involve Diagrams.

How do I install Openprd Diagram Review in Claude Code?

Run `npx skills add DavidLam-oss/obsidian-wechat-converter --skill openprd-diagram-review -a claude-code`. Or copy the skill folder (.codex/skills/openprd-diagram-review in DavidLam-oss/obsidian-wechat-converter) into .claude/skills/openprd-diagram-review in your project. Claude Code loads it when a task matches its description.

How do I install Openprd Diagram Review in Codex?

Run `npx skills add DavidLam-oss/obsidian-wechat-converter --skill openprd-diagram-review -a codex`. Or copy the skill folder (.codex/skills/openprd-diagram-review in DavidLam-oss/obsidian-wechat-converter) into .agents/skills/openprd-diagram-review in your project. Codex loads it when a task matches its description.

Can I use Openprd Diagram Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add DavidLam-oss/obsidian-wechat-converter --skill openprd-diagram-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openprd-diagram-review, .gemini/skills/openprd-diagram-review, .github/skills/openprd-diagram-review and .opencode/skills/openprd-diagram-review in your project.

What does Openprd Diagram Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Openprd Diagram Review is instructions for the agent only.

Does Openprd Diagram Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Openprd Diagram Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Openprd Diagram Review use?

Openprd Diagram Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openprd Diagram Review use?

About 724 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Openprd Diagram Review?

Skills that share tags, products or a category with Openprd Diagram Review: Archify Diagrams (tt-a1i/archify, 82k stars), JSON Canvas (heyitsnoah/claudesidian, 2.6k stars), Diagram Design (cathrynlavery/diagram-design, 49k stars) and Fireworks Tech Graph (tisfeng/Easydict, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openprd Diagram Review?

DavidLam-oss (a GitHub user) maintains it in DavidLam-oss/obsidian-wechat-converter, which has 335 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 10, 2026.

Source: DavidLam-oss/obsidian-wechat-converter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.