broccolito/biookf/biookf-merge

Claude Code and agent skill by broccolito/biookf

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Use to merge a Secondary KB (SKB) onto a canonical Main KB (MKB): candidate matching, true-match collapse, carry-over, source-node union, raw/ relocation, documentation style/language harmonization, subtype harmonization, integrity check.

Install

npx vskill@latest install broccolito/biookf/biookf-merge

SKILL.md

The same SKILL.md was published earlier as broccolito/biookf/biookf-merge.

Skill: biookf-merge

Merge an SKB onto the MKB. The MKB is canonical (it is the active KB): its identifiers, file paths, raw/ locations, and subtype names win on every collision; the SKB side is the one renamed/moved/collapsed. Lose no information, break no links: whenever an SKB identifier or raw/ path changes (collapse or rename), rewrite every reference to it (edge object, primary_source, reported_in object) so nothing dangles. (Adhere to SCHEMA.md + docs/04.)

Loop

  1. bokf set-active <mkb-id>; pass the SKB path explicitly (this encodes MKB-is-canonical).
  2. Identifier resolution. Compare MKB index.md vs SKB index.md; surface exact AND

semantically-similar candidates across the two KBs only (never within one). When the index isn't enough, open the node .md files and reason over synonyms/xref/body. A Disease facet and its Phenotype facet are distinct; do not collapse.

  1. Collapse true matches only. Keep the MKB identifier; concatenate the SKB node's edges: into

it; combine bodies/frontmatter, discarding nothing (on direct contradiction, keep both, each tagged with its source). Then rewrite every reference to the vanished SKB identifier (edge object, primary_source, reported_in object) so nothing dangles.

  1. Carry over the rest. Any SKB node with no match / judged different: append to MKB index.md

(on identifier collision rename the SKB entity, then rewrite all refs to it); move its .md into knowledge/<type>/.

  1. Source nodes merge the same way; on collapse, union their raw_source + xref.
  2. `raw/`. Relocate SKB raw/ files into the MKB raw/ (rename on filename collision; drop a

true duplicate by content), and update raw_source paths. Do not dedupe edges here; that is a future lint pass.

  1. Documentation harmonization. Bring every SKB-origin doc now in the MKB into the MKB's house

style and language: rewrite/condense verbose prose to the MKB's concision and section structure, and translate into the MKB's language when the SKB differs. Change prose only. Keep frontmatter, edges:, raw_source, xref, statistics, notes, and all links byte-identical, and preserve every fact, number, and citation exactly. The raw originals stay untouched in raw/.

  1. Subtype resolution. Harmonize equivalent-but-differently-named subtypes to the MKB name;

find-and-replace the token on both nodes and edges; update the subtypes-in-use list.

  1. Log + gate. bokf stats <mkb> if you need counts, then

bokf log-sync <mkb> --kind merge --summary "merged <skb>" --delta "+N nodes, +M edges", then bokf verify --workflow merge. Final integrity: no duplicate identifiers; no dangling object/primary_source/reported_in; every raw_source resolves; subtypes harmonized; the MKB's own identifiers/paths/raw/ unchanged except where a genuine merge required it.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/broccolito/biookf/biookf-merge/badge)](https://verified-skill.com/skills/broccolito/biookf/biookf-merge)

Something wrong with this skill or its page? Tell us.