quaid-ingest

Ingest source documents into Quaid knowledge bases as idempotent brain pages.

3|3|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/quaid-app/quaid --skill quaid-ingest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quaid-ingest
Source: https://github.com/quaid-app/quaid/tree/main/skills/ingest
Command: npx skills add https://github.com/quaid-app/quaid --skill quaid-ingest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ingesting raw source documents into Quaid can be error-prone and non-idempotent; this skill ensures imports create structured brain pages and avoids unnecessary duplicates by hashing exact bytes.

Core Features & Use Cases

  • Ingests single files and directory batches with optional force re-ingest.
  • Supports frontmatter-aware Markdown and generation of canonical pages for long-term knowledge bases.
  • Enables vault-backed syncing and export of pages for external consumption.

Quick Start

Ingest a sample document to create a brain page and verify idempotency on re-ingest.

Frequently Asked Questions about quaid-ingest

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

FAQPage Schema
How do I ingest markdown documents into a knowledge base without creating duplicates?

Idempotent markdown ingestion uses exact-byte hashing to identify source documents, ensuring re-ingesting the same files produces structured brain pages without generating unnecessary duplicates. You can ingest single files or directory batches while maintaining a clean knowledge base.

What is idempotent document syncing and when do I need it for batch ingestion?

Idempotent document syncing ensures repeated batch ingestion of source files yields the same canonical brain pages without redundant data. You need it when importing directories into a knowledge base to prevent duplicate entries during live syncing or re-imports.

How do I force re-ingest of markdown files that have frontmatter in a vault?

You can trigger a force re-ingest of frontmatter-aware markdown files to overwrite existing brain pages and regenerate canonical content. This vault-backed syncing action bypasses exact-byte duplicate checks to update your knowledge base with modified source documents.

Does Quaid ingest require frontmatter support in markdown files?

Yes, Quaid ingest requires frontmatter support in ingested markdown to properly generate structured brain pages and manage namespaces. This frontmatter-aware process ensures documents are correctly categorized during single-file or batch ingestion into the knowledge base.

What's the best way to manage namespaces when ingesting raw source documents?

Managing namespaces during raw source document ingestion involves using Quaid's built-in wings management to organize canonical brain pages. This structured approach ensures ingested markdown files are correctly partitioned within the knowledge base during batch operations or live syncing.

Why does my batch ingest create duplicate brain pages on re-sync?

Duplicate brain pages during batch ingest re-syncs indicate the exact-byte hashing mechanism was bypassed or the force re-ingest option was used. Proper idempotent syncing uses byte-level hashing to prevent these duplicates unless an explicit overwrite is required.