Home / openbkn-ai / bkn-sdk · skills/create-bkn/SKILL.md · GitHub

create-bkn skillA

create-bkn is agent-read markdown (skill) from openbkn-ai/bkn-sdk: Guides creation of BKN (Business Knowledge Network) definition files following v2.0.1 spec. Covers network, object_type, relation_type, action_type, concept_group. Use when creating knowledge networks, BKN files, object types, relation types, action types, concept groups, or when user asks to model business knowledge in BKN format. When the openbkn skill is also loaded, use it to run the openbkn CLI (auth, bkn push) after files exist..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Create BKN

Generate well-formed BKN directories (Markdown + YAML frontmatter) per v2.0.1.

## Works with the openbkn skill

**create-bkn** authors the `.bkn` tree; the **openbkn** skill runs `openbkn auth login` and `openbkn bkn push` / `pull` after files exist.

## What is BKN

BKN is Markdown + YAML frontmatter for schema; one file per definition under typed subfolders. Details (sections, required tables, types) live in [references/SPECIFICATION.llm.md](references/SPECIFICATION.llm.md).

## Directory layout

```
{network_dir}/
├── SKILL.md
├── network.bkn
├── CHECKSUM                 # optional; SDK may generate
├── object_types/
├── relation_types/
├── action_types/
├── concept_groups/
└── data/                    # optional sample data; not read by `openbkn bkn validate`/`push`
```

## Workflow

1. **Gather requirements** — objects, relations, actions, optional concept groups
2. **Read spec** — [references/SPECIFICATION.llm.md](references/SPECIFICATION.llm.md) (format rules, sections, frontmatter types)
3. **Pick templates** — copy/adapt from [assets/templates/](assets/templates/) (`network_type.bkn.template`, `object_type.bkn.template`, …)
…

Read the whole file at its exact version.

How to install

Latest version
mdr add openbkn-ai/bkn-sdk/create-bkn@git:20260918.d7f989a
Exact content
mdr add openbkn-ai/bkn-sdk/create-bkn@sha256:481c267bd55e737c

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260918.d7f989a latest2026-09-18 d7f989a 7,968 BA view · diff
git:20260913.211e0c72026-09-13 211e0c7 7,892 BA view · diff
git:20260831.408b0ad2026-08-31 408b0ad 7,582 BA view · diff
git:20260701.fda7ed82026-07-01 fda7ed8 7,770 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7968 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

GitHub

openbkn-ai/bkn-sdk · 17 stars · license Apache-2.0 · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_igkrrzwvpobun5dv
GET https://markdownregistry.com/api/v1/resolve?ref=openbkn-ai/bkn-sdk/create-bkn
GET https://markdownregistry.com/api/v1/blob/481c267bd55e737c02408be7029130d1b771a564ba7ac3e6600457eb8d5cb0e8

Your agent 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.

More from openbkn-ai/bkn-sdk

AGENTS.md agents
openbkn-ai/bkn-sdk · AGENTS.md
git:20260921.39b42cd · audit A · 17 stars
DESIGN.md@docs design
openbkn-ai/bkn-sdk · docs/DESIGN.md
git:20260701.c863b0e · audit A · 17 stars
k8s-network skill
openbkn-ai/bkn-sdk · skills/create-bkn/references/examples/k8s-network/SKILL.md
git:20260701.fda7ed8 · audit C · 17 stars
create-skill skill
openbkn-ai/bkn-sdk · skills/create-skill/SKILL.md · Guides authoring of an OpenBKN Skill package (SKILL.md + references) that declares which knowledge-network capabilities…
git:20260918.d7f989a · audit A · 17 stars
demand-deliverability-assessment skill
openbkn-ai/bkn-sdk · skills/create-skill/references/examples/demand-deliverability-assessment/SKILL.md · Use when a user asks whether a product demand (an existing forecast or a new order) can be delivered on knowledge…
git:20260912.e67922d · audit A · 17 stars
openbkn skill
openbkn-ai/bkn-sdk · skills/openbkn/SKILL.md · 操作 BKN(Business Knowledge Network)平台的统一 CLI `openbkn` —— 知识网络 构建/查询(Schema:对象/关系/行动类型、指标、概念组;实例与语义搜索;…
git:20260918.d7f989a · audit A · 17 stars

Every file in openbkn-ai/bkn-sdk

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