kb-research-policy

kb-research-policy is a skill for Claude Code, Codex from kelp/agent-plugins. It costs 167 tokens per session (1,437 once invoked), scanned A, original, MIT.

A set of rules for searching a personal knowledge base containing archived sources, synthesized notes, reports, projects, and other research material.

In plain words
What is it for?
Use it when asking about past research, saved sources, prior notes, studied topics, or information that may be in the personal wiki.
Why use it?
It provides a consistent way to locate relevant notes without guessing where the knowledge base is stored or editing its source archive.

Skill for Claude CodeCodex

Installs and runs on its own, but its text points at files inside its plugin — anything it tells you to read at a ${CLAUDE_PLUGIN_ROOT} path is only there once the plugin is installed. Installing the plugin gets both.

Part of the knowledge-forge plugin — 3 skills shipped together

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/kelp/agent-plugins/kb-research-policy
Any agent
npx skills add kelp/agent-plugins --skill kb-research-policy
Clone the repo
git clone --depth 1 https://github.com/kelp/agent-plugins

Made for: Claude Code, Codex.

Or install knowledge-forge, the plugin that ships this one along with the rest of its 3 skills.

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-research-policy

README.md
[![agentmods](https://agentmods.dev/badge/skills/kelp/agent-plugins/kb-research-policy.svg)](https://agentmods.dev/skills/kelp/agent-plugins/kb-research-policy)
Your own site
<a href="https://agentmods.dev/skills/kelp/agent-plugins/kb-research-policy"><img src="https://agentmods.dev/badge/skills/kelp/agent-plugins/kb-research-policy.svg" alt="Measured on agentmods" height="20"></a>
Per session 167 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,437 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.00167 $0.01437
Opus 5 $0.00084 $0.00718
Sonnet 5 $0.00033 $0.00287
Haiku 4.5 $0.00017 $0.00144

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

Security

Grade A, and why

kb-research-policy 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.

plugins/knowledge-forge/skills/kb-research-policy/SKILL.md · 187 lines

How it starts

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

KB Research Policy

Travis maintains a three-layer personal knowledge base. This skill tells you how to find things in it efficiently from any session, regardless of your current working directory.

The three layers:

  • raw/ — immutable source archive (web crawls, PDFs, snapshots). Never edit.
  • wiki/ — synthesized notes in buckets: sources/, concepts/, reports/, questions/, projects/, playbooks/, dependencies/.
  • index/ — cheap one-line-per-entry routing files. Read these first.

For edge cases not covered here, read <kb>/CLAUDE.md and <kb>/AGENTS.md directly.


Step 1: Resolve the KB path

Run ${CLAUDE_PLUGIN_ROOT}/scripts/resolve-kb-path.sh and capture its stdout as kb_path. Every subsequent command uses "$kb_path" (double-quoted).

kb_path=$(bash "${CLAUDE_PLUGIN_ROOT}/scripts/resolve-kb-path.sh")

If the script exits non-zero, relay its stderr message to the user verbatim and stop — do not guess a fallback path.


Step 2: Read the index first

Index files are small (one line per entry) and are the cheapest first hop. Read only the ones relevant to the question. Do not open full wiki notes yet.

Current index files under <kb>/index/:

  • sources.md — web pages and docs Travis has read
  • concepts.md — synthesized topic pages
  • open-questions.md — unresolved inquiries
  • playbooks.md — reusable how-to notes
  • projects.md — project overviews
  • dependencies.md — external tools and libraries
  • doc-packs.md — downloaded external doc packs (AUTO-GENERATED)
  • freshness.md — last updated_at per external source (AUTO-GENERATED)
  • authoritative-files.md — canonical file references

If a listed index file does not exist, skip it silently. Not every KB populates every bucket.

After reading the relevant index files, you should have a shortlist of candidate note IDs. If the index alone gives a confident, complete answer, you may skip Step 3 and answer directly. Otherwise proceed to Step 3 — the hand-maintained index can lag actual note content, so a thin or stale-looking index entry is not itself a complete answer.

Read the full file on GitHub · 187 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 · 187 lines · 167 tokens per session scan A 58721363bb01

Subscribe to this mod's changes

kb-research-policy is a skill published in the GitHub repository kelp/agent-plugins (2 stars, last pushed today), licensed MIT. It adds 167 tokens to every session and 1,437 once invoked, about $0.0008 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-31.

Related

Other skills, from other repositories

cdb-scan

Map this codebase into project memory — a code graph of every symbol and how they connect, plus a written profile of stack, layout, conventions and workflows. Re-run any time to refresh both in place. Use when memory is newly installed on an existing project, or when the project has changed enough that the stored map…

Avijit07x/claude-db · 72 tokens

ctx-purge

Purge the context-mode knowledge base. Permanently deletes all indexed content and resets session stats. This is destructive and cannot be undone. Trigger: /context-mode:ctx-purge.

mksglu/context-mode · 42 tokens

ctx-index

Index a local file or directory into context-mode's persistent FTS5 knowledge base so future ctxsearch calls can retrieve focused snippets without rereading raw files. Trigger: /context-mode:ctx-index.

mksglu/context-mode · 44 tokens

ctx-search

Search context-mode's persistent FTS5 knowledge base for previously indexed local project content, documentation, or session memory. Trigger: /context-mode:ctx-search.

mksglu/context-mode · 36 tokens

ctx-stats

Show how much context window context-mode saved this session. Displays token consumption, context savings ratio, and per-tool breakdown. Read-only — shows stats only, no reset capability. To wipe the knowledge base entirely, use ctxpurge instead. Trigger: /context-mode:ctx-stats.

mksglu/context-mode · 62 tokens

autolearn

Compound a solved problem into a durable in-repo learning doc. Use when a verified non-trivial fix lands, the user says "compound this", "document this fix", or "remember this". This is the automatic-capture entry point; for an explicitly requested one-off write-up, use compound.

OutlineDriven/odin-claude-plugin · 65 tokens