关于 fixing-metadata
fixing-metadata 是用于审查和修正网页 HTML 元数据的技能,涵盖 SEO 与社交分享信息、结构化数据、图标和索引指令。它强调将修改限制在元数据范围内。
主要功能
- 01审查标题与描述
- 02检查规范链接和索引指令
- 03检查 Open Graph 与 Twitter 卡片
- 04涵盖图标、清单和主题色
- 05指导 JSON-LD 与语言区域元数据
适用场景
- 01查找重复或缺失的页面元数据
- 02统一规范链接与社交卡片网址
- 03为新页面或本地化页面设置元数据
- 04修正分享预览并限制代码改动范围
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ sickn33/ agentic-awesome-skills --skill fixing-metadata安装后在 Claude Code 中输入/fixing-metadata确认已加载。
详细介绍
适用场景
当你需要审查并修复 HTML 元数据时,请使用此技能,包括页面标题、meta 描述、规范 URL、Open Graph 标签、Twitter 卡片、网站图标、JSON-LD 结构化数据和 robots 指令。适用于添加 SEO 元数据、修复社交分享预览、审查 Open Graph 标签、设置规范……
工作流
- 找出缺失或错误的元数据页面(标题、描述、规范 URL、OG 标签)
- 按照下方优先级规则进行审查——先修复关键问题(重复内容、索引)
- 确保标题、描述、规范 URL 和 og:url 彼此一致
- 在真实 URL(而非 localhost)上验证社交卡片的显示效果
- 尽量缩小差异范围,只修改元数据——不要重构无关代码
适用情况
在以下情况下,请参考这些指南:
- 添加或修改页面标题、描述、规范 URL、robots 指令
- 实现 Open Graph 或 Twitter 卡片元数据
- 设置网站图标、应用图标、manifest、theme-color
- 构建共享 SEO 组件或布局元数据默认值
- 添加结构化数据(JSON-LD)
- 修改区域设置、备用语言或规范 URL 路由
- 发布新页面、营销页面或可分享链接
按优先级划分的规则类别
| 优先级 | 类别 | 影响 |
|---|---|---|
| 1 | 正确性与重复内容 | 关键 |
| 2 | 标题与描述 | 高 |
| 3 | 规范 URL 与索引 | 高 |
| 4 | 社交卡片 | 高 |
| 5 | 图标与 manifest | 中 |
| 6 | 结构化数据 | 中 |
| 7 | 区域设置与备用语言 | 低至中 |
| 8 | 工具边界 | 关键 |
速查
1. 正确性与重复内容(关键)
- 每个页面只在一个地方定义元数据,避免多个系统互相冲突
- 不要输出重复的标题、描述、规范 URL 或 robots 标签
- 元数据必须是确定的,不包含随机或不稳定的值
- 对任何用户生成或动态字符串进行转义和净化
- 每个页面都必须有安全的标题和描述默认值
2. 标题与描述(高)
- 每个页面都必须有标题
- 全站使用一致的标题格式
- 标题应简短易读,避免堆砌关键词
- 可分享或可搜索的页面应设置 meta 描述
- 描述必须是纯文本,不要包含 Markdown 或大量引号
3. 规范 URL 与索引(高)
- 规范 URL 必须指向该页面的首选 URL
- 仅在符合预期索引策略时使用 noindex;它不能代替私有页面所需的身份验证/授权访问控制
- robots meta 必须符合实际访问意图
- 在可能的情况下,预览页或暂存页面默认应设置为 noindex
- 分页页面必须采用正确的规范 URL 处理方式
4. 社交卡片(高)
- 可分享的页面必须设置 Open Graph 标题、描述和图片
- Open Graph 和 Twitter 图片必须使用绝对 URL
- 优先使用尺寸合适且宽高比稳定的图片
- og:url 必须与规范 URL 一致
- 使用合理的 og:type,通常为 website 或 article
- 适当设置 twitter:card,默认使用 summary_large_image
5. 图标与 manifest(中)
- 至少包含一个可在各浏览器中正常使用的网站图标
- 适用时包含 apple-touch-icon
- 使用 manifest 时,必须确保其有效并已正确引用
- 有意设置 theme-color,避免界面装饰颜色不匹配
- 图标路径应稳定且可缓存
6. 结构化数据(中)
- 除非 JSON-LD 能明确对应页面的实际内容,否则不要添加
- JSON-LD 必须有效,并反映页面实际呈现的内容
- 不要编造评分、评价、价格或组织信息
- 除非有必要,否则每个页面优先使用一个结构化数据块
7. 区域设置与备用语言(低至中)
- 正确设置 html lang 属性
- 存在本地化内容时,设置 og:locale
- 仅当备用语言页面确实存在时,才添加 hreflang
- 本地化页面必须按各自区域正确设置规范 URL
8. 工具边界(关键)
- 优先进行最小改动,不要重构无关代码
- 除非用户提出要求,否则不要迁移框架或 SEO 库
- 遵循项目现有的元数据模式(Next.js metadata API、react-helmet、手动设置 head 等)
审查指南
- 优先修复关键问题(重复项、规范链接、索引)
- 确保 title、description、canonical 和 og:url 保持一致
- 在获授权的真实 URL 上验证社交卡片;外部调试工具可能会抓取并公开提交的 URL,因此未经授权,不要提交私人或暂存内容
- 优先采用稳定、简单的元数据,避免花哨或动态的设置
- 将差异保持在最小范围,并仅涉及元数据
示例
用户请求:
审查并修复 HTML 元数据,包括页面标题、元描述、规范 URL、Open Graph 标签、Twitter 卡片、favicon、JSON-LD 结构化数据和 robots 指令。
限制
- 仅当任务明确符合其上游来源和本地项目上下文时,才使用此技能。
- 应用变更前,验证命令、生成的代码、依赖项、凭据和外部服务行为。
- 不要将示例视为环境专属测试、安全审查或用户批准破坏性或高成本操作的替代品。
评论
支持 Markdown