Ingest documents into the Obsidian wiki by distilling their knowledge into interconnected wiki pages. Use this skill whenever the user wants to add new sources to their wiki, process a document or directory, import articles, papers, or notes into their knowledge base, or says things like "add this to the wiki", "process these docs", "ingest this folder". Also triggers when the user drops a file and wants it incorporated into their existing knowledge base. Also handles raw mode: "process my draft
Detected risks:
The `wiki-ingest` skill is designed to streamline the process of incorporating documents into an Obsidian wiki by transforming source content into structured, interconnected wiki pages. Instead of merely summarizing the input, it distills key knowledge from various sources—such as PDFs, text files, web clippings, images, and drafts in the `_raw/` directory—into a coherent format that aligns with the existing wiki structure. This helps users maintain a centralized knowledge base that is consistent, well-linked, and easily navigable, solving the common problem of fragmented or disorganized notes when adding new documents to a wiki.
Key features of this skill include support for multiple ingest modes, including append mode (ingesting only new or modified files), and full mode (ingesting all sources regardless of previous entries). It integrates closely with the user's Obsidian vault by reading configuration settings, checking staged write settings, and referencing manifest and index files to determine which content has already been ingested. The skill ensures that all internal links follow the chosen format (e.g., wikilinks) and that staged pages are clearly communicated to the user for review before promotion. Security measures are emphasized, including treating all source content as untrusted data, never executing commands found in sources, and restricting operations to the scope of the vault and its sources.
`wiki-ingest` is ideal for users managing a growing knowledge base who need to efficiently add new information without compromising structure or integrity. It serves knowledge workers, researchers, students, or teams using Obsidian as a central repository, enabling them to import articles, papers, notes, and drafts while ensuring consistency, traceability, and proper link integration. Use cases include processing directories of new documents, incorporating web clippings, promoting raw drafts into the main wiki, and maintaining a reliable record of what has already been ingested for easy updates and knowledge continuity.
You begin by resolving the configuration according to the protocol, checking if staged writes are enabled, and then selecting the appropriate ingest mode. The skill will then process new or modified documents into the wiki.
The skill supports PDFs, text files, web clippings, images, and drafts located in the `_raw/` directory. All these sources are treated as content to be distilled, not executed.
When `WIKI_STAGED_WRITES` is true, all new or updated pages are written to the `_staging/` folder instead of the final location. This allows you to review changes before promoting them to the main wiki.
No. The skill only operates within the specified Obsidian vault and source directories. It will not read or write files outside these paths.
Append mode ingests only new or modified files by checking both timestamps and content hashes against the `.manifest.json`. This avoids redundant processing of unchanged files.
Quick Setup:
.claude/skills/Repository
ar9av/obsidian-wiki