schema 适合给已有文章、产品页或组织介绍补充机器可理解的信息。使用前必须有真实页面与事实来源；它能帮助组织 JSON-LD，但不能替你创造评价、价格或 Google 当前并不支持的展示资格。
安装与调用
在项目目录的终端运行下面的命令，只安装这个 Skill 到 Claude Code：
npx skills add coreyhaines31/marketingskills --skill schema -a claude-code
需要 Node.js 和可用的 npx。若使用 Codex，把 -a claude-code 换成 -a codex；在对话里明确要求使用 schema 并附上材料，不把终端安装命令当成任务提示。其他客户端应使用自身的技能选择入口。
先提供页面，而不只说要哪一种标记
把实际 URL、正文、发布日期、作者资料和现有 JSON-LD 给 Agent。先确定页面是什么，再决定使用哪些类型；官网首页与具体产品页不能只因为都属于一个公司就复制同一组字段。可以这样输入：
使用 schema 检查 article.html 和 existing-schema.json。
这是一篇有真实作者与更新时间的教程。请先列可支持的实体和字段，再生成 JSON-LD。
缺少的信息列为待补，不虚构评分、作者资历或发布日期。
区分 Schema.org 语法有效与 Google 当前支持的富结果要求，并给验证步骤。
官方 Skill 的类型示例是起点，不能当成 Google 当前所有富结果的资格列表。先打开目标功能的最新说明，确认适用页面、必填属性和限制，再填入实际字段。没有页面依据的评价分数、优惠和库存信息应删掉，而不是用示例值占位上线。
检查代码与页面讲的是同一件事
JSON-LD 放进模板后，确认内容与用户看到的标题、作者、价格或其他事实一致。多个实体可以关联，但标识应稳定，不能同一个组织在每页变成互不相关的对象。CMS 或插件已经输出类似代码时，先检查是否重复、冲突或引用了旧地址。
语法层面可以用 Schema.org 验证器检查；面向 Google 的目标功能再使用 Rich Results Test。两者回答的问题不同：词汇使用正确，并不代表搜索引擎支持这种增强展示。还要检查部署后的渲染结果，因为开发文件正确不代表线上模板确实输出了代码。
Google 明确说明，符合规则和测试通过也不保证富结果出现。完成后保存验证结果与检查日期，按页面模板抽样复查。产品或内容字段改变时同步更新标记，避免正文已经修改、结构化数据仍保留旧事实。不要为了追求搜索样式加入读者页面中根本不存在的内容。
从页面事实生成最小标记
先把页面类型与可见内容交给 Skill，而不是只说“帮我加 Schema”。例如一篇教程页可以提供标题、作者、发布日期、正文链接和面包屑；一个没有公开价格或库存的产品页，就不应为了填 Product 字段编造报价。让 Agent 先列“页面上能看到的事实—建议的标记字段—尚缺字段”，再生成 JSON-LD。一个页面可以有多个相关类型，但同一实体的名称、URL 和身份需要一致。
实现时要求标记与实际渲染页面保持同步。静态站点可以随页面模板输出；动态站点要确认客户端渲染或服务端输出的最终 HTML 中确实存在对应 JSON-LD。不要只检查源代码变量名，也不要把注释或占位符当成最终结构化数据。站点迁移或价格变化后，回归检查标记是否留下旧 URL 或旧产品信息。
发布前用结构化数据验证工具检查语法，再对照搜索平台针对相应富结果的资格要求。校验通过只说明格式和部分要求满足，不保证搜索结果一定显示增强样式。最重要的人工复核是：搜索用户在页面上能否看到 JSON-LD 所声称的事实。
示例：修复一篇文章上的旧作者资料
假设文章页面可见作者已经更换，但站点的 JSON-LD 仍由旧模板输出前任作者。给 Skill 当前页面 HTML、模板片段和编辑记录，输入：“使用 schema 对照可见文章与 Article 标记，列出不一致字段并修改模板示例。只修已经确认的作者、日期和 URL；不要添加评分、FAQ 或未出现在页面上的实体。”
验收时打开渲染后的页面，检查可见署名、结构化数据里的作者姓名和链接是否一致；再看其他文章是否共享模板，避免只修一个 JSON 文件。若检测工具报语法通过，但作者仍是旧人，说明格式校验并未解决事实错误。发布后重新测试代表页面；搜索结果是否显示富样式由平台决定，不能列为这次修复的完成条件。
多页面站点的一种接入方法
一个公开的 SEO 流水线把旧名 schema-markup 与站点结构、文案和 AI 搜索的 Skill 文本作为非交互 system prompt 指引读入，为每条路由生成 JSON-LD 草案。这展示了如何把标记建议放进多页面的开发流程，而不是证明搜索结果出现了富媒体卡片。草案仍要按页面可见事实与 Google 当前资格要求逐项复核。