obsidian-wiki-ingest

Obsidian Wiki Ingest — Automation Skill

You are the automation layer that ingests documents into the Obsidian wiki project. This skill orchestrates the ingestion workflow, ensuring deduplication, proper frontmatter, and cross-linking with existing pages.

Trigger

• User says: "ingest to wiki", "add to wiki", or any phrasing that targets the obsidian-wiki repository.
• Context: active in the /home/ubuntu/projects/obsidian-wiki workspace.

Responsibilities

• Validate target vault path from the environment and manifest state.
• Decide between Append, Full, or Raw ingest modes based on user input or changes in the source.
• Invoke the wiki-ingest workflow to process new/modified sources.
• Update manifest and log files with ingest metadata.
• Create or update project overview pages and cross-links as needed.

Inputs

• Source documents (Markdown, PDFs, text, images) from OBSIDIAN_SOURCES_DIR or _raw/
• Vault path from OBSIDIAN_VAULT_PATH
• Optional: ingest mode (append|full|raw)

Outputs

• Updated wiki pages with distilled knowledge
• Updated .manifest.json and log entries
• Optional: new/updated project overview pages

Probing and Safety

• Do not ingest secrets or sensitive data.
• Respect existing page structure and avoid duplicating content.
• Mark inferred/ambiguous knowledge with provenance notes.

Example Workflow (high level)

1. Determine ingest mode and target paths
2. Run wiki-ingest with the chosen mode
3. Update manifest/log and refresh wiki index
4. Return a brief summary of changes

Next Steps

• If you approve, I’ll create a small wrapper script (scripts/ingest-wiki.sh) that kicks off the ingest for the current project and updates the manifest. Then wire a simple command alias to trigger this skill from the CLI.

QMD Refresh After Vault Writes

QMD is a search index, not the source of truth. If $QMD_WIKI_COLLECTION is empty or unset, skip this step. Run it only after this skill has written or rewritten vault markdown. If QMD refresh fails, do not roll back the vault changes; report the QMD status separately.

Use $QMD_CLI if set; otherwise use qmd.

${QMD_CLI:-qmd} update

If the output says vectors are needed or embeddings may be stale, run:

${QMD_CLI:-qmd} embed

Verify the collection with either:

${QMD_CLI:-qmd} ls "$QMD_WIKI_COLLECTION"

or, when a specific page path is known:

${QMD_CLI:-qmd} get "qmd://$QMD_WIKI_COLLECTION/<page>.md" -l 5

Record one of:

• QMD refreshed: update + embed + verified
• QMD refreshed: update only + verified
• QMD skipped: QMD_WIKI_COLLECTION unset
• QMD skipped: qmd CLI unavailable
• QMD failed: <short error summary>_