用途：把反复出现的任务写成 SKILL.md，让助手在后续对话中按既定流程执行。技能是带 YAML frontmatter（name、description）和流程正文的 SKILL.md；若要做的是新能力（会执行动作的代码），应改为编写工具，而非技能。仅当任务会重复、流程不直观、且描述能匹配用户未预料的说法时才写；一次性工作直接做即可。写前先调用 skill() 列出已有技能，避免重复。
存放位置：~/.agents/skills/<name>/SKILL.md，<name> 用 kebab-case，尽量短且与现有列表不重名。
结构：frontmatter 含 name 与 description，正文是简洁流程。description 是技能选择时唯一可见内容，要写进用户可能说的动词和短语（如“write X”“fix Y”“check Z”），而非抽象概括；匹配不上用户措辞就不会加载。正文是流程不是文章，以 Use when… / Skip if… 开头，再列步骤，尽量 50 行以内，具体 bash 命令优于叙述，不要前言和总结。
步骤：先用 skill() 确认无覆盖并读最接近技能正文；选定名称；用一条命令写入文件：mkdir -p ~/.agents/skills/<name> && cat > ~/.agents/skills/<name>/SKILL.md <<'EOF' … EOF；随后调用 skill({name: '<name>'}) 验证正文能返回，frontmatter 拼写错误会静默导致无法发现。
限制：description 自动写入系统提示只在 mi 启动时发生，/reset 保留原系统提示；需重启 mi 才能自动加载新技能，在此之前只能按名称显式加载。