ingest

Scan knowledge/raw files and create structured vault notes with wiki-links.

16|9|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/sonthanh/brain-os-plugin --skill ingest-sonthanh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ingest
Source: https://github.com/sonthanh/brain-os-plugin/tree/main/skills/ingest
Command: npx skills add https://github.com/sonthanh/brain-os-plugin --skill ingest-sonthanh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ingests raw knowledge inputs into structured vault notes.

Core Features & Use Cases

  • Scans the knowledge/raw folder to identify unprocessed files and detects the source type (book, article, podcast, course) for tailored ingestion.
  • Creates or updates vault notes under the appropriate path (e.g., knowledge/books/[book-slug].md) using a standard Book Note Template, and links related vault items via wiki-links.
  • Marks each raw file as processed and provides a summary of ingestion results, supporting both bulk and single-file workflows.

Quick Start

Run /ingest to process all pending raw files, or use /ingest [filepath] to process a specific file.

Frequently Asked Questions about ingest

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn raw book notes into structured vault notes?

To turn raw book notes into structured vault notes, run /ingest to scan the knowledge/raw folder, extract metadata and quotes, then save the output under knowledge/books using a standard Book Note Template.

Can I process multiple raw knowledge files at once?

Yes, you can process multiple raw knowledge files at once by running /ingest, which scans the knowledge/raw directory, detects source types like articles or podcasts, and bulk-ingests all pending files into structured vault notes.

What types of knowledge sources can be ingested into vault notes?

Vault notes can be ingested from books, articles, podcasts, and courses. The ingest process detects the source type from the raw file and applies tailored extraction for metadata, concepts, quotes, and wiki-links.

How does ingest prevent processing the same raw file twice?

Ingest prevents duplicate processing by updating the frontmatter of each raw file with processed: true after extraction. This marks the file as completed and prevents it from being re-scanned in subsequent bulk ingestion runs.

Do I need a specific folder structure to create wiki-links between vault notes?

Yes, you need a specific folder structure. Raw files must be placed in the knowledge/raw folder, and the tool will generate processed notes under knowledge/books or knowledge/[type], creating wiki-links between related vault items automatically.