SkillAgentSearch skills...

wiki-capture

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.

Install / Use

npx skills add Ar9av/obsidian-wiki --skill wiki-capture

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

95/100

Supported Platforms

Universal

Tags

Our assessment of wiki-capture

wiki-capture scores 95/100 on our quality scale, 127th of 1,155 Content & Media skills we index (top 11%).

Its SKILL.md is 17 KB long, well organised into 37 sections with 15 code examples: a thorough specification that gives an agent plenty to work with.

With 3,485 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so wiki-capture is actively maintained.
  • Our last check on 2026-11-16 could not reach the source (HTTP 404); it may have been moved or deleted.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

wiki-capture compared with similar skills

All 4 of these similar skills score higher than wiki-capture; compare them before choosing.

SkillScoreStarsUpdatedFormat
wiki-capture (this skill)by Ar9av953.5k54d agoSKILL.md
siyuanby siyuan-note10047.3ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md

Frequently asked questions

How do I install wiki-capture?
Run npx skills add Ar9av/obsidian-wiki --skill wiki-capture. The install tabs above show the steps for each supported agent.
Which AI agents does wiki-capture work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is wiki-capture safe to use?
It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is wiki-capture still maintained?
The repository was last updated about 2 months ago, so wiki-capture is actively maintained.

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.

  2. Gate — KEEP or SKIP? Before extracting, judge whether this session has capture value. This keeps the skill safe to call automatically without spamming _raw/.

    • SKIP (exit with "Nothing worth capturing in this session.") if ALL are true: the conversation is purely conversational (planning/Q&A/explanation) with no implementation; no errors, debugging, or problem-solving visible; nothing surprising or undocumented; every finding is already obvious from the docs.
    • KEEP (proceed) if ANY are true: a fix or workaround was found through investigation; non-obvious library/API/framework behavior was confirmed (edge case, undocumented constraint, time-costing gotcha); a debugging session reached a concrete conclusion; a reusable pattern emerged.
    • When invoked via the Stop hook, err toward SKIP — only KEEP on clear evidence. When invoked manually, err toward KEEP — the user called it for a reason.
  3. Scan for reusable findings — non-obvious bugs and root causes, framework/library gotchas, surprising API behavior, investigated workarounds, environment/toolchain quirks, patterns from debugging. Skip PM updates, config already in CLAUDE.md, inconclusive back-and-forth, anything obvious from the docs, and pleasantries. If nothing material emerged, say so and stop.

  4. Cluster by topic — one _raw/ file per topic cluster, not per finding. Name each as a kebab-case slug (e.g. swift-actor-reentrancy, nextjs-hydration-mismatch).

  5. Infer project context from repo names, file paths, framework mentions, error messages. Use the most specific name you can reliably infer; else null.

  6. Write raw files — for each cluster, write $OBSIDIAN_RAW_DIR/<ISO-date>-<slug>.md. Read references/RAW-FORMAT.md for the full frontmatter spec, finding-block body structure, and provenance/confidence calibration. Per-cluster fields that vary: title, tags (2–4 from taxonomy), summary (≤200 chars), project (inferred or null), base_confidence (0.6 discussed → 0.75 fix applied → 0.9 test confirmed), provenance.extracted/provenance.inferred (sum to 1.0), lifecycle_changed (today), sources ("<project> session (<YYYY-MM-DD>)").

  7. Confirm — list staged files and tell the user to run /wiki-ingest to promote them:

    Staged to _raw/:
      _raw/2026-05-27-swift-actor-reentrancy.md   — "Actor reentrancy causes deadlock in async forEach"
    Run /wiki-ingest to promote these to full wiki pages.
    

    Quick mode deliberately does not write the manifest, index.md, log.md, hot.md, or refresh QMD — promotion via /wiki-ingest handles all of that. Stop here; do not run the full-mode steps below.


Correction Mode (--correction)

Use this mode when a user or stronger authority corrects a claim derived from an immutable conversation, tool result, or other raw source. Never edit or copy the raw source. Resolve config, read the vault AGENTS.md, and update an existing derived page when one owns the claim; otherwise create the smallest owner-compliant derived correction page.

Record exactly one atomic claim pair. speaker_type is semantic and must be assessed independently of a serialized message role (a tool result may be serialized as role=user). Do not include raw transcript excerpts.

correction_id: <stable-id>
source_locator: <immutable file:line or channel/thread/timestamp>
source_text_sha256: <64 lowercase hex chars>
serialized_role: <source role, if present>
speaker_type: user | assistant | teammate | tool_result | slack_member
original_claim:
  subject: <exact entity or capability>
  assertion: <single atomic value>
corrected_claim:
  subject: <same exact entity or capability>
  assertion: <single atomic value or null>
authority_class: contract | decision | code | test | deploy | runtime | db | narrative
verification_state: verified | inferred | unverified | contradicted
asserted_at: <ISO-8601 timestamp>
effective_at: <ISO-8601 timestamp or null>
as_of: <ISO-8601 timestamp>
supersedes: [<original-claim-id>]
consumer_propagation:
  kw: open | not_applicable | complete
  ob: open | not_applicable | complete
  requirements: open | not_applicable | complete
  code: open | not_applicable | complete
  tests: open | not_applicable | complete
  ai_memory: open | not_applicable | complete
corrected_at: <ISO-8601 timestamp>

Before any derived write, compute source_pre_sha256 directly from the immutable source and require it to equal source_text_sha256. After writing the correction and updating derived consumers, recompute source_post_sha256 from the same locator. Abort and report an immutability violation unless source_pre_sha256 == source_post_sha256 == source_text_sha256. This verification is mandatory even when the correction write succeeds.

After writing the derived correction, link the immutable source to the created/updated page through .manifest.json, append only the correction ID and affected-page counts to log.md, and propagate the atomic correction to every consumer independently. Mark a consumer complete only after verifying that consumer; do not collapse mixed results into a single aggregate status. Keep secrets, raw excerpts, and source copies out of the correction record.


Full Mode

Before You Start

  1. Resolve config — follow the Config Resolution Protocol in llm-wiki/SKILL.md (inline @name override → walk up CWD for .env → global config → prompt setup). This gives OBSIDIAN_VAULT_PATH and OBSIDIAN_LINK_FORMAT (default: wikilink).
  2. Read $OBSIDIAN_VAULT_PATH/index.md to understand existing wiki content (avoid duplicates)
  3. Read $OBSIDIAN_VAULT_PATH/hot.md if it exists — it gives context on recent activity

When writing internal links in Step 5, apply the link format from llm-wiki/SKILL.md (Link Format section) using the OBSIDIAN_LINK_FORMAT value.

Step 1: Identify What's Worth Preserving

Scan the conversation. Ask: what knowledge emerged here that would be valuable in 3 months with no memory of this chat?

Worth preserving:

  • Decisions made and why they were made
  • Analysis, frameworks, mental models developed
  • Technical findings, patterns, or procedures
  • Synthesized understanding of a topic
  • Clear explanations of a concept that took effort to arrive at
  • Key facts from an external source discussed in the conversation

Skip:

  • Logistics, scheduling, pleasantries
  • Exploratory back-and-forth where no conclusion was reached
  • Content that's already in the wiki

If nothing material emerged, tell the user and stop.

Step 2: Classify the Content Type

Assign one of five types — this determines the target folder and tone:

| Type | Description | Target folder | |---|---|---| | synthesis | Multi-step analysis or an answer to a specific question that required reasoning | synthesis/ | | concept | A definition, framework, or mental model (what a thing is) | concepts/ | | source | Summary of an external document, article, or resource discussed | references/ | | decision | A strategic, architectural, or design choice and its rationale | synthesis/ | | session | A complete discussion summary when the conversation spans multiple topics | journal/ |

If the content clearly belongs to a specific project (detected from context or user mention), place it under projects/<project-name>/<category>/ instead.

Step 3: Rewrite as Declarative Knowledge

Do not write a summary of the conversation. Write the knowledge itself, in declarative present tense:

  • Not: "The user asked about X and Claude explained that..."
  • Yes: "X works by..."
  • Not: "We decided to use Y because..."
  • Yes: "Y is preferred over Z because [reason]. [^[inferred] if the rationale was implied, not stated explicitly]"

Apply provenance markers per llm-wiki:

  • Extracted — explicitly stated in the conversation (no marker)
  • Inferred — generalized or synthesized from the conversation → ^[inferred]
  • Ambiguous — disputed, uncertain, or contradictory → ^[ambiguous]

Step 4: Generate a Slug and Title

Derive a clear, descriptive title from the content. Slugify it:

  • Lowercase, words separated by hyphens
  • Max 50 characters
  • Avoid dates in the slug (the frontmatter has created)

Step 5: Write the Wiki Note

Create the file at the target path with required frontmatter:

---
title: >-
  <Title>
category: <synthesis|concepts|references|journal|skills>
tags: [<2-5 domain tags from taxonomy>]
sources:
  - conversation:<ISO-date>
created: <obsidian-wiki memory now>
updated: <obsidian-wiki memory now>
summary: >-
  <1-2 sentences, ≤200 chars, answering "what knowledge does this page hold?">
provenance:
  extracted: 0.X
  inferred: 0.X
  ambiguous: 0.X
base_confidence: 0.42
lifecycle: draft
lifecycle_changed: <obsidian-wiki memory now --date>
---

Body structure by type:

synthesis / decision:

# Title

## Context
<What prompted this — the problem or question being addressed>

## Finding / Decision
<The core knowledge or conclusion>

## Reasoning
<Why this is the case or why this choice was made>

## Implications
<What follows from this — what to watch for, next steps, tra

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars3.5k
CategoryContent
Updated1mo ago
Forks345

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions