scribe-kb

Solid

Read, write, and search a scribe-managed knowledge base (markdown vault with frontmatter conventions, wikilinks, and qmd hybrid search). Use when the user's project has a scribe.yaml (KB root) or a .claude/<kb_name>/ drop-file directory (consumer side), or when they mention scribe, scriptorium, qmd, drop files, or "my KB". Covers frontmatter schema, wikilink syntax, drop-file pattern, search via qmd, and directory taxonomy.

Data & Documents 52 stars 2 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
57
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# scribe knowledge base — agent skill A scribe-managed KB is a local-first markdown vault. Articles live in topic directories under a KB root, every article carries YAML frontmatter, links between articles are `[[Wikilinks]]`, and search runs through qmd (BM25 + vector hybrid). A daemon `scribe` runs on cron to extract from project repos, mine Claude Code sessions, capture iMessage URLs, absorb queued URLs, lint frontmatter, and reindex qmd. This skill teaches a Claude Code / Codex / OpenCode session how to interact with such a KB without breaking the conventions the daemon expects. ## When to use this skill Trigger on any of: - **You're working in the KB root** — there's a `scribe.yaml` in the project root, or directories named `wiki/`, `decisions/`, `solutions/`, `patterns/`, `research/`, `ideas/`, `tools/`, `people/`, `projects/`, `raw/articles/`. - **You're working in a non-KB project that drops files into the KB** — there's a `.claude/<some_kb_name>/` directory with markdown drop files, or the user's CLAUDE.md mentions a personal KB and a drop-file convention. - The user asks about: their KB, scriptorium, qmd, drop files, "what do I know about X", "have I done this before", "save this for later", or any of the article types above. ## Operations cheat sheet | What | Command (qmd / shell) | |---|---| | Find articles by topic | `qmd query "<natural-language question>"` (or use the qmd MCP tool when present) | | Exact-keyword search | `qmd search "<keywords>"` | | Rea...

Details

Author
oliver-kriska
Repository
oliver-kriska/scribe
Created
3 months ago
Last Updated
4 days ago
Language
Go
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Solid

scribe-cli

Operate the scribe CLI to keep a knowledge-base pipeline healthy — diagnose with doctor/status, run sync/extraction, manage cron and Full Disk Access, and pick the right command for a maintenance goal. Use when the user wants to run scribe, asks which scribe command does X, says their KB is stale/empty or extraction/sync stopped, or is reading `scribe doctor`/`scribe status` output. For authoring KB content use scribe-kb; for the `scribe lint` content-quality queue use scribe-kb-tidy.

52 Updated 4 days ago
oliver-kriska
Data & Documents Solid

scribe-kb-tidy

Clean up a scribe knowledge base — split bloated articles, expand or merge thin stubs, archive overgrown rolling files, and merge KB-self-named directories. Use when `scribe lint` reports content-quality warnings (bloated article, thin article, rolling file overgrown, directory named after the KB), or when the user asks to tidy, prune, split, archive, or de-clutter their KB / scriptorium.

52 Updated 4 days ago
oliver-kriska
Data & Documents Listed

okf-query

Answer a question using ONLY an Open Knowledge Format (OKF) knowledge base (a wiki/ bundle of Markdown + YAML frontmatter), with citations and honest gaps. Use when the user asks something their wiki / knowledge base / notes should answer, or says "according to my notes/KB", "what does my wiki say about X", "search my knowledge base", "what do I have on X". Navigates the indexes, cites concept ids, and flags what's missing instead of guessing.

1 Updated today
thattimc