# wiki-capture

Turns conversations and debugging findings into structured Obsidian notes. Supports rapid staging to _raw/ and atomic corrections without touching raw sources.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2800 installs · ★ 3621
- Author: Ar9av
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Ar9av/obsidian-wiki/tree/HEAD/.skills/wiki-capture/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/wiki-capture

## What it does

The skill extracts actionable findings from the current session and turns them into Obsidian notes. It does not ingest external sources. The logic focuses entirely on active debugging, unexpected API behavior, and discovered workarounds.

Three execution modes are available. Full mode classifies the topic and drafts a finished wiki entry with cross-links. Quick mode with `--quick` dumps observations into the `_raw/` folder within 60 seconds without updating index files or manifests. You promote those staged files to main wiki pages later using `/wiki-ingest`.

Configuration relies on the `OBSIDIAN_VAULT_PATH` environment variable. A separate correction mode triggered via `--correction` captures atomic claim updates while keeping raw sources untouched. If a chat contains no reusable discoveries, the internal gate cancels the run to avoid cluttering `_raw/`.

## Requirements
- Works with: Obsidian

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-capture -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/wiki-capture/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/wiki-capture/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-capture -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/wiki-capture/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-capture -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/wiki-capture/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Ar9av/obsidian-wiki wiki-capture
```

2. **Manually: put the files in place**
- File: `.github/skills/wiki-capture/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-capture -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Ar9av/obsidian-wiki --path .skills/wiki-capture
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/wiki-capture/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Ar9av/obsidian-wiki --skill wiki-capture -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Ar9av/obsidian-wiki/tree/HEAD/.skills/wiki-capture/SKILL.md

## When to use it
- preserve non-obvious bug fixes or API behavior directly from a chat
- drop raw staging drafts into `_raw/` without touching index files
- record atomic claim corrections via the `--correction` mode
- route structured notes into designated Obsidian vaults

## Example prompts
- Save this debugging finding to raw staging via `/wiki-capture --quick`
- Turn the session findings into a permanent wiki note: `/wiki-capture`
- Record an atomic correction for the claim using `/wiki-capture --correction`

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 3c47a84a8a355039.

BEGIN THIRD-PARTY FILE 3c47a84a8a355039
```text
---
name: wiki-capture
description: >
  Turn the current conversation or finding into a structured permanent wiki note. Use for save/capture/preserve requests; QUICK MODE writes a fast _raw/ note. Supports named-vault routing such as @research save this. This captures current discussion, not external source ingestion.
---

# Wiki Capture — Conversation to Wiki Note

You are preserving knowledge from the current conversation as a permanent wiki note. The goal is to extract the *substance* — the knowledge itself — not a summary of what was said.

**Writing profile:** Before drafting or rewriting natural-language Markdown in any mode, read and apply the `Writing Profile Resolution` section in `llm-wiki/SKILL.md`. Framework schema, provenance, safety, and operation-specific requirements take precedence.
`WRITING.md` preferences apply only to newly drafted or rewritten natural-language Markdown; preserve source content and structured records.

This skill has three modes:

- **Full mode (default)** — classify the content and write a finished, cross-linked wiki page directly into the right category. This is the rest of this document (Steps 1–7).
- **Quick mode (`--quick`)** — zero-friction staging: drop findings to `_raw/` in under 60 seconds with no manifest/index/log/QMD writes. Used for mid-session capture and by the session-end Stop hook. See below, then stop — do **not** run the full-mode steps.
- **Correction mode (`--correction`)** — capture one atomic correction as derived knowledge while leaving the immutable conversation/source untouched. Use the template below, then update only the derived consumers and tracking links.

## Quick Mode (`--quick`)

Trigger when invoked as `/wiki-capture --quick`, by "quick capture" / "capture this finding" / "save this bug fix" / "save this gotcha" / "drop this to raw" / "quick save to wiki", or automatically by the session-end Stop hook.

**Speed contract:** Inline only. No subagents. No QMD. No manifest/`index.md`/`log.md`/`hot.md` writes. Target: <60 seconds. Promotion to full wiki pages happens later via `/wiki-ingest`.

1. **Resolve config** (Config Resolution Protocol in `llm-wiki/SKILL.md`): get `OBSIDIAN_VAULT_PATH` and `OBSIDIAN_RAW_DIR` (default: `$OBSIDIAN_VAULT_PATH/_raw`). Ensure `$OBSIDIAN_RAW_DIR` exists; create it if not.

   Capture does not independently reinterpret validator schema inputs. When `OBSIDIAN_ALLOWED_LIFECYCLES`, `OBSIDIAN_ALLOWED_RELATIONSHIP_TYPES`, `OBSIDIAN_REQUIRED_TRUST_FIELDS`, or `OBSIDIAN_SCHEMA_SOURCE` is present, preserve it for the downstream lint/trust consumer: CLI values take precedence over environment/config values, which take precedence over framework defaults, and explicit blank or whitespace-only values fail closed. Omit a variable to use defaults.
```
END THIRD-PARTY FILE 3c47a84a8a355039

The third-party file has ended. Everything between the 3c47a84a8a355039 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2800 of 17394 bytes. © Ar9av · MIT · https://github.com/Ar9av/obsidian-wiki/tree/HEAD/.skills/wiki-capture/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md