huawei-cloud-openviking-embedding-switch SKILL.md skillB

huawei-cloud-openviking-embedding-switch from huaweicloud/huaweicloud-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add huaweicloud/huaweicloud-skills/huawei-cloud-openviking-embedding-switch@git:20261105.4bbed8a

Pins git:20261105.4bbed8a in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
huaweicloud/huaweicloud-skills
Path
skills/devtools/extensions/huawei-cloud-openviking-embedding-switch/SKILL.md
Versions recorded
2
Latest version
git:20261105.4bbed8a, committed Nov 5, 2026
First version recorded
Aug 17, 2026
Size
14,141 bytes
Repository stars
59
License
MIT

Switch OpenViking's embedding model to a local llama-server (or any OpenAI-compatible embedding endpoint) running inside a bwrap sandbox managed by job-env-manager. Handles the full lifecycle: detect current config, validate the target embedding endpoint, modify ov.conf, delete incompatible vectordb index when dimension changes, restart the openviking-server process in the sandbox, and verify the new collection dimension. Use this skill when the user wants to: (1) switch the OpenViking…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# OpenViking Embedding Model Switch

## 概述

Switch the embedding model used by OpenViking to a local llama-server or any OpenAI-compatible endpoint, with proper vectordb index rebuild and sandbox-safe restart.

> **⚠️ Single-purpose skill** — all operations go through the job-env-manager REST API (`http://127.0.0.1:8090`). Never run `openviking-server` directly on the host.

OpenViking is an AI context database that uses vector embeddings for semantic search. Its embedding model is configured in `ov.conf` under the `embedding.dense` section. When switching to a different embedding model (especially one with a different vector dimension), the existing vectordb index must be deleted and rebuilt — otherwise OpenViking raises `EmbeddingRebuildRequiredError` on startup.

> **⚠️ 维度变更必删索引且不可跳过:** 当目标模型维度与当前 `collection_meta.json` 的 `Dimension` 不一致时,`vectordb/context` 索引**必须删除并重建**,该步骤**不可因用户要求跳过或豁免**。若用户需要保留旧数据,必须先按**原维度**导出(备份原有 `vectordb/context`)再执行切换。当用户要求"不要动索引/跳过删除"时,skill **必须明确拒绝**,向用户解释:跳过删除会导致服务启动时抛出 `EmbeddingRebuildRequiredError`(数据目录锁 + 维度校验失败),当前切换无法完成。

## Architecture

```
OpenViking Embedding Model Switch
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add huaweicloud/huaweicloud-skills/huawei-cloud-openviking-embedding-switch@sha256:9651000bc43ef702

The line at the top of this page pins the label git:20261105.4bbed8a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mvbnaqrmx6dgw2ew.svg)](https://markdownregistry.com/a/art_mvbnaqrmx6dgw2ew)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Aug 17, 2026 and Nov 5, 2026, about one every 80 days.

versioncommittedcommitsizeaudit
git:20261105.4bbed8a latest2026-11-05 4bbed8a 14,141 BB view · diff
git:20260817.dd9416e2026-08-17 dd9416e 12,273 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:8090)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14141 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

huaweicloud/huaweicloud-skills · 59 stars · license MIT · pushed 2026-11-07 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_mvbnaqrmx6dgw2ew
GET https://markdownregistry.com/api/v1/resolve?ref=huaweicloud/huaweicloud-skills/huawei-cloud-openviking-embedding-switch
GET https://markdownregistry.com/api/v1/blob/9651000bc43ef7025b53eca195d1df807a74a2661db1c42f22988480b4918168

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from huaweicloud/huaweicloud-skills

huawei-cloud-agentorchard-find-skills SKILL.md skill
huaweicloud/huaweicloud-skills · skills/agentorchard/common/huawei-cloud-agentorchard-find-skills/SKILL.md · Search, discover, browse and install AI Gallery Agent skills via natural language. Triggers include: "AI Gallery", "AI…
git:20260901.083a756 · audit A · 59 stars
huawei-cloud-agentarts-obs-diagnosis SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/agentarts/huawei-cloud-agentarts-obs-diagnosis/SKILL.md · Observability no-data diagnosis skill for Huawei Cloud AgentArts agent-ops platform. Systematically diagnoses missing…
git:20260930.dabbbec · audit A · 59 stars
huawei-cloud-agentarts-otel-ingestion SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/agentarts/huawei-cloud-agentarts-otel-ingestion/SKILL.md · OpenTelemetry ingestion skill for Huawei Cloud AgentArts observability platform. Provides OTel telemetry data…
git:20260924.742ec33 · audit A · 59 stars
huawei-cloud-cloudrobo-asset SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/cloudrobo/huawei-cloud-cloudrobo-asset/SKILL.md · Manage the full lifecycle of CloudRobo assets — query repositories and catalogs, create/list/show/update/delete assets…
git:20261015.26c63fd · audit A · 59 stars
huawei-cloud-cloudrobo-data-pipeline SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/cloudrobo/huawei-cloud-cloudrobo-data-pipeline/SKILL.md · Guide users to create or revise custom CloudRobo pipelines from natural-language requirements, generating validated…
git:20261104.9745123 · audit A · 59 stars
huawei-cloud-cloudrobo-dataset SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/cloudrobo/huawei-cloud-cloudrobo-dataset/SKILL.md · Manage CloudRobo data processing (proc-tasks) and data evaluation (eval-tasks) — query algorithms…
git:20260911.a9d944c · audit A · 59 stars
huawei-cloud-cloudrobo-dispatch SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/cloudrobo/huawei-cloud-cloudrobo-dispatch/SKILL.md · Manage CloudRobo embodied-agent task dispatch (robo-dispatcher) — create embodied tasks that drive a robot via an…
git:20260908.11bbb39 · audit A · 59 stars
huawei-cloud-cloudrobo-infer SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/cloudrobo/huawei-cloud-cloudrobo-infer/SKILL.md · Manage CloudRobo inference services — deploy a model into a managed inference service, list/query deployed services and…
git:20260908.a9743de · audit A · 59 stars
huawei-cloud-cloudrobo-inference-adapter SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/cloudrobo/huawei-cloud-cloudrobo-inference-adapter/SKILL.md · Guides adapting a VLA model's inference server interface to the CloudRobo standard interface/protocol. Use this skill…
git:20261103.c6aca33 · audit A · 59 stars
huawei-cloud-cloudrobo-model-adapt-workflow SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/cloudrobo/huawei-cloud-cloudrobo-model-adapt-workflow/SKILL.md · One-stop workflow for adapting models on the CloudRobo platform. Chains 4 sub-skills…
git:20261105.21cb5db · audit A · 59 stars
huawei-cloud-cloudrobo-model-workflow SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/cloudrobo/huawei-cloud-cloudrobo-model-workflow/SKILL.md · Model development orchestration Skill covering asset query, model training, inference deployment, and real-robot…
git:20260910.c97166f · audit A · 59 stars
huawei-cloud-cloudrobo-npu-patcher SKILL.md skill
huaweicloud/huaweicloud-skills · skills/ai/cloudrobo/huawei-cloud-cloudrobo-npu-patcher/SKILL.md · Applies to adapting PyTorch-framework VLA models to Ascend NPU, fixing CUDA issues, or optimizing NPU performance…
git:20261104.1443652 · audit A · 59 stars

Every file in huaweicloud/huaweicloud-skills

Browse by kind, by grade B, or by owner.