场景描述：

2026-11-07 在 AI Agent 开发实践中心（https://hands-on-agent.developer.huaweicloud.cn/）按「通用技能」目录选型时发现：目录把「通用-内容-小红书跨平台改写」列为可用技能，描述为「一份内容多平台改写分发」，链接指向 https://gitcode.com/agent-best-practices/xhs-cross-platform-rewrite 。

实测该仓库只有 1 个 README.md，全文仅一行标题「# 跨平台内容适配-小红书专属二次改写Skill」，没有 SKILL.md、没有脚本、没有模板和使用说明，clone 后无任何可用内容。逐仓核查组织主页 README（https://gitcode.com/agent-best-practices）列出的 19 个「通用技能」仓库：其余 18 个均含 SKILL.md（文件数 5~651），只有这 1 个是空壳；该仓库自身 Issue #1~#5 已有多位开发者反馈「仓库仅有标题、缺少技能实现」。

复现方式：

git clone --depth 1 https://gitcode.com/agent-best-practices/xhs-cross-platform-rewrite.git

find . -type f -not -path '*/.git/*' # 结果：仅 README.md

对照：对 19 个通用技能仓执行同样检查，统计 SKILL.md 是否存在，18 有 / 1 无。

影响：

项目目录是开发者选型的唯一入口。把占位仓库与 18 个可用技能并列、并给出完整功能描述，会让按「方式二：本地 clone 体验」「把 skills/xxx 放进 Agent 技能目录」操作的用户拿到一个不能用的技能；成长中心的去 Star、提 Issue 等实践任务也会把流量导向这里。目录目前靠人工维护，新增仓库时没有校验，后续还会出现同类脱节。

建议方案：

1）在目录条目增加显式状态（如「规划中·暂无实现」），把未实现项单独归入「规划中」小节，不与可用技能混排，并注明预期交付物；

2）补一个最小可用实现：SKILL.md + 一条输入/输出示例，让链接至少能跑通；

3）增加组织级自检：CI 遍历目录中所有仓库链接，检查 SKILL.md（或各仓约定的入口文件）是否存在，缺失即告警；顺带校验 Star 数、License 等长期不同步的字段。从机制上避免「目录说有、仓库里没有」。

备注：同一现象已在组织仓库以 Issue 形式反馈（https://gitcode.com/agent-best-practices/Readme/issues/172）。本条是从平台目录维护机制角度提改进建议，两者互为佐证，不是重复提单。