MiniCPM5 Skills

MiniCPM5 Skills 是 OpenBMB/MiniCPM 仓库里的官方 SKILL.md 包。Hugging Face MiniCPM5-2B 卡片 让编码智能体走这些 skill，而不是自己猜 vLLM 参数。2026-09-08 的 skills/ 目录有 17 个文件夹：部署路由器、后端 cookbook（transformers、vLLM、SGLang、llama.cpp、Ollama、LM Studio、MLX、ArcLight、vLLM-Ascend），以及微调 skill（TRL、LLaMA-Factory、ms-swift、Unsloth、xtuner、GGUF LoRA）。父仓库 Apache-2.0，约 10,360 star。这是给 Cursor / Claude Code 这类智能体用的 SKILL.md 包，不是 YouMind 市场里的 Skill。

若要权重本身，看 MiniCPM5-2B；若还不会加载 skill，看 Claude Skills；若要的是营销库而不是部署路由，看 Marketing Skills。

核心功能

• 先走路由器：minicpm5-deploy 先问 checkpoint、硬件和目标，再调用恰好一个后端 skill，并明确禁止内联命令。
• 后端矩阵：CUDA 服务器走 vLLM，昇腾 NPU 走 vLLM-Ascend，Apple Silicon 走 Ollama 或 MLX，CPU/低显存走 llama.cpp Q4KM。
• 微调 skill：TRL+PEFT、LLaMA-Factory、ms-swift、Unsloth、xtuner、GGUF LoRA。每个都对应 docs/ 下一页 cookbook。
• 路由器写明的坑：MiniCPM5-2B Think 模式采样（temperature=1.0, top_p=0.95）、128k 上下文参数、会搞坏旧 MLX 转换器的未绑定 lm_head。
• 验收：任意后端起来后，对 /v1/chat/completions 发 1+1=?，期望 HTTP 200。

限制：这些 skill 只认识 MiniCPM5-1B 和 MiniCPM5-2B。不会帮你部署 Qwen3.8-27B 或 DeepSeek。没有 checkpoint 就把整包塞进上下文，只会浪费窗口。

适用场景

• 刚拉下 openbmb/MiniCPM5-2B 的 Claude Code / Cursor 用户，不想背引擎参数。
• Apple Silicon 笔记本，应该落到 Ollama 或 MLX，而不是一份 CUDA 菜谱。
• 要在 TRL 或 LLaMA-Factory 上做 LoRA 的微调任务，而不是一句「写个 trainer」。

定价

快速开始

1. 打开 github.com/OpenBMB/MiniCPM/tree/main/skills。
2. 把 skill 文件夹拷进智能体的 skill 目录，或让智能体读 skills/minicpm5-deploy/SKILL.md。
3. 给出 MODEL_PATH（openbmb/MiniCPM5-2B 或含 config.json 的本地目录）。
4. 若还需要模型卡，确认 MiniCPM5-2B。

第一手资源：minicpm5-deploy SKILL.md。

常见问题

和模型页是一回事吗？

不是。MiniCPM5-2B 是权重。本包是 serve 和微调的智能体说明书。

能用 npx skills add 装吗？

MiniCPM5-2B 卡片给的是 GitHub 路径，不是一条 npx skills add。拷 skills/ 或 clone 仓库。

Mac 上会选 vLLM 吗？

不会。矩阵把 Apple Silicon 送到 Ollama（最省事）或 MLX（最快）。

替代方案

• MiniCPM5-2B：这些 skill 假定的权重。
• Claude Skills：Claude Code 如何加载 skill。
• Marketing Skills：转化和 SEO，不是模型 serving。

使用技巧

1. 引用 17 个 skill 文件夹、Apache-2.0、10,360 仓库 star，均来自 2026-09-08 复核的页面。
2. 从 minicpm5-deploy 起步，不要凭记忆贴 vLLM 命令。
3. 只有显存扛得住 128k 时才传 --max-model-len 131072。

总结

MiniCPM5 Skills 是面壁官方路由器，让智能体把 MiniCPM5 部署到正确引擎，而不是猜参数。从 skills 目录 开始，再决定 MiniCPM5-2B 是否已经覆盖你要的模型。