Skip to content
Back to search

wiki-skills

MarketplaceWorks with Claude CodeGitHub

LLM-maintained personal wiki skills for Claude Code — implements Karpathy's LLM Wiki pattern

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kfchou--wiki-skills/badge.svg)](/listings/kfchou--wiki-skills)

HTML

<a href="/listings/kfchou--wiki-skills"><img src="/api/listings/kfchou--wiki-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin marketplace add kfchou/wiki-skills
/plugin install wiki-skills@wiki-skills

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 23 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "wiki-skills",
  3. "owner": {
  4. "name": "kfchou",
  5. "url": "https://github.com/kfchou"
  6. },
  7. "metadata": {
  8. "description": "LLM-maintained personal wiki skills for Claude Code",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "wiki-skills",
  14. "source": {
  15. "source": "url",
  16. "url": "https://github.com/kfchou/wiki-skills.git"
  17. },
  18. "description": "Skills implementing Karpathy's LLM Wiki pattern: wiki-init, wiki-ingest, wiki-query, wiki-lint, wiki-audit, wiki-update, wiki-merge",
  19. "version": "1.0.0",
  20. "strict": true
  21. }
  22. ]
  23. }
README.md · README · 134 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # wiki-skills
  2. A Claude Code plugin implementing [Karpathy's LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — a persistent, compounding knowledge base maintained by your LLM.
  3. Instead of RAG (re-deriving answers from raw documents every time), this system builds and maintains a **wiki**: a structured, interlinked collection of markdown files that gets richer with every source you add and every question you ask.
  4. ## Why Wikis work well
  5. The wiki format is remarkably similar to how the Claude Code Harness manages memory interally ([read about it here](https://kfchou.github.io/claude-code-memory-system/)). Since Claude is trained on the Claude Code Harness, that means Claude is already familiar with this structure. Unsure about other coding harnesses though.
  6. ## Installation
  7. ```bash
  8. /plugin marketplace add kfchou/wiki-skills
  9. /plugin install wiki-skills@wiki-skills
  10. ```
  11. ## Uninstallation
  12. ```bash
  13. /plugin uninstall wiki-skills@wiki-skills
  14. /plugin marketplace remove wiki-skills
  15. ```
  16. ## Requirements & setup
  17. The skills run wherever Claude Code does. A wiki additionally relies on:
  18. - **uv** — required. The `bin/` helper scripts (index generation, log rendering, and the
  19. deterministic lint and commit checks) run via `uv run`, and the pre-commit hook invokes them
  20. the same way. uv also provides Python: if Python 3 isn't already on the system, `uv` will
  21. download and manage it for you, so uv is the only thing you need to install.
  22. - **Python 3** — standard library only, no `pip install`. Supplied by uv if not already present.
  23. - **git** *(optional, recommended)* — if your wiki is a git repo, the operation log comes
  24. from git history and `wiki-init` installs the commit-time safety gates below. A non-git
  25. wiki works fine: it keeps a plain `wiki/log.md` and installs **no** scripts-as-hooks and
  26. **no** git config.
  27. - **`codex` or `gemini` CLI** *(optional)* — enables a true cross-provider adversarial review
  28. in `wiki-audit strong` (see below). Without either, strong mode falls back to a same-provider
  29. Claude subagent and labels its findings as the weaker signal.
  30. ### Set up: `wiki-init`
  31. When you initialize a wiki inside a git repo, run `wiki-init` to configures the following:
  32. - **Helper scripts** copied into `bin/`: `generate-index.py`, `render-log.py`,
  33. `check-contradictions.py`, `lint-mechanical.py`.
  34. - **A tracked pre-commit hook** (`bin/hooks/pre-commit`) wired up with one git config line:
  35. ```bash
  36. git config core.hooksPath bin/hooks
  37. ```
  38. It chains two deterministic, no-LLM gates that **block a commit** when a staged page has an
  39. unresolved contradiction flag or a structural problem (missing frontmatter, a broken
  40. `[[link]]`, or a slug collision).
  41. Each wiki also records this in its own `SCHEMA.md`, so the configuration travels with the
  42. wiki rather than living only here.
  43. ## Skills
  44. | Skill | Description |
  45. |---|---|
  46. | `wiki-init` | Bootstrap a new wiki for any domain |
  47. | `wiki-ingest` | Add a source (paper, URL, file, transcript) to the wiki |
  48. | `wiki-query` | Ask a question against the wiki; optionally save the answer back |
  49. | `wiki-lint` | Health audit: contradictions, orphans, broken links, coverage gaps |
  50. | `wiki-update` | Revise existing pages when knowledge changes |
  51. | `wiki-audit` | Per-page citation audit: verify every footnote against its source, flag uncited claims. `wiki-audit strong` adds a cross-model adversarial review |
  52. | `wiki-merge` | Consolidate two pages that are the same concept (merge), or split one overloaded slug into qualified pages |
  53. ## How It Works
  54. ### Three Layers
  55. ```
  56. <wiki-root>/
  57. ├── SCHEMA.md # Conventions + wiki root path (how skills find the wiki)
  58. ├── bin/ # Helper scripts: generate-index, render-log, check-contradictions,
  59. │ # lint-mechanical, and hooks/pre-commit (see Requirements & setup)
  60. ├── raw/ # Immutable source documents (you manage)
  61. ├── wiki/
  62. │ ├── index.md # GENERATED catalog (gitignored) — rebuilt from page frontmatter
  63. │ ├── log.md # Operation log — only for non-git wikis (git wikis use git history)
  64. │ ├── overview.md # Evolving synthesis of everything known
  65. │ └── pages/ # All wiki pages, flat, slug-named
  66. └── assets/ # Images, PDFs, attachments
  67. ```
  68. ### Typical Workflow
  69. ```
  70. wiki-init → bootstrap a new wiki
  71. wiki-ingest → add sources one at a time (repeat)
  72. wiki-query → ask questions; save good answers back as pages
  73. wiki-audit → fact-check a single page against its sources
  74. wiki-lint → periodic health check (every 5-10 ingests)
  75. wiki-update → revise pages when knowledge changes
  76. wiki-merge → merge duplicate concept pages, or split an overloaded slug
  77. ```
  78. ### Key Behaviors
  79. - **`wiki-ingest`** surfaces key takeaways and asks what to emphasize *before* writing anything. After creating a source page, it runs a backlink audit — scanning existing pages to add bidirectional links.
  80. - **`wiki-query`** always reads the wiki (never answers from memory). Always offers to file the answer back as a new page with `[[citations]]`.
  81. - **`wiki-lint`** writes a severity-tiered report (`🔴 errors / 🟡 warnings / 🔵 info`) to `wiki/pages/lint-<date>.md`, offers concrete fixes, and logs unconditionally.
  82. - **`wiki-audit`** fact-checks one page against its sources. Phase A flags uncited factual claims; Phase B dispatches one subagent per source in parallel to verify each footnote (quote citations are string-matched, `[synthesis]` citations are judged against the cited range). Writes a verdict report to `wiki/pages/audit-<page>-<date>.md` and offers concrete fixes. **Strong mode** (`wiki-audit strong`) adds Phase C: a different-provider model (`codex` or `gemini`, else a Claude subagent fallback) re-examines the same claims for overreach and contradiction, and disagreements with the normal pass become findings.
  83. - **`wiki-update`** always shows diffs before writing, always cites the source of new information, sweeps all pages for the same stale claim, and logs unconditionally.
  84. - **The index is generated, not hand-maintained.** `wiki/index.md` is a gitignored runtime artifact rebuilt from each page's `category` + `summary` frontmatter by `bin/generate-index.py`. Skills regenerate it before reading and after any page change, so it never drifts from the pages — no manual entry bookkeeping, no merge conflicts.
  85. - **The operation log comes from git.** On a git wiki, each operation is recorded as a commit carrying a `Wiki-Op:` trailer (subject follows the repo's convention, defaulting to Conventional Commits). Skills suggest the commit and commit on your confirmation — they never auto-commit. `bin/render-log.py` renders the history as a human log on demand, so there's no growing `log.md`. Non-git wikis keep `log.md` as a fallback.
  86. - **`wiki-merge`** treats the slug as a concept's identity. Merge folds a duplicate page into a survivor and rewrites every inbound `[[link]]`; split separates an overloaded slug into qualified pages (`mercury-planet` / `mercury-element`), repointing each link by meaning. Both end with a link-resolution sweep so no link is left dangling.
  87. ## Use Cases
  88. Works for any domain where you're accumulating knowledge over time:
  89. - **Research** — papers, articles, reports on a topic
  90. - **Codebase documentation** — modules, APIs, architecture decisions, data flows
  91. - **Reading notes** — books, papers, podcasts
  92. - **Competitive analysis** — tracking companies, products, developments
  93. - **Personal knowledge** — goals, health, self-improvement
  94. ## Inspired By
  95. [Andrej Karpathy's LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) (April 2026)
  96. > "The wiki keeps getting richer with every source you add and every question you ask."
  97. ## Contributing
  98. PRs, issues, and ideas are welcomed.
  99. ## License
  100. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.