Kinic Wiki

Console

Skip to main content
Skills

Portable handoff

Context Pack

Use Context Pack workflows when a bounded wiki scope needs to become a portable markdown bundle with Kinic references and verification.

SKILL.md

Read the skill as documentation or switch to the exact source.

Frontmatter

name
kinic-context-pack
description
Kinic workflow skill for exporting /Knowledge scopes as OKF v0.1 Context Pack markdown bundles, then verifying and inspecting those bundles before portable AI handoff.

Kinic Context Pack

Use this skill when the user wants to:

  • export a /Knowledge/... scope as an OKF v0.1 markdown bundle
  • verify or inspect a local OKF Context Pack bundle
  • prepare portable context for another AI client or agent
  • confirm that evidence source body text is not copied into the bundle

Do not use this skill for:

  • answering questions against the live wiki; use kinic-wiki-query
  • ingesting new source material; use kinic-wiki-ingest
  • repairing live wiki pages; use kinic-wiki-edit
  • general wiki health review; use kinic-wiki-lint
  • skill store package lifecycle work; use kinic-skill-registry

Core rules:

  • Treat the canister-backed VFS as the source of truth.
  • Export only from /Knowledge/....
  • Output OKF markdown only. Do not expect Kinic manifest.json, sources.json, or provenance.json.
  • Keep index.md and log.md as reserved OKF files without frontmatter.
  • Require YAML frontmatter with a non-empty type for every non-reserved .md file.
  • Treat notes/*.md as unclassified wiki notes.
  • Treat references/*.md as /Sources/... reference metadata only.
  • Do not copy evidence source body text into the OKF bundle.
  • Verify a bundle before handing it to an AI.
  • Do not write from an OKF bundle back into the wiki.

Read context-pack.md before doing substantive Kinic Context Pack work.

Kinic Context Pack Workflow

Goal

Export a selected /Knowledge/... scope into an OKF v0.1 markdown bundle that another AI can read, then verify that the bundle is structurally valid and does not contain copied evidence source bodies.

Workflow

  1. Identify the database_id and the /Knowledge/... root to export.
  2. Export the scope with context-pack export.
  3. Verify the output directory with context-pack verify.
  4. Inspect the bundle with context-pack inspect when a summary or JSON handoff record is useful.
  5. Hand off the bundle only after verification passes.

Read Strategy

  • context-pack export is the preferred read path for handoff bundles; it uses query_context internally to collect scoped wiki nodes and evidence.
  • Do not pre-read the scope with ad hoc read-node loops before export.
  • Use context-pack inspect for local bundle summaries after export.
  • Use export_snapshot or fetch_updates only through Store API/tool access outside this workflow when raw scope or delta reads are explicitly needed. Measure those raw reads with the Store API latency benchmark, not by adding ad hoc reads before context-pack export.

Commands

Export:

kinic-vfs-cli --database-id <db> context-pack export \
  --root /Knowledge/projects/acme \
  --out ./okf \
  --expires-at 2026-09-22T00:00:00Z \
  --trust-level team-approved \
  --approved-by principal:aaaaa-aa

Verify:

kinic-vfs-cli context-pack verify ./okf

Inspect:

kinic-vfs-cli context-pack inspect ./okf --json

OKF Shape

Expected bundle shape:

index.md
log.md
facts/*.md
decisions/*.md
tasks/*.md
policies/*.md
notes/*.md
references/*.md

Reserved files:

  • index.md: progressive-disclosure entrypoint; no frontmatter
  • log.md: export history; no frontmatter

Concept files:

  • every non-reserved .md file has YAML frontmatter
  • type is required and non-empty
  • Kinic-specific data lives under the kinic: frontmatter extension

Directory meaning:

  • facts/*.md: settled fact concepts from fact-like wiki nodes
  • decisions/*.md: decision concepts
  • tasks/*.md: task or plan concepts
  • policies/*.md: style, preference, and do-not-do concepts
  • notes/*.md: unclassified wiki nodes that are still normal OKF concepts
  • references/*.md: source reference concepts only; kinic.source_path must point under /Sources/...

Rules

  • Do not export from /Sources/... as the root.
  • Do not copy evidence source body text into references/*.md.
  • Do not use references/*.md for ordinary wiki notes.
  • Do not treat a passed inspect summary as verification; run verify.
  • Do not use this skill to mutate the wiki.
  • If verify reports an expired kinic.expires_at, re-export from the source wiki instead of extending the local bundle by hand.

Output

For handoff, include:

  • bundle path
  • exported wiki root
  • verification result
  • inspect summary when requested
  • any verification failure that blocks AI handoff