用途：让 book-mascots 图库与 $HOME/Documents/ws/ 下的同级图书/课程项目保持同步，假定在 $HOME/Documents/ws/book-mascots 内运行。
主要能力：列出 docs/mascots/ 中已有吉祥物；遍历同级项目中常见的吉祥物目录（如 docs/img/mascot/、docs/mascots/、docs/img/mascots/），要求含至少 3 个标准姿势 PNG 与 neutral.png（或 *neutral.png）；为未收录者创建 docs/mascots/<slug>/，复制所有 *.png，按优先级查找并复制提示词文件为 image-prompts.md，生成仅含标题、固定说明行与网格图库的 index.md；随后需由 Claude 手动为每个新 slug 补写 4–6 句介绍段落；重建 docs/list-mascots.md；按字母序重写 mkdocs.yml 的 Mascots: 导航段；打印导入数量、slug、总数及被跳过项目摘要。
使用方式：在项目根目录运行 python3 skills/update-mascots/update_mascots.py，脚本幂等，无新吉祥物时报告 0 new mascots；之后按报告中的新 slug 编辑 docs/mascots/<slug>/index.md 补写介绍段。姿势按固定顺序显示：neutral、welcome、tip、thinking、encouraging、warning、celebration；非标准姿势按字母序排在末尾。名称从 image-prompts.md 抽取，含手动覆盖项（cybersecurity→Sentinel the Fox、intelligent-textbooks→Axiom the Owl、pre-calc→Prema），可在脚本顶部 OVERRIDES 中新增。
限制：介绍段需人工写作，脚本不生成；物种象征与词源不得编造，存疑时以源提示词文件已确立的说法为准；同级项目无 site_url 时说明教材在建且不链接；不写营销化语言、表情符号或泛泛描述。