percolate-kb SKILL.md skillA

percolate-kb from hraness/wrench is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add hraness/wrench/percolate-kb@git:20260928.35403bc

Pins git:20260928.35403bc in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: hraness/wrench
Path: .agents/skills/percolate-kb/SKILL.md
Versions recorded: 3
Latest version: git:20260928.35403bc, committed Sep 28, 2026
First version recorded: Aug 16, 2026
Size: 5,526 bytes
Repository stars: 8
License: MIT

Review a hraness/wordcell Markdown vault for recurring ideas and missing structural connections, then promote evidence-backed concepts and typed relationships with the Wordcell CLI. Use after materially adding or revising notes, when organizing an accumulated vault, or when an agent needs to turn repeated tags and prose references into an explicit queryable knowledge graph.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Percolate concepts and relationships

Keep the graph authored, local, and reviewable. `wordcell percolate` proposes
candidates from deterministic evidence; it never changes a note. Backlinks,
graph reports, and QMD results are derived views, while Markdown remains the
authority.

## Locate the vault

- Resolve `<vault>` to the directory containing its authored or managed
  `index.md` front door.
- Read the applicable repository and vault instructions before editing.
- Pass the resolved path to every `--root`.
- Identify the note or small neighborhood changed by the current task. Prefer a
  bounded review to a vault-wide cleanup during parallel work.

## Inspect candidates

Run percolation on the changed note when possible:

```sh
wordcell percolate notes/example --root "$KB_ROOT" --limit 25 --json
```

Run it without a note only when reviewing the whole vault:

```sh
wordcell percolate --root "$KB_ROOT" --min-support 2 --limit 50 --json
```

Treat each result as a prompt to open the cited notes and read the relevant
prose. Candidate kinds may include:

- a recurring tag with no maintained `type: concept` note;
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add hraness/wrench/percolate-kb@sha256:079d93b3ac45c1d4

The line at the top of this page pins the label git:20260928.35403bc, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_4hrhrtw4obr4nxp5.svg)](https://markdownregistry.com/a/art_4hrhrtw4obr4nxp5)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Aug 16, 2026 and Sep 28, 2026, about one every 21 days.

version	committed	commit	size	audit
git:20260928.35403bc latest	2026-09-28	35403bc	5,526 B	A	view · diff
git:20260821.66ec15d	2026-08-21	66ec15d	5,424 B	A	view · diff
git:20260816.bc70711	2026-08-16	bc70711	5,397 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (5526 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

hraness/wrench · 8 stars · license MIT · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_4hrhrtw4obr4nxp5
GET https://markdownregistry.com/api/v1/resolve?ref=hraness/wrench/percolate-kb
GET https://markdownregistry.com/api/v1/blob/079d93b3ac45c1d4c5a152b312673ed919731073fc605915b2320c16a22da17f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.