从0到1开发一个小红书Skill：Agent Skills格式实战记录

最近参加2026华为开发者大赛·小红书Skill创新赛，做了一个"小红书爆款笔记Skill"，把踩过的坑和经验记录下来，给想参赛的朋友参考。

一、Skill到底是什么文件结构

华为云的Skill遵循Agent Skills开放格式，一个Skill就是一个目录：SKILL.md（定义文件，唯一入口，必需）、references/（参考知识库）、scripts/（可执行脚本）、templates/（输出模板）、demo/（演示用例）。

SKILL.md由YAML frontmatter + Markdown正文组成。frontmatter里name（小写字母/数字/连字符）和description（1024字符内，第三人称）是必需的——description是智能体决定何时调用这个Skill的依据，得写清楚触发场景。

二、让Skill"自带质检"：写一个打分脚本

纯靠prompt约束，智能体经常偷懒。我的办法是把硬性规则写成自检打分脚本，生成完笔记必须跑分，低于85分不许交付：标题≤20字且带钩子（数字/悬念/警告）；正文400–800字；话题标签5–8个；必须有互动引导句；违禁词（最/第一/根治/保本等）命中直接扣大分。

"生成器+校验器"的结构，比单纯写长prompt可靠得多，强烈推荐。

三、发布流程的两步和一个坑

大赛官方指引是两步：先发到华为云Skill市场，再用redskillhub-upload发到小红书Skill市场。

实测发现两个关键点：redskillhub-upload是小红书官方的npm包（npm i -g redskillhub-upload），先--dry-run校验包，确认没问题再真发；小红书侧上传要创作者权限，publish前会先扫码登录，但登录成功不代表有上传权限——上传授权是单独校验的，这一步要提前准备，别等到截止前一天。

四、给参赛者的三条建议

1. 选题贴着主题走，主题契合度占评审30%，是权重最高的单项。
2. Skill的description认真写，它决定智能体什么时候想起你。
3. 早做发布链路验证，别把登录、权限、打包的问题留到最后。

祝大家都能拿奖！