openbkn SKILL.md skillA
openbkn from openbkn-ai/bkn-sdk is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add openbkn-ai/bkn-sdk/openbkn@git:20261015.478703bPins git:20261015.478703b in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- openbkn-ai/bkn-sdk
- Path
skills/openbkn/SKILL.md- Versions recorded
- 9
- Latest version
- git:20261015.478703b, committed Oct 15, 2026
- First version recorded
- Sep 14, 2026
- Size
- 15,057 bytes
- Repository stars
- 26
- License
- Apache-2.0
操作 BKN（Business Knowledge Network）平台的统一 CLI `openbkn` —— 知识网络 构建/查询（Schema：对象/关系/行动类型、指标、概念组；实例与语义搜索； push/pull/validate；从 Vega Catalog 建网）、资源、Vega Catalog 与 索引构建任务、Context Loader（MCP 检索）、模型工厂（大模型/小模型 CRUD、OpenAI 兼容对话/embedding/ rerank）、Skill 注册（zip 注册/下载/安装 + 生命周期）、Toolbox/Tool（上传、 导入导出、调用）、BKN Trace（第三方 Agent 受管 Conversation / Interaction / Operation、拉取 spans、用符号 规则 + LLM rubric 判定诊断一条 trace、scan、eval-set 构建、schema 校验）、 以及运营面（`openbkn admin`：组织/用户/角色 CRUD、行过滤策略、审计、模型管理）与认证 （token + OAuth…
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
# openbkn CLI
BKN 平台的统一命令行工具 —— 一个二进制，运维面收进 `openbkn admin` 子命令。
纯后端，无 Web UI。
## 第三方 Agent 业务问答硬门禁
- **业务问答必须受管**：每轮先调用 `bkn_start_interaction`，必传 `question`、`agent_name`（每轮同一名称）和 `conversation_mode`：首轮用 `new` 且不传 `conversation_id`，后续轮次用 `continue` 并传上一轮返回的 `conversation_id`。
- **只用权威 ID**：业务工具逐字使用 start 返回的 `conversation_id` 和 `interaction_id`，不得虚构、猜测或沿用示例值。
- **业务调用保持受管**：只通过携带上述 ID 的 Context Loader 工具访问 OpenBKN，Operation、重试和证据闭包由平台管理。
- **提交本轮结果**：回答生成后调用 `bkn_finish_interaction`；它只提交当前 Interaction 的结果，不关闭 Conversation。
- **错误即停止**：返回原始错误并遵循 `required_action`，不得降级到 CLI、Vega、ontology-query 或无受管上下文的调用。
详细合同见 [context.md](references/context.md)。
## 安装
```bash
npm install -g @openbkn/bkn-sdk # 提供 `openbkn` 命令
```
需 Node.js 22.19.0+。也可用 `npx @openbkn/bkn-sdk` 临时运行。
## 使用方式
```bash
openbkn [--base-url <url>] [--token <tok>] [--user <id|name>] \
[--json | --compact] [-k|--insecure] <group> <sub> [options]
```
- 默认输出为**人类可读表格**；`--json`（或 `--compact`）输出可被脚本解析的精确 JSON。
- `-k/--insecure` 关闭 TLS 校验（自签名平台）。`auth login -k` 会按平台记住，之后该平台的命令无需再带；免校验只作用于该平台的请求，不碰进程全局，无需 `NODE_TLS_REJECT_UNAUTHORIZED`。
…Read the whole file at its exact version.
How to install
mdr add openbkn-ai/bkn-sdk/openbkn@sha256:3fedba54e48db428The line at the top of this page pins the label git:20261015.478703b, 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.
[](https://markdownregistry.com/a/art_w4qucpcy234uewwc)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 9 versions of this file, between Sep 14, 2026 and Oct 15, 2026, about one every 4 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261015.478703b latest | 2026-10-15 | 478703b | 15,057 B | A | view · diff |
| git:20261014.2643cfc | 2026-10-14 | 2643cfc | 15,037 B | A | view · diff |
| git:20261013.ff9a8d7 | 2026-10-13 | ff9a8d7 | 15,080 B | A | view · diff |
| git:20260928.45b5698 | 2026-09-28 | 45b5698 | 14,421 B | A | view · diff |
| git:20260918.d7f989a | 2026-09-18 | d7f989a | 14,322 B | A | view · diff |
| git:20260917.2bcf0e9 | 2026-09-17 | 2bcf0e9 | 13,846 B | A | view · diff |
| git:20260917.a132d44 | 2026-09-17 | a132d44 | 12,736 B | A | view · diff |
| git:20260917.cdc4c16 | 2026-09-17 | cdc4c16 | 12,646 B | A | view · diff |
| git:20260914.822ed20 | 2026-09-14 | 822ed20 | 12,442 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (15057 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 link to a raw IP address
- pass: No script tag
Source
openbkn-ai/bkn-sdk · 26 stars · license Apache-2.0 · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_w4qucpcy234uewwc GET https://markdownregistry.com/api/v1/resolve?ref=openbkn-ai/bkn-sdk/openbkn GET https://markdownregistry.com/api/v1/blob/3fedba54e48db428c3b137e247d0e885ee3d2f80ff71fb08a09f915000f1c92d
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.