用途：把 PostHog 技能配置从旧的单一扁平 skills.yaml 迁移到新的按组分文件加 variants 的格式，适用于 PR 或分支里仍有顶层 "skills:" 数组的情况。
新格式：技能放在 transformation-config/skills/ 下，每个组一个文件。已有组包括 integration-skills.yaml（type: example，插件名 posthog-integration，后缀 -integration）、feature-flag-skills.yaml（docs-only，posthog-feature-flags，-feature-flag）、llm-analytics-skills.yaml（docs-only，posthog-llm-analytics，-llm-analytics）、logs-skills.yaml（docs-only，posthog-logs，-logs）、other-skills.yaml（docs-only，posthog-tools，无后缀）。
主要能力与差异：用 variants（非 variations）承载技能列表；type 设在组级而非单个技能（某 variant 可覆盖）；template 设在组级，每组有各自 SKILL.md 模板；shared_docs 可设在组级或每个 variant；组级 description 用 {display_name} 占位符按 variant 替换；组级 tags 与 variant 级 tags 合并；技能 ID 自动命名空间化为 {id}-{category}，如 integration 组中 nextjs-app-router 变为 nextjs-app-router-integration，other 类别不加后缀。variants 可覆盖 template 和 shared_docs。
迁移步骤：判断每个技能所属组；把技能作为 variant 加入对应的 transformation-config/skills/{group}-skills.yaml；删除 variant 的 type（从组继承，除非需不同）；保留 id、display_name、description（可选）、tags、docs_urls，以及 example 类型技能的 example_paths；删除旧的扁平文件。
限制：资料仅提供上述组、字段与步骤，未提供自动化迁移命令或脚本，需手工编辑；未说明校验方式与回滚方案。