fixing-metadata
作者 ibelickfixing-metadata 技能用于审计和修复网页的 HTML metadata，适合需要被发现、可被索引并便于分享的页面。可用于前端页面、SEO 模板、营销页，以及共享布局默认项中需要纠正 title、description、canonical、Open Graph 标签、Twitter cards、favicon、JSON-LD 或 robots 指令的场景。
这个技能的评分是 74/100，说明值得收录：它提供了具体的 metadata 修复流程，触发条件明确、操作范围清楚；但在实操深度上仍有一些空缺。对目录用户来说，它很适合常规 SEO 和 meta 标签任务，适合安装使用，但与带有更多示例、检查项或配套资产的更完整技能相比，还没有那么自助完善。
- 对 metadata 工作的触发场景很明确：title、description、canonical、Open Graph、Twitter cards、favicon、JSON-LD 和 robots 指令都被直接点名。
- 流程具备实际可操作性：先识别问题，再优先处理重复与索引问题，对齐 title/description/canonical/og:url，并尽量只改 metadata。
- 对常见 Web SEO 任务的安装决策价值高：覆盖新页面、共享 SEO 组件、locale/canonical 路由以及分享预览。
- 没有附带支持文件、脚本或参考资料，用户只能依赖 SKILL.md 里的说明。
- 摘录中的层级/表格似乎有部分截断，这会降低对优先级规则和边界情况指导完整性的信心。
fixing-metadata 技能概览
fixing-metadata 的作用
fixing-metadata 技能用于审查和修复 HTML metadata，帮助页面做到可被发现、可被索引、也更适合分享。它覆盖 page title、meta description、canonical URL、Open Graph tags、Twitter cards、favicon、JSON-LD 和 robots 指令。
适合谁使用
如果你在交付前端页面、SEO templates、营销页面，或共享的 layout 默认配置，并且需要的不是“有 metadata 就行”，而是“metadata 必须正确”，那么就该用这个 fixing-metadata skill。它尤其适合 Frontend Development 工作流——也就是 metadata 分散在 app layouts、page components 或框架特定的 head 工具里时。
它为什么不一样
这个技能按优先级来处理问题：先修复重复项和索引问题，再统一 title、description、canonical 和社交标签，最后才去完善 icons 或 structured data。正因为如此，fixing-metadata guide 更适合落地使用，因为它强调的是会影响抓取和预览的决策，而不只是把标签补齐。
如何使用 fixing-metadata 技能
安装并找到核心说明
进行 fixing-metadata install 时，把这个技能加入你的 skills directory 或 workspace，然后先打开 SKILL.md。这个 repo 刻意做得很精简，所以真正有价值的是按该文件里的 workflow 和规则执行，而不是去寻找这里并不存在的辅助目录。
把模糊任务变成可用提示词
高质量的 fixing-metadata usage 一定从明确的页面或模板范围开始。不要只说“修 SEO”，而是要告诉 agent 页面类型、framework，以及具体的 metadata 问题。例如：“审查 Next.js 中的商品详情模板，并修复标题、描述、canonical、og:url、Twitter card 和 robots 标签，以处理可被索引的重复 URL。”
什么输入能提升输出质量
在要求修改之前，先提供页面列表、目标 URL、期望的 canonical 行为，以及任何品牌或 locale 规则。这个技能在你明确说明目标是新页面、模板默认值，还是对损坏的 metadata 进行修复时，效果最好，因为这几种场景需要的 tradeoff 并不一样。
实际工作流与检查重点
先从受影响的页面入手，把每个页面对应到必须一致的 metadata，然后在真实部署后的 URL 上检查结果，而不是只看 localhost。审查时尽量只看最小 diff：这个技能的目标是把变更限制在 metadata 上，而不是重构 layout 逻辑或无关的前端代码。
fixing-metadata 技能 FAQ
fixing-metadata 只用于 SEO 吗？
不是。fixing-metadata 技能同样能提升社交预览质量、app icons、manifest 设置和 structured data。SEO 是主要场景，但它真正解决的是让页面身份在搜索引擎、浏览器和分享平台之间保持一致。
我需要很强的基础才能用吗？
不需要。只要能说清页面名称和问题，初学者也可以使用这个 fixing-metadata skill。最关键的是给出具体目标，因为模糊请求往往会生成看起来正确、实际上并不适配对应 route 或 framework 的通用 metadata。
什么情况下不该用这个技能？
如果问题主要是内容策略、关键词研究或文案撰写，就不该用它。这个技能面向的是 metadata 的实现和验证，不负责在营销层面决定页面应该说什么。
它和普通提示词有什么区别？
普通提示词可能只会给出一次性的修复结果，而 fixing-metadata 还提供了按优先级、保持一致性、以及适合部署检查的 guided workflow。當你需要的 metadata 修改必须经得起 framework 渲染、canonical routing 和 share card 检查时，这种差别就很重要。
如何改进 fixing-metadata 技能
把准确的 metadata 表面交给技能
最有效的 fixing-metadata usage 应该包含页面 URL、route pattern、framework，以及当前已经存在的标签。如果你能直接贴出当前的 <head> 输出，或者相关的 layout component，agent 就能把注意力放在缺失项和不一致项上，而不是靠猜。
先说明最重要的规则
当你事先定义好 canonical 逻辑、locale 行为和 indexing 规则时，这个技能会表现得更好。比如，要明确 query parameters 是否应该 canonicalize 到干净路径，locale 变体是否需要 alternate URLs，以及 robots 是否应该对特定模板放行或阻止。
留意常见失败模式
最常见的问题包括 title 和 og:title 不一致、description 过于泛泛、canonical 指向错误 route，以及社交标签只在本地预览里正常。若想要更高质量的结果，应该要求 agent 在编辑前先验证所有 metadata source 之间是否一致。
在第一轮之后继续迭代
第一次修复完成后，要把已部署页面当作 crawler 和社交平台来验证。如果还有问题，就把具体症状反馈回去，比如重复 title、预览图错误或 canonical 错误，这样下一轮就能保持更小的范围，并保留其余前端实现不变。