# Kb

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-hraness-kb-kb`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hraness](https://agentstack.voostack.com/s/hraness)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [hraness](https://github.com/hraness)
- **Source:** https://github.com/hraness/kb/tree/main/skills/kb
- **Website:** https://hraness.com/kb

## Install

```sh
agentstack add skill-hraness-kb-kb
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Work with KB

Use hraness/kb to preserve and retrieve inspectable agent memory in Markdown
and Git. Select the smallest workflow that matches the request, then load only
its references.

## Prepare the runtime

Use an existing `kb` command when one is available. Do not reinstall or upgrade
it merely because this skill loaded.

If `kb` is missing, check for Bun. Bun is the required runtime. When Bun is
also missing, install it with the official instructions at
 under the environment's normal approval
rules, then repeat command discovery. Install KB only while `kb` remains
missing:

```sh
command -v kb >/dev/null 2>&1 || {
  command -v bun >/dev/null 2>&1 || exit 1
  bun add --global @hraness/kb@0.17.2
}
kb --help
```

The exact npm version is the immutable release owned by this skill. Do not
replace it with `latest`, a branch, or an unpinned package source. Both installed
commands require Bun `1.3.14` or newer in `PATH`. Run `kb doctor` when the
chosen workflow may need browser capture, media tools, PDF extraction, OCR, or
local semantic search.

Installation ends after command verification. Never run `kb init`, create a
vault, refresh a catalog, or edit Markdown as an installation side effect.
Initialize or mutate a vault only when the user's request requires that change.

## Route the request

| User intent | Read |
| --- | --- |
| Find notes, search one vault or an authorized portfolio, load repository-path context, inspect plans or decisions, follow backlinks or relationships, audit vault organization, or retrieve Git provenance | [Query the knowledge base](references/query.md) |
| Save, clip, scrape, or archive a URL, article, social post or thread, GitHub or Discourse discussion, signed-in page, feed, inbox, private document, WhatsApp conversation, or YouTube page | [Capture web content](references/save-url.md); add [browser authentication](references/url-authentication.md) for signed-in sources and [platform routing](references/url-platforms.md) when route choice or completeness matters |
| Import, extract, archive, OCR, or convert a local or public PDF into Markdown | [Save a PDF](references/save-pdf.md); add [PDF image review](references/pdf-review.md) for scans, screenshots, conversations, charts, or mixed media |
| Create or update an implementation plan, proposal, RFC, migration plan, execution audit, or phased checklist in the vault | [Write a durable plan](references/plan.md) and [use its structure](references/plan-structure.md) |
| Review recurring ideas, promote concepts, or add and verify typed relationships | [Percolate concepts and relationships](references/percolate.md) |
| Refresh or validate the catalog, graph, attachments, repository scopes, context mappings, or overall vault health | [Refresh and check the knowledge base](references/refresh.md) |

Read more than one primary reference only when the request spans those
workflows. For example, saving a source and linking it from a maintained note
uses the capture workflow followed by the relevant percolation and refresh
steps.

## Preserve the KB contract

- Resolve `KB_ROOT` to the existing vault directory that contains its managed
  or authored `index.md`. Read the applicable repository and vault
  `AGENTS.md` files before writing. Do not assume the session started in the
  vault.
- Treat authored Markdown and Git as the record. Catalogs, backlinks, graph
  reports, search indexes, embeddings, and percolation candidates are derived
  views.
- Open cited notes and source records before turning search results, tags,
  mentions, or similarity into a conclusion. Author only relationships that
  the source note's prose and evidence support.
- Keep source capture separate from synthesis. Preserve access, pagination,
  extraction, OCR, and configured-limit failures instead of upgrading partial
  evidence to complete.
- Follow the selected reference's final checks. In a managed-catalog vault,
  parallel edit lanes use `kb check --root "$KB_ROOT" --no-catalog`; the
  integrating agent performs one refresh and normal check.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hraness](https://github.com/hraness)
- **Source:** [hraness/kb](https://github.com/hraness/kb)
- **License:** MIT
- **Homepage:** https://hraness.com/kb

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hraness-kb-kb
- Seller: https://agentstack.voostack.com/s/hraness
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.