用途：为某产品的 Blume 文档站点撰写 agent 技能，即一个 SKILL.md 文件，用于教编码智能体正确使用该产品。Blume 站点本身已在 /skill.md 发布自动生成的技能（页面地图与一句话描述，不含模型），本技能负责写出真正讲清产品是什么、如何安装、核心概念与任务、以及易踩坑点的技能文件。
主要能力与要求：内容只能来自文档，每条声明、命令、配置键、标志、环境变量和代码示例都必须从 content root 的页面复制而非改写，不得凭记忆或同类产品补全；缺失内容应省略并在报告中列为文档缺口。只保留单个 SKILL.md，不含 references/、scripts/、assets/。链接使用绝对 Markdown 链接，格式为 <site><route>.md，首页为 <site>/index.md，且只能链接实际存在的页面。frontmatter 的 name 必须与提示中给定名称完全一致，以替换自动生成的技能。篇幅宜远低于 300 行，跳过通用编程、Markdown、HTTP 等智能体已知内容。
使用方式：先读 blume.config.ts 与 meta.ts，再读首页、快速开始或安装页、核心概念页、配置参考、API 参考概览及故障排查或 FAQ 页；若站点已构建，llms.txt 会列出所有页面。写作前先确定产品两三句话介绍、五到十个常见任务、必要概念与限制/默认值/常见错误/弃用项。技能结构包含 frontmatter（name、description，description 不超过 1024 字符）、产品简介、Setup、Core concepts、Common tasks、Gotchas、Where to look 等章节，无内容则省略。完成后运行 blume build，确认 skill.md 已替换且 .well-known/agent-skills/index.json 中名称只出现一次。
限制：手写技能不会像自动生成的那样自动更新，文档发生实质变化后需运行 blume skill 刷新，并在原文件上更新而非重写。具体命令、配置与平台细节以实际文档为准，资料未提供处暂未说明。