rekal-usage

rekal-usage is a skill for Claude Code from janbjorge/rekal. It costs 75 tokens per session (1,138 once invoked), scanned A, original, MIT.

An operational guide for using rekal, a memory system that stores and recalls useful project facts across coding sessions.

In plain words
What is it for?
Use it when starting a session, joining a rekal workspace, or learning how its memory tools work.
Why use it?
It explains which memory action to use and how, so you can recall, save, update, or remove information consistently.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: mentions CLAUDE.md; mentions AGENTS.md.

Part of the rekal-skills plugin — 4 skills, 4 hooks shipped together

Good fit Use it when starting a session, joining a rekal workspace, or learning how its memory tools work.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/janbjorge/rekal/rekal-usage
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.

Any agent
npx skills add janbjorge/rekal --skill rekal-usage
Clone the repo
git clone --depth 1 https://github.com/janbjorge/rekal

Made for: Claude Code.

Or install rekal-skills, the plugin that ships this one along with the rest of its 4 skills, 4 hooks.

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 rekal-usage

README.md
[![agentmods](https://agentmods.dev/badge/skills/janbjorge/rekal/rekal-usage.svg)](https://agentmods.dev/skills/janbjorge/rekal/rekal-usage)
Your own site
<a href="https://agentmods.dev/skills/janbjorge/rekal/rekal-usage"><img src="https://agentmods.dev/badge/skills/janbjorge/rekal/rekal-usage.svg" alt="Measured on agentmods" height="20"></a>
Per session 75 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,138 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.1 $0.00075 $0.01138
Opus 5 $0.00037 $0.00569
Sonnet 5 $0.00015 $0.00228
Haiku 4.5 $0.00007 $0.00114

Measured 8d ago against content hash 637eb4b24bda, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

rekal-usage 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 8d 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.

skills/rekal-usage/SKILL.md · 123 lines

How it starts

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

You have persistent memory via three rekal MCP tools. Follow these rules exactly.

The surface

tool purpose
memory_build_context(query, project?, limit?, min_score?) recall: hybrid search over stored memories
memory_store(content, project?, tags?, replaces?) persist one distilled fact; replaces=<old_id> updates an existing one
memory_delete(memory_id) remove a memory that is wrong or obsolete

Admin operations (health report, export, bulk prune) live in the CLI: rekal health, rekal export, rekal prune.

Session start

Call memory_build_context(query="<task description>") before exploring the codebase. Read the result before proceeding. Do this EVERY session.

Recalling

Queries go through hybrid search: BM25 keywords + vector similarity + recency decay. Results below min_score (default 0.25) are dropped, so an empty result means "nothing relevant", not "nothing stored".

Do: Use natural language with domain terms.

"JWT refresh token rotation policy": specific, has domain terms
"how to deploy auth service to staging": natural language, synonyms work
"user's preferred formatter and why": retrieves preferences with reasoning

Do not: Use vague, generic, or garbage queries.

"stuff": matches nothing useful
"code": matches everything
"the thing": no semantic content
  • project="backend": scope to one project. Use in multi-project workspaces.
  • Different angle on the same task = new memory_build_context call with a reworded query.

Storing

Rule: ALWAYS recall before storing

1. memory_build_context(query="<what you want to store>")
2. Read results:
   ├── Exact duplicate found     → do nothing
   ├── Same topic, outdated info → memory_store(content="...", replaces="<old_id>")
   └── No match                  → memory_store(content="...", tags=[...])

Never skip step 1. Duplicates degrade search quality. Two memories about the same topic must never coexist: replaces supersedes the old memory so it stops surfacing in recall.

Read the full file on GitHub · 123 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. 8d ago First seen · 123 lines · 75 tokens per session scan A 637eb4b24bda

Subscribe to this mod's changes

rekal-usage is a skill published in the GitHub repository janbjorge/rekal (53 stars, last pushed 12d ago), licensed MIT. It adds 75 tokens to every session and 1,138 once invoked, about $0.0004 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

vault-for-llm

Connect OpenClaw to Vault Agent Memory as a local-first governed project memory layer. Search first, then bounded-read cited source ranges; propose new memories as candidates instead of writing directly into active memory.

zycaskevin/Vault-Agent-Memory · 46 tokens

hmem-write

Hmem write protocol — picks prefix (L/E/D/P/N/R/I/H…), tree location, and tags, and detects duplicates before persisting. Use before any writememory or appendmemory call (skipping it creates duplicates and misplaced entries), or when the user says 'remember this', 'save this', 'log this', or invokes /hmem-write.

Bumblebiber/hmem · 77 tokens

hmem-config

View and change hmem memory settings, hooks, sync, and checkpoints. Use on /hmem-config, or when the user asks why context is huge, how to change auto-save, how often checkpoints fire, or how to set up sync.

Bumblebiber/hmem · 54 tokens

hmem-read

Load long-term memory from hmem via readmemory or loadproject. Use when starting fresh with no L1 summaries, after /compact, when the user asks 'what do you remember', 'continue where we left off', 'was war der letzte Stand', or about a project/topic visible in L1 summaries. Covers search, prefix filter, findrelated…

Bumblebiber/hmem · 85 tokens

hmem-curate

Curate an .hmem file (your own or foreign) — mark obsolete/irrelevant, fix titles, consolidate duplicates, repair broken links. Requires the hmem-curate MCP server (skill prompts the user to enable it on entry). Use whenever the user says 'aufräumen', 'memory aufräumen', 'Speicher aufräumen', 'hmem aufräumen', 'clean…

Bumblebiber/hmem · 218 tokens

hmem-migrate-o

Migrate O-entries to the v5.3+ project-bound 5-level structure (each O00XX bound to its P00XX). Use on 'migrate O-entries', when hmem-update flags a structure migration, or when you notice O-entries still in the old flat L2→L4→L5 format.

Bumblebiber/hmem · 76 tokens