1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | VictoriaMetrics Skills |
| 作者/维护者 | VictoriaMetrics（开源时序数据库与可观测性套件官方团队） |
| 来源链接 | https://github.com/VictoriaMetrics/skills |
| 许可证 | Apache-2.0（GitHub API 确认） |
| GitHub Stars | 45（GitHub API） |
| Forks | 4（GitHub API） |
| 最新版本 | 1.1.0（仓库内 .claude-plugin/marketplace.json 版本号） |
| 安装方式 | npx skills add（skills.sh 通用安装器）或 Claude Code 插件市场 |
2. 功能介绍与亮点
这是 VictoriaMetrics 官方发布的技能合集，围绕自家可观测性产品线（VictoriaMetrics 指标库、VictoriaLogs 日志库、VictoriaTraces 链路追踪、以及异常检测组件 vmanomaly）打造，共 12 个 SKILL.md，分成三组插件：
- query（查询组）：
victoriametrics-query、victorialogs-query、victoriatraces-query、alertmanager-query——分别用 PromQL/MetricsQL 查指标、LogsQL 查日志、Jaeger 兼容 API 查链路、AlertManager API 管理告警与静默。 - diagnostics（诊断组）：
vm-trace-analyzer解析查询耗时 trace 定位慢查询；investigating-with-observability按“收集信号→限定范围→假设验证→交叉确认”四阶段协议编排指标/日志/链路的联合排查；victoriametrics-cardinality-analysis与victoriametrics-unused-metrics-analysis找出高基数标签与从未被查询的僵尸指标；stream-aggregation-helper设计流式聚合规则降低存储与查询负载。 - vmanomaly（异常检测组）：
vmanomaly-query、vmanomaly-config、vmanomaly-review——操作官方异常检测服务的 API、选型调参、审计既有配置。
所有技能均通过 curl 直连用户自己环境变量配置的 VictoriaMetrics 系列端点，不依赖额外的 MCP Server 中转，安装单元自包含。仓库由 VictoriaMetrics 团队成员（GitHub 用户 zekker6、hagen1778 等）持续维护，最近一次提交（新增 vmanomaly 插件）发生在 2 天前；一条社区 issue 请求“找出未使用指标的技能”已被实现为 victoriametrics-unused-metrics-analysis 并关闭，显示项目对用户反馈有实际响应。
3. 适用场景
所属分类：DevOps 与基础设施
已经在用 VictoriaMetrics 生态（该项目本身完全开源免费，可自托管）做指标/日志/链路监控的 SRE 或 DevOps 工程师，希望在 Claude Code 等 agent 里直接排查告警、分析慢查询、清理无用指标或调优异常检测，而不必手写一整套 PromQL/LogsQL 查询语句。
4. 跨 Agent 兼容性
- Claude Code：原生支持——README 提供
/plugin marketplace add与/plugin install命令，插件市场清单victoriametrics-tools明确列出三个插件。 - Codex / OpenClaw / Hermes Agent：支持——仓库同时通过通用安装器 skills.sh 分发（
npx skills add VictoriaMetrics/skills），该安装器的官方文档明确将 Codex、OpenClaw、Hermes Agent 列入其支持的 70 余个 agent 名单，可用--agent参数指定目标。
5. 推荐理由
VictoriaMetrics 官方亲自打造并持续维护，覆盖查询、多信号联合诊断、异常检测配置全流程，底层产品完全开源免费、无需额外 MCP Server 依赖，装上即可让 agent 用自然语言直接操作监控栈。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方出品（主产品 VictoriaMetrics 在 GitHub 拥有超万星的知名度），技能仓库本身 45 星、4 位真实贡献者，且有外部用户提交功能请求（如“找出未使用指标的技能”）并被采纳实现 |
| 可用性 | 8 | 一条命令即可通过 skills.sh 或 Claude Code 插件市场安装；需配置若干环境变量指向自建的 VictoriaMetrics/VictoriaLogs/VictoriaTraces 端点，属轻量配置；底层产品免费开源无付费门槛；最近一次提交在 2 天前，维护活跃 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | SKILL.md 声明的 allowed-tools 仅为 Bash(curl:*)、Agent、Read，不含任意 shell 执行 |
| ② 运行时联网行为 | 仅通过 curl 请求用户自行配置的 VictoriaMetrics/VictoriaLogs/VictoriaTraces/AlertManager/vmanomaly 端点，目标透明可控 |
| ③ 凭据处理 | 鉴权信息通过环境变量 VM_AUTH_HEADER 传入；vmanomaly 插件文档明确建议用权限位 0600 的 curl 配置文件存放认证头，属较严谨的做法 |
| ④ 可疑指令 | 抽查多份 SKILL.md 未发现混淆代码或隐蔽外发指令 |
| ⑤ 作者信誉 | VictoriaMetrics 为知名开源可观测性厂商，仓库贡献者为可查的真实团队成员，无刷星或造假迹象 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 维护时间 | 最近提交发生在 2 天前，活跃 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| SigNoz Agent Skills | SigNoz 官方技能包，覆盖告警创建、仪表盘生成、ClickHouse 查询等 | 多数技能依赖用户额外部署并配置独立的 SigNoz MCP Server 才能工作；本技能全部通过 curl 直连配置好的端点，无需搭建额外的 MCP 中间层 |
| Sigma Computing Agent Skills | 面向 Sigma BI 平台的 REST API 鉴权与数据模型管理技能 | 仅 2 个技能，聚焦商业智能报表建模，属企业级付费 BI 工具的配套能力，与面向开源监控栈的运维排查场景不同 |
| Grafana OSS 相关技能 | 面向 Grafana 仪表盘与告警配置 | 偏重可视化仪表盘编排；本技能更侧重指标/日志/链路的联合故障排查与基数优化等运维深度分析 |
8. 用户评价
DevOps 博主 Arseny Zinchenko（网名 setevoy）在其技术博客 rtfm.co.ua 发表的文章中记录了使用本技能包搭建 Kubernetes 故障排查 agent 的过程（2026 年 4 月 30 日）。文章提到，作者在“自建 MCP Server”与“直接使用 VictoriaMetrics 官方技能”之间选择了后者，原因是 MCP 虽然提供类型化工具，但查询语句的构造仍依赖模型自身推理，而技能可以直接封装标签结构与查询模式等环境专属知识；同时技能方案“无需在用户机器上额外拖入二进制文件，安装配置更简单”。该文章集成使用了 victoriametrics-query、victorialogs-query、alertmanager-query 三个技能。
9. 其他补充
仓库的 issue 列表公开显示了后续规划方向，包括“新增创建告警规则的技能”“新增创建仪表盘的技能”“新增文档检索技能”等待实现项，说明这套技能包仍在持续扩展查询与诊断之外的能力边界。
10. 安装使用方式
方式一：skills.sh 通用安装器
npx skills add VictoriaMetrics/skills
# 或只装指定技能
npx skills add VictoriaMetrics/skills --skill victoriametrics-query
# 指定目标 agent（如 codex / opencode 等）
npx skills add VictoriaMetrics/skills --agent codex方式二：Claude Code 插件市场
/plugin marketplace add VictoriaMetrics/skills
/plugin install query@victoriametrics-tools
/plugin install diagnostics@victoriametrics-tools
/plugin install vmanomaly@victoriametrics-tools安装后需在环境变量中配置对应端点后技能才能正常工作，常用变量包括：
VM_METRICS_URL # VictoriaMetrics 查询端点，如 http://localhost:8428
VM_LOGS_URL # VictoriaLogs 端点
VM_TRACES_URL # VictoriaTraces 端点（含 /select/jaeger 前缀）
VM_ALERTMANAGER_URL # AlertManager 端点（可选）
VM_AUTH_HEADER # 鉴权请求头，本地无鉴权环境可留空配置完成后即可用自然语言触发，例如“现在有哪些告警在触发”或“帮我分析这个慢查询的 trace”。
11. 注意事项
- 使用前提是用户已自行部署或托管了 VictoriaMetrics 系列产品实例（产品本身开源免费，但仍需自行运维）；若尚未使用该监控栈，本技能不适用。
vmanomaly插件是仓库中最新加入的部分（仅 1 次提交记录），成熟度低于查询与诊断两组插件，使用前建议先在测试环境验证。- 技能通过直接调用各产品的 HTTP API 工作，若团队已有独立的 MCP Server 方案，需自行评估是否与现有架构重复。