Agent skill

Kb

by finos in finos/morphir

Manages the Morphir knowledge base under kb/ — OKF bundles and concept documents.

Apache-2.0Auto-check passedKnowledge Management

Install Kb

skills CLI
$ npx skills add finos/morphir --skill kb -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install finos/morphir kb --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/finos/morphir.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/kb .claude/skills/kb && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kb
GitHub stars
213
Token cost
~2.2k tokens
SKILL.md length
1,042 words
Files
15 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Manages the Morphir knowledge base under kb/ — OKF bundles and concept documents.

  • Adding content to a bundle
  • SKILL.md covers The morphir kb command, When to use what, Rules that the tooling assumes and Where the implementation lives
  • Calls cargo
  • Creating a new bundle

What it does

Kb is an agent skill from finos/morphir. Manages the Morphir knowledge base under kb/ — OKF bundles and concept documents. Use when adding content to a bundle, creating a new bundle, checking the knowledge base for conformance or provenance drift, building or querying its SQLite index, managing intent through its lifecycle, recording or reading architectural decisions as Decision Records, or navigating, searching and listing its bundles, concepts and links.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including reference files (for example `references/authoring.md`, `references/checks.md` and `references/commands.md`).

It sits in Knowledge Management, covering Knowledge bases. It works with SQLite. The repository describes itself as: A universal language for business and technology. The licence is Apache-2.0.

When your agent uses it

  • Adding content to a bundle
  • Creating a new bundle
  • Checking the knowledge base for conformance
  • Provenance drift

Example prompts

  • “Use the kb skill to manage the Morphir knowledge base under kb/ — OKF bundles and concept documents”
  • “/kb”

Requirements

  • Pre-approved tools (allowed-tools): Bash(morphir kb *), Bash(cat *), Bash(ls *), Bash(find *), Bash(git *), Read, Edit, Write

What it can do on your machine

Read from SKILL.md and the folder at commit 95c1aec. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(morphir kb *)
    • Bash(cat *)
    • Bash(ls *)
    • Bash(find *)
    • Bash(git *)
    • Read
    • Edit
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • cargo

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kb loads about 2.2k tokens when it runs, and up to ~19k if it reads all its reference files. Until then it costs about 106 tokens; SKILL.md has 1,042 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~106
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~19k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from finos/morphir at commit 95c1aec, republished under its Apache-2.0 licence (© finos). 1,042 words, ~2,183 tokens.

Download SKILL.mdSave it as .claude/skills/kb/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.
name
kb
description
Manages the Morphir knowledge base under kb/ — OKF bundles and concept documents. Use when adding content to a bundle, creating a new bundle, checking the knowledge base for conformance or provenance drift, building or querying its SQLite index, managing intent through its lifecycle, recording or reading architectural decisions as Decision Records, or navigating, searching and listing its bundles, concepts and links.
allowed-tools
Bash(morphir kb *), Bash(cat *), Bash(ls *), Bash(find *), Bash(git *), Read, Edit, Write
metadata.version
0.1.0
metadata.lineage
descends from the morphir-scala kb skill 0.7.0, retargeted at the morphir CLI

kb — Morphir Knowledge Base Assistant

Manages kb/, the Open Knowledge Format knowledge base. Bundles live under kb/bundles/, optionally grouped a level deeper. kb/AGENTS.md is the source of truth for the conventions; this skill automates the mechanical parts of following them.

The morphir kb command

Everything runs through the kb subcommand of the Morphir CLI. It takes the same subcommands, flags, defaults, JSON shapes and exit codes as the Scala kb tool from morphir-scala, so a playbook written against that tool runs here. Where the reference implementation was wrong it is corrected rather than reproduced — a filter you pass is a filter that applies, and --json means JSON.

bash
morphir kb list
bash
morphir kb check --verbose

Every command accepts --json. Progress output goes to stderr, so --json on stdout is clean and pipeable — prefer it when you need to consume the result rather than read it.

Full flag reference: → references/commands.md

CommandDoes
listBundles and their concept counts; --bundle X lists that bundle's concepts
show --path /x.mdOne document: frontmatter, outbound links, heading outline
search --query XSearch titles, descriptions, tags and paths; --body to include prose
checkConformance and provenance findings; non-zero exit on errors
indexBuilds the SQLite index; --status reports its freshness
refreshBoth kinds of derived state; narrow with refresh markdown / refresh db
query --sqlRead-only SQL over that index
sync …Mirroring an upstream repository into a bundle — status, pull, push, diff
intent …Intent lifecycle — new, list, show, the transition verbs, check
decision …Decision Records — list, show
new-bundleScaffolds a bundle with index.md and log.md
add-conceptScaffolds a concept and wires it into the index and log

When to use what

Adding content to an existing bundle. Run add-concept to create the file and wire it up, then write the body yourself. The scaffold deliberately leaves a TODO comment rather than plausible-looking prose.

→ references/authoring.md before writing the body.

Writing or reviewing prose. Every concept body is written in one of three registers, chosen by its type:. The style cards are tool-neutral and live at styles/; voice.md there applies to all registers and includes the banned-pattern list (no em-dashes, no AI filler), diagrams.md says when a Mermaid diagram or SVG should replace prose narration of a flow or structure, and altitude.md sizes documents to capability stories: one narrative-home Design Note per capability in flight, with every fine-grained concept reachable from it.

type:RegisterCard
Playbook, tutorial, orientation, guidancearticlestyles/article.md
Design Note, Decision Record, Intent, synthesiswhite-paperstyles/whitepaper.md
Reference, Specification Section, Glossary, Data Dictionary, version-pinned notesreferencestyles/reference.md

Delegate drafting to the kb-writer subagent and review to the kb-reviewer subagent (.claude/agents/kb-writer.md, kb-reviewer.md), naming the target file and register in the dispatch. Writing inline is fine for small edits; still apply the cards. Style applies to new and touched content only; do not sweep existing prose.

Creating a bundle. Run new-bundle, then add it to the Bundles table in kb/README.md and to the group's README.md if it is in a group. The command reminds you; it does not edit those files, because their wording is a judgement call.

Checking the knowledge base. Run check. It reports structural problems (missing type, broken links, unindexed concepts, frontmatter that does not parse) and provenance drift (commit-pinned sources whose reference checkout has moved on). Nothing here touches the network.

→ references/checks.md for the catalogue and how to fix each finding.

Searching and locating. search scans the markdown and is always current. For anything heavier — full-text search over bodies, "what links here", orphaned concepts, tag or provenance distributions — build the SQLite index once and query it.

bash
morphir kb index
bash
morphir kb search --query "entry point" --index

The index is derived state under .dev/kb/index.db, gitignored, and rebuilt from the markdown. It has no automatic invalidation — morphir kb index --status lists files changed since the last build.

Keeping derived state honest. morphir kb refresh does both halves in one pass: it rewrites index bullets that have drifted from their concept's description, then rebuilds the SQLite index if anything changed.

Show full SKILL.md (398 more words)Show less
bash
morphir kb refresh --dry-run

Narrow it when you only want one half — morphir kb refresh markdown or morphir kb refresh db, equivalently --no-db and --no-markdown. Reach for it after editing descriptions or adding concepts, and before relying on a query. --add-missing also appends entries for unindexed concepts, which is opt-in because it has to pick a section.

→ references/index-db.md for the schema, the views, and worked queries.

Managing intent. Features, enhancements and bugs are recorded as prose in the intent bundle, with a lifecycle whose obligations are enforced — most importantly, releasing requires linking the Capability it produced.

→ kb/CONTEXT.md for the vocabulary — states, kinds, and what each obliges; references/commands.md for flags.

Recording a decision. Architectural decisions are the knowledge base's third register, alongside Intent and Capability: past-tense, immutable, and superseded rather than edited. morphir kb decision list and morphir kb decision show read them; morphir kb check validates their supersession links.

→ references/decisions.md for the frontmatter, the checks and how to supersede one.

Mirroring an upstream repository. A bundle may declare a sync.yaml and carry upstream's own files rather than a paraphrase of them. Markdown lands as concepts with an injected, fenced block of kb-owned frontmatter; everything else lands as byte-identical assets. morphir kb sync push deletes exactly that fenced region, so what goes back upstream is what came from it.

bash
morphir kb sync status

→ references/sync.md for the manifest, the lockfile and the state model.

Finding divergence in the content. check finds mechanical inconsistency. Contradictions between what two concepts assert — the thing that actually matters in a knowledge base — cannot be detected by a script.

→ references/divergence.md for that procedure.

Rules that the tooling assumes

  • A bundle root is a directory whose index.md carries okf_version. That is how bundles are discovered.
  • Only index.md and log.md are reserved. Every other .md file inside a bundle is a concept and needs type:. The reservation stops at a mirror boundary — inside a vendored subtree those names are upstream's own files.
  • A grouping directory gets a README.md and never an index.md. README.md inside a bundle is an error.
  • Sub-directory index.md files carry no frontmatter.
  • Index bullets mirror the target concept's description. Changing one means changing the other.

Where the implementation lives

The morphir kb command is implemented in Rust, in the morphir-okf (format model and parsing) and morphir-kb (knowledge-base operations) crates under ecosystem/morphir-rust/crates/, wired into the CLI in crates/morphir. Develop and test it there with cargo test; this skill only documents the command surface.

© finos, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 14 other files (references) in .claude/skills/kb of finos/morphir.

  • SKILL.md
  • references/authoring.md
  • references/checks.md
  • references/commands.md
  • references/decisions.md
  • references/divergence.md
  • references/index-db.md
  • references/sync.md
  • styles/README.md
  • styles/altitude.md
  • styles/article.md
  • styles/diagrams.md
  • styles/reference.md
  • styles/voice.md
  • styles/whitepaper.md

Open the folder on GitHubat commit 95c1aec

Compare with similar skills

Kb next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kb compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kb this skillfinos/morphir213—~2.2kAutomated safety check: PassApache-2.0
Wiki Builderrohitg00/pro-workflow2.9k—~1kAutomated safety check: PassNone
Knowledge Base Managementchubbyguan/chubbyskills1.2k1 repos~3.3kAutomated safety check: PassMIT
Kb Workflowwillynikes2/knowledge-base-server182—~1.1kAutomated safety check: PassMIT
Capture Conversationoutline/outline41k—~474Automated safety check: PassCustom licence
Project CairniBlinkQ/project-cairn2352 repos~861Automated safety check: PassMIT

Similar skills

  • Wiki Builder

    rohitg00/pro-workflow

    Start, structure, and grow a persistent research wiki indexed in pro-workflow's SQLite knowledge base.

    2.9k GitHub stars~1k tokensUpdated 9 days ago
    Knowledge ManagementAuto-check passed
  • Knowledge Base Management

    chubbyguan/chubbyskills

    管理本地 Markdown/Obsidian 知识库:素材入库、健康检查、增量索引、关键词与 semantic-lite 检索、逐字原文资料包、归档和 MCP 连接。用于搜索知识库、整理资料及为 Agent 准备可定位的引用。

    1.2k GitHub starsUsed in 1 repo~3.3k tokens
    Knowledge ManagementAuto-check passed
  • Kb Workflow

    willynikes2/knowledge-base-server

    Use before starting any non-trivial task to search the knowledge base for context, and after completing work to capture findings.

    182 GitHub stars~1.1k tokensUpdated 3 days ago
    Knowledge ManagementAuto-check passed
  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Project Cairn

    iBlinkQ/project-cairn

    Standardize how an AI-collaboration project turns work into reusable knowledge.

    235 GitHub starsUsed in 2 repos~861 tokens
    Knowledge ManagementAuto-check passed
  • LLM Wiki Knowledge Graph

    Egonex-AI/Understand-Anything

    Detects a Karpathy-pattern LLM wiki and builds an interactive knowledge graph with entities, implicit relationships and topic clusters.

    86k GitHub starsUsed in 1 repo~1.5k tokens
    Knowledge ManagementAuto-check passed

More from finos/morphir

  • Technical Writer

    finos/morphir

    Assists with writing and maintaining Morphir technical documentation.

    213 GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • A skill your agent uses when adding, adopting, debugging or updating Morphir CLI examples and morphir itest scenarios, including scenarios.md, .feature.md and .feature files, scenario metadata, Rego…

    213 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Release Manager

    finos/morphir

    Assists with Morphir CLI release management for finos/morphir, including pre-release verification, extension verification, version bumps, tagging, and release coordination.

    213 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • PR Monitor

    finos/morphir

    A skill your agent uses when asked to babysit or watch a PR, when watching an open pull request, after opening or pushing to a PR, or when asked to monitor CI, review comments, merge conflicts…

    213 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check: warnings

Works with

Questions about Kb

What does Kb do?

Manages the Morphir knowledge base under kb/ — OKF bundles and concept documents. Kb is an agent skill from finos/morphir. Manages the Morphir knowledge base under kb/ — OKF bundles and concept documents.

When should I use Kb?

Kb fits situations like: adding content to a bundle; creating a new bundle; checking the knowledge base for conformance; provenance drift.

How do I install Kb in Claude Code?

Run `npx skills add finos/morphir --skill kb -a claude-code`. Or copy the skill folder (.claude/skills/kb in finos/morphir) into .claude/skills/kb in your project. Claude Code loads it when a task matches its description.

How do I install Kb in Codex?

Run `npx skills add finos/morphir --skill kb -a codex`. Or copy the skill folder (.claude/skills/kb in finos/morphir) into .agents/skills/kb in your project. Codex loads it when a task matches its description.

Can I use Kb in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add finos/morphir --skill kb -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kb, .gemini/skills/kb, .github/skills/kb and .opencode/skills/kb in your project.

What does Kb need to run?

Going by SKILL.md and its folder, Kb needs the command-line tools its instructions call (cargo). Its frontmatter pre-approves these tools: Bash(morphir kb *), Bash(cat *), Bash(ls *), Bash(find *), Bash(git *), Read, Edit, Write.

Does Kb access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kb safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kb use?

Kb is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kb use?

About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 17k tokens, read only when the agent opens those files.

What are the alternatives to Kb?

Skills that share tags, products or a category with Kb: Wiki Builder (rohitg00/pro-workflow, 2.9k stars), Knowledge Base Management (chubbyguan/chubbyskills, 1.2k stars), Kb Workflow (willynikes2/knowledge-base-server, 182 stars) and Capture Conversation (outline/outline, 41k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kb?

finos (a GitHub organization) maintains it in finos/morphir, which has 213 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 8, 2026.

Source: finos/morphir on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.