kb-create

kb-create is a skill for Claude Code, Codex from BeppeTemp/cartographer. It costs 24 tokens per session (1,928 once invoked), scanned A, original, Apache-2.0.

A procedure for creating a persistent Knowledge Base through GitOps, where a Git repository stores the source of truth and deployment configuration restores it after restarts.

In plain words
What is it for?
Use it to create a Knowledge Base, declare its remote repository, deploy the configuration, and verify that the server reconnects to it.
Why use it?
It prevents knowledge-base data from disappearing when a server pod is restarted or moved.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/beppetemp/cartographer/kb-create
Any agent
npx skills add BeppeTemp/cartographer --skill kb-create
Clone the repo
git clone --depth 1 https://github.com/BeppeTemp/cartographer

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for kb-create

README.md
[![agentmods](https://agentmods.dev/badge/skills/beppetemp/cartographer/kb-create.svg)](https://agentmods.dev/skills/beppetemp/cartographer/kb-create)
Your own site
<a href="https://agentmods.dev/skills/beppetemp/cartographer/kb-create"><img src="https://agentmods.dev/badge/skills/beppetemp/cartographer/kb-create.svg" alt="Measured on agentmods" height="20"></a>
Per session 24 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,928 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00024 $0.01928
Opus 5 $0.00012 $0.00964
Sonnet 5 $0.00005 $0.00386
Haiku 4.5 $0.00002 $0.00193

Measured 4d ago against content hash 64a59263c196, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

kb-create scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

internal/skillbundle/bundled/kb-create/SKILL.md · 129 lines

How it starts

The opening of the file, as written. The whole thing — 129 lines — stays where its author put it; the contents beside it link to each section on GitHub.

KB Create — Skill

Purpose

Guide an operator through creating a new Knowledge Base (KB) the persistent, GitOps way: a Gitea repo as source of truth, declared in the server's config (ConfigMap), rolled out, then verified and connected. This replaces the old runtime-only creation flow (v1.x) — a KB that only exists as an ad-hoc runtime mount on an emptyDir is not durable.

WARNING — data loss risk. A KB mounted on an emptyDir volume that is not declared in the Deployment's ConfigMap (kbs: entry + remote:) dies with the pod: on the next reschedule / rollout the directory is recreated empty and every concept written to it is gone. The ConfigMap + Gitea repo declaration is what makes the KB persistent and reconstructible — the server clones it fresh on every pod start (docs/deployment.md §Bootstrap KB da remote git).

Local/native-service topology. On a single machine served by the local service, the equivalent one-liner is cartographer kb create <name> --remote <url>: it scaffolds the KB and pushes it to the empty repository that becomes its origin (the remote is mandatory there too, D134). This skill remains the procedure for the GitOps/Kubernetes topology below, where the KB also has to be declared in the server's ConfigMap.

Steps

1. Create the Gitea repo and the per-KB service user

Create an empty repo <nome>.git on Gitea. The KB name is the name: field of its kbs: entry (D53) — set it explicitly; if omitted it falls back to the repo basename (resolveKBName in cmd/cartographer/bootstrap.go). The name is used everywhere downstream: token scopes (kb:<nome>:rw/kb:<nome>:r), the ?kb=<nome> query param on multi-KB HTTP, and the <nome>.token/<nome>.age per-KB file conventions below. Choose it accordingly (kebab-case).

Then create a dedicated Gitea service user for the KB (convention: kb-<nome>), add it as a collaborator with write permission on the repo only, and generate an access token for it (scope write:repository). This token is the KB's git credential (one user per KB = per-repo isolation; Gitea tokens are per-user, not per-repo).

Read the full file on GitHub · 129 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 129 lines · 24 tokens per session scan A 64a59263c196

Subscribe to this mod's changes

kb-create is a skill published in the GitHub repository BeppeTemp/cartographer (17 stars, last pushed 5d ago), licensed Apache-2.0. It adds 24 tokens to every session and 1,928 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

wiki-export

Export the Obsidian wiki's knowledge graph to structured formats for use in external tools. Use this skill when the user says "export wiki", "export graph", "export to JSON", "export to Gephi", "export to Neo4j", "export to Postgres", "export to SQL", "graphml", "visualize wiki", "knowledge graph export", "export to…

Ar9av/obsidian-wiki · 172 tokens

stripe-projects

Use when the user wants to provision infrastructure or third-party services using Stripe Projects. Triggers: "I need a database", "set up auth", "add caching", "give me a Postgres", "provision Redis", "I need hosting", "add a vector DB", "get me an API key for X", "get credentials for X", "sign up for a service", "set…

stripe/ai · 213 tokens

sq

Guides use of the sq CLI to query SQL databases and tabular files with SLQ (sq's jq-like query language) or native SQL, manage sources, choose output formats, and run inspect, diff, and table commands. Use when the user mentions sq, SLQ, wrangling CSV/Excel/JSON/DB data, cross-source joins, or command-line data…

neilotoole/sq · 89 tokens

streamsql

当需要创建实时数据聚合/窗口统计、流式过滤转换、变化检测(CDC)、生命周期累计、元数据富化(流-表 JOIN)、CEP 模式识别(MATCHRECOGNIZE)等规则链时使用,或当使用 x/streamAggregator 和 x/streamTransform 组件时使用。包含 SQL 语法、窗口、分析函数、JOIN、CEP 和配置示例.

rulego/rulego · 90 tokens

openkb-deck-neon

Use when the user asks the openkb chat to make a deck / slide presentation / PPT / slides / 演示稿 / 幻灯片 from their compiled KB content AND wants a dark, high-tech, neon / glow / glassmorphism look (赛博 / 科技风 / 暗色 / 霓虹 / 炫酷). Generates a polished single-file HTML deck in the Aurora Glass visual direction (near-black…

VectifyAI/OpenKB · 173 tokens

api-canvas

DataCanvas primitive reference — a Tier 3 SQL/analytical workspace for tabular MCP servers, backed by DuckDB. Use when registering tables from upstream APIs, running ad-hoc SQL across them, and exporting results. Covers the acquire → register → query → export flow, per-table TTL, the token-sharing pattern for…

cyanheads/obsidian-mcp-server · 85 tokens