Wiki Skills (shared agent bundle)

English · 中文

Agent wiki / Obsidian skills. Default install is an opt-in profile (~/.agents/profiles/wiki/skills/) so OpenCode, Pi, and OMP do not load the bundle unless you ask. Always-on install into ~/.agents/skills/ remains available. No private vault, no live credentials.

Remote name: openrafa/opencode-obsidian-wiki (local folder may still be called opencode-wiki-skills).

Suite hub: opencode-methodology → Get started.

Attribution

This repo is a fork of AgriciDaniel/claude-obsidian, adapted for agent use. It also borrows ideas from Karpathy / kepano — credit all of them:

Kind	Upstream
Fork of — skill bundle	AgriciDaniel/claude-obsidian
Borrowed idea — compounding wiki	Karpathy llm-wiki gist
Borrowed idea / substrate — Obsidian skills	kepano/obsidian-skills
External CLI — article extract	kepano/defuddle
Agent packaging / transports	Maintained here by Cyame

Full notes: docs/upstream.md · 中文.

Getting started

Option A — skills CLI (any agent, 74+ supported)

npx skills add openrafa/opencode-obsidian-wiki
# → symlinked into your agent's skill directory (e.g. ~/.config/opencode/skills/)
# opt-in skills one by one (recommended for wiki-*):
npx skills add openrafa/opencode-obsidian-wiki --skill wiki --skill wiki-ingest --skill wiki-query

Runtime helper scripts ship inside the skill bundles. One-time per vault provisioning (needed by wiki, wiki-mode, wiki-retrieve, wiki-cli):

bash ~/.config/opencode/skills/wiki/scripts/setup-vault.sh /path/to/vault      # wiki-mode.py, wiki-lock.sh, ...
bash ~/.config/opencode/skills/wiki-mode/scripts/setup-mode.sh /path/to/vault  # set LYT / PARA / Zettel / generic
bash ~/.config/opencode/skills/wiki-retrieve/scripts/setup-retrieve.sh /path/to/vault  # hybrid retrieval pipeline

Option B — clone and install (RAFA wiki profile)

1. Pick an agent runtime (OpenCode, pi, omp — see tool layering and skill profiles).
2. Read docs/workflow-model.md and docs/transport-model.md before enabling remote egress.
3. Clone and install the wiki profile (recommended):

git clone https://github.com/openrafa/opencode-obsidian-wiki.git
cd opencode-obsidian-wiki
bash scripts/install.sh --dry-run --profile wiki
bash scripts/install.sh --profile wiki
# → ~/.agents/profiles/wiki/skills/
python3 /path/to/opencode-methodology/bin/agentctl install
agentctl --profile wiki opencode

Always-on (every default scan of ~/.agents/skills loads wiki skills):

bash scripts/install.sh
# → ~/.agents/skills/wiki-*

Upgrades: bash scripts/install.sh --profile wiki --prune refreshes the profile copy. Add --prune-shared to remove leftover wiki-* from ~/.agents/skills.

4. Point the Agent at your vault via project or vault AGENTS.md (see the wiki skill scaffold). Do not commit private vault paths to public repos.
5. Smoke-test on a non-sensitive vault: scaffold / wiki-ingest / wiki-query / wiki-lint / wiki-save.
6. Optional Python isolation for heavy helpers: opencode-skill-runtime.

What lands on disk

# recommended: bash scripts/install.sh --profile wiki
~/.agents/profiles/wiki/skills/
├── wiki/                    # vault scaffold + core conventions
├── wiki-anki/               # generate Anki cards from notes
├── wiki-autoresearch/       # autonomous iterative research loop
├── wiki-bases/              # Obsidian Bases (.base files)
├── wiki-canvas/             # Obsidian canvas composition
├── wiki-cli/                # vault read/write via Obsidian CLI
├── wiki-defuddle/           # web page cleanup before ingest
├── wiki-fold/               # log rollups into meta-pages
├── wiki-history/            # personal history KB conventions
├── wiki-ingest/             # source ingestion + entity extraction
├── wiki-lint/               # vault health checks
├── wiki-markdown/           # Obsidian Flavored Markdown rules
├── wiki-mode/               # vault methodology (LYT / PARA / Zettel / generic)
├── wiki-network/            # people / contact recording
├── wiki-ocr/                # document conversion / OCR toolchain
├── wiki-ops/                # safe batch operations on the vault
├── wiki-query/              # answer questions from the vault
├── wiki-retrieve/           # hybrid retrieval (BM25 + rerank)
├── wiki-save/               # file sessions / insights into the vault
├── wiki-think/              # 10-principle thinking loop
└── wiki-travel/             # travel destinations + trip reviews

Legacy / always-on: the same tree under ~/.agents/skills/ (bash scripts/install.sh with no --profile).

What this is / is not

Is: wiki / Obsidian skill bundle vendored from upstream + RAFA packaging; transport docs for API / MCP / CLI / fs.

Is not: a private vault export; a substitute for your credentials; a promise that every remote-model call is safe by default.

Docs

Topic	English	中文
Upstream / fork	upstream.md	upstream.zh-CN.md
Workflows	workflow-model.md	workflow-model.zh-CN.md
Transports	transport-model.md	transport-model.zh-CN.md
Compatibility	compatibility.md	compatibility.zh-CN.md
OpenCode changes	opencode-changes.md	opencode-changes.zh-CN.md

Privacy

Wiki workflows may read private notes, fetch the web, or call remote models. Review each skill; keep remote egress opt-in.

License

MIT — Copyright (c) 2026 Cyame. See LICENSE.