Skill: mackding/create-opc-wiki (version 1.0.1)

--- name: create-opc-wiki description: Scaffold a personal LLM wiki (Karpathy pattern) — multi-agent, MCP-ready, with SEO/GEO publish target. Compiles knowledge into a persistent wiki instead of re-deriving from raw docs on every query. One paste from any agent (OpenClaw, Claude Code, Codex, Cursor, Hermes) installs it. --- # create-opc-wiki Scaffold a personal LLM wiki on the [Karpathy pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) in 30 seconds. Multi-agent native, MCP server built-in, SEO/GEO-optimized publish target. ## What this skill does Run the scaffolder against any folder and you get a complete personal-knowledge-base vault: - `agent-rules/main.md` — single source of truth, synced to **9 agent file formats** (CLAUDE.md, AGENTS.md, .cursor/rules/main.mdc, .cursorrules, .github/copilot-instructions.md, .trae/rules.md, **.openclaw/rules.md**, .hermes/agent.md) - Three reusable skills: `/wiki-ingest`, `/wiki-query`, `/wiki-lint` - Five source recipes: arXiv paper, X thread, YouTube transcript, RSS article, podcast transcript - Privacy-tagged frontmatter: `public | private | secret` - An MCP server with three tools (`wiki_query`, `wiki_list`, `wiki_read`) and a hard privacy gate (`privacy: secret` pages **never** leave the box) - Optional Astro static site target with sitemap.xml, llms.txt, robots.txt, RSS feed, OpenGraph + JSON-LD per page ## How to invoke The skill wraps the published npm package `create-opc-wiki@latest`. From any agent that can run a shell command: ```bash npx -y create-opc-wiki@latest <path> --yes --agents=openclaw,claude,codex,cursor ``` Common one-liners: | Agent | Command | |---|---| | OpenClaw | `npx -y create-opc-wiki@latest ~/wiki --yes --agents=openclaw,claude` | | Claude Code | `npx -y create-opc-wiki@latest ~/wiki --yes --agents=claude` | | Codex CLI | `npx -y create-opc-wiki@latest ~/wiki --yes --agents=codex` | | Cursor | `npx -y create-opc-wiki@latest ~/wiki --yes --agents=cursor` | | All of them | `npx -y create-opc-wiki@latest ~/wiki --yes --agents=openclaw,claude,codex,cursor,hermes,vscode,trae` | Add `--no-mcp`, `--no-site`, `--no-recipes`, or `--no-git` to skip those layers. `--json` emits machine-readable result on stdout. ## How to use the generated vault 1. **Open the folder in Obsidian** (it's a valid Obsidian vault) — and/or 2. **Open the folder in your AI agent** (it reads `CLAUDE.md` / `AGENTS.md` / `.openclaw/rules.md` / etc.) 3. From inside the agent, use the three skills: - `/wiki-ingest <url-or-file>` — drop a new source, agent files it into `raw/` and synthesizes wiki pages - `/wiki-query <question>` — natural-language query across compiled wiki - `/wiki-lint` — health-check (contradictions, stale `speculative` claims, orphan pages) The MCP server in `mcp/server.mjs` exposes the wiki to any MCP client (Claude Desktop, Cursor, Codex). Run `npm install && npm start` from the `mcp/` directory. ## Why a wiki and not just RAG Most LLM-on-files setups re-derive answers from raw docs at every query. There's no accumulation. Quoting [Karpathy's gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f): > The LLM **incrementally builds and maintains a persistent wiki** — a structured, interlinked collection of markdown files that sits between you and the raw sources. The wiki keeps getting richer with every source you add and every question you ask. This skill operationalizes exactly that, with concrete choices for ontology, agent rules, MCP, and publishing. ## Privacy & security - `privacy: secret` pages **never** returned by the MCP server (enforced at `mcp/server.mjs:38`) - `privacy: public` is the **only** level that publishes (enforced at `site/build.mjs:53`) - Default frontmatter privacy is `private` — nothing publishes by accident - The scaffolder runs once, locally, and exits — no telemetry, no network calls during scaffolding except the optional `npm` install you trigger yourself ## Links - **npm**: <https://www.npmjs.com/package/create-opc-wiki> - **GitHub**: <https://github.com/MackDing/create-opc-wiki> - **Inspiration**: <https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f> - **Stability scope**: see `STABILITY.md` in the repo for the semver-stable surface - **Per-agent install recipes**: see `docs/INSTALL-FOR-AGENTS.md` in the repo ## License MIT. Inspired by Andrej Karpathy's "LLM Wiki" gist; implementation choices are this project's. Full attribution in `INSPIRATION.md`.

path: EXAMPLES.md
content: # Quick examples

## Most common: install for all popular agents

```bash
npx -y create-opc-wiki@latest ~/wiki --yes \
  --agents=openclaw,claude,codex,cursor,hermes,vscode
```

## Minimal install (no MCP, no site, single agent)

```bash
npx -y create-opc-wiki@latest /tmp/quick-wiki --yes \
  --agents=claude --no-mcp --no-site --no-recipes --no-git
```

## Custom domains for a research vault

```bash
npx -y create-opc-wiki@latest ~/research --yes \
  --domains=ai,bio,papers,methodology --agents=claude
```

## Programmatic / CI use

```bash
npx -y create-opc-wiki@latest /tmp/wiki --yes --json --no-git \
  | jq '{ok, files, dirs, target}'
```

Output:
```json
{
  "ok": true,
  "target": "/tmp/wiki",
  "files": 28,
  "dirs": 17
}
```

## Then use the wiki

After scaffolding, `cd <vault>` and run your agent. From inside:

```
/wiki-ingest https://paulgraham.com/ds.html
/wiki-query "what's the relationship between Kelly criterion and position sizing?"
/wiki-lint
```

## Run the MCP server

```bash
cd ~/wiki/mcp
npm install
npm start
```

Then connect from Claude Desktop / Cursor / Codex. Three tools available: `wiki_query`, `wiki_list`, `wiki_read`.

## Publish your wiki

Tag pages with `privacy: public` in frontmatter, then:

```bash
cd ~/wiki/site
npm install
npm run build
# dist/ contains: index.html, sitemap.xml, llms.txt, robots.txt, feed.xml,
# per-page HTML with OpenGraph + JSON-LD
```

Drop `dist/` on GitHub Pages, Cloudflare Pages, Netlify, anywhere.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)