HTML 元数据修复技能（Fixing Metadata）

技能简介

Fixing Metadata 是一款审计并修复网页 HTML 元数据的 Agent Skill，专注于标题、描述、canonical、robots、语言设定、Open Graph/Twitter 卡片、图标与 JSON-LD 等字段。网页元数据缺失或不一致，会直接损害搜索引擎收录与社交平台分享预览——同一页面出现重复标题、canonical 互相冲突、robots 指令写错，都会让重要页面从索引中消失。本技能能逐页审计这些字段，指出遗漏、重复、可读性差与不一致之处，并在不替换既有元数据体系的前提下给出聚焦的修复建议，同时遵循项目所用框架的既有模式。来源 GitHub 仓库 ibelick/ui-skills，MIT 许可，Skillstore 质量分 82，属银级（silver）。

核心能力

1. 标题与描述审计：检查页面标题与描述是否缺失、重复、可读性差或前后不一致。
2. 索引信号检查：核对 canonical URL、robots 指令、locale 设定与多语言 alternate 关系。
3. 社交预览校验：审查 Open Graph 与 Twitter 元数据的 URL 一致性、卡片类型与绝对图片路径。
4. 图标与清单核对：评估 favicon、应用图标、manifest 与主题色引用是否有效。
5. 结构化数据审查：检查 JSON-LD 的合法性与是否与用户可见内容一致。
6. 框架模式遵循：沿用项目既有的框架模式，保持元数据改动聚焦且不破坏现有体系。

安装配置

1. 通过 Skillstore CLI 一键安装：npx skillstore add ibelick/fixing-metadata。
2. 也可直接从 GitHub 仓库 ibelick/ui-skills 的 skills/fixing-metadata 目录获取组件。
3. 该技能适配 Claude、Codex 与 Claude Code，风险因素涉及外部命令，安装后无需额外密钥。
4. 建议在项目根目录运行，以便技能读取框架配置与页面文件。

使用步骤

1. 指定要审计的页面或文件，例如某个营销页、路由文件或布局组件。
2. 向技能提出请求，如「审计这个页面的元数据，找出缺失或重复的标题、描述与 canonical 冲突」。
3. 技能逐项检查索引信号、社交卡片、图标与 JSON-LD，并列出问题清单。
4. 按建议在对应框架模式内做聚焦修复，不整体替换既有元数据系统。
5. 修复后重新审计，确认标题唯一、canonical 一致、robots 正确、社交图片为绝对路径。

适用场景

1. 新营销页上线：在页面发布前审查搜索与分享所需的核心元数据。
2. 修正索引信号：解决重要页面间的重复标题、冲突 canonical 与错误 robots 指令。
3. 统一共享元数据：对齐框架默认值与页面级覆盖，不改动既有元数据体系。
4. 多语言站点维护：核对 locale 与 alternate 关系是否正确。
5. 社交分享优化：确保 Open Graph 与 Twitter 卡片图片、类型与地址正确。

适用人群

• 前端工程师与全栈开发者：负责页面元数据与 SEO 基建。
• SEO 与增长团队：关注收录、索引信号与分享预览效果。
• 独立开发者与内容站长：需要快速定位并修复元数据问题。
• Web 框架维护者：希望统一项目内的元数据规范。

工作原理

技能把审计拆为「逐字段检查 → 交叉核对 → 聚焦修复」三步：先扫读页面的标题、描述、canonical、robots、locale 与 alternate，再核对 Open Graph、Twitter 卡片、图标/manifest 与 JSON-LD 是否与可见内容一致；随后对照搜索引擎与社交平台的常见要求，指出遗漏、重复与冲突。修复阶段遵循项目框架的既有模式，只做聚焦改动，不改写整体元数据架构。它只审计与建议，不自动部署，所有改动需开发者确认后落地。

注意事项

• 仅针对静态元数据字段，不评估运行时渲染或 JS 注入的元数据。
• 修复建议需在项目框架内落地，避免破坏既有元数据系统。
• 社交图片应为绝对路径，否则预览可能失效。
• robots 指令改动影响收录，务必谨慎确认。
• 定期复查，避免内容更新后元数据再次过期。

官方链接

• 技能主页：https://skillstore.io/skills/ibelick-fixing-metadata
• 源码仓库：https://github.com/ibelick/ui-skills
• 许可协议：MIT