ingest

Convert URLs, PDFs, markdown, and text into wikilinked vault pages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the friction of converting scattered source material (URLs, PDFs, transcripts, and pasted text) into consistent, searchable notes in your personal markdown vault.

Core Features & Use Cases

  • End-to-end ingest loop: Reads a source, extracts key information, writes a synthesis page, touches related pages, updates index.md, and appends to log.md.
  • Multi-source support: Handles media URLs (YouTube/podcasts), existing markdown, web articles, PDFs, and dropped text with the appropriate pipeline per type.
  • Vault graph building: Produces pages with wikilinks and aggressively links named entities so your note graph stays navigable over time.
  • Never-summarize synthesis: Generates deep-dive artifacts (with TL;DR, findings, tensions, gaps, and actionable takeaways) rather than only compressing text.
  • Bulk ingest mode: Batches log entries and writes a manifest while skipping known boilerplate/config files to keep vault hygiene intact.
  • Safety guardrails: Avoids ingesting secrets and operational clutter, and includes error handling for transcript acquisition failures.

Quick Start

Use ingest to add a YouTube video URL to your vault by saying: ingest this https://www.youtube.com/watch?v=VIDEO_ID.

Frequently Asked Questions about ingest

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

FAQPage Schema
How do I convert a YouTube transcript into a deep-dive markdown note?

To convert a YouTube transcript into a deep-dive markdown note, the ingest pipeline acquires the transcript, creates a raw record, and generates a synthesis page with TL;DR, findings, and actionable takeaways. It then updates your vault index and log.

Can I batch ingest multiple PDFs and URLs into a vault at once?

You can batch ingest multiple PDFs and URLs using the bulk directory ingest mode. This process batches log entries, writes a manifest, and skips known boilerplate or config files to maintain vault hygiene during mass processing.

What is the best way to index web articles into a personal knowledge base without just summarizing?

Indexing web articles into a personal knowledge base without just summarizing requires a never-summarize synthesis approach. This method generates deep-dive artifacts detailing tensions, gaps, and actionable takeaways while enriching wikilinks for graph navigation.

Does this markdown vault ingestion process support extracting text from dropped text and existing markdown files?

The markdown vault ingestion process supports extracting text from dropped text and existing markdown files. It applies appropriate pipelines per source type, enriches named entities with wikilinks, and updates the vault index consistently.

What happens if transcript acquisition fails during channel-based ingest?

If transcript acquisition fails during channel-based ingest, the process triggers built-in error handling. This safety guardrail prevents broken records from entering the vault and halts the synthesis pipeline for that specific source.

How does vault indexing handle operational clutter and sensitive information?

Vault indexing handles operational clutter and sensitive information through dedicated safety guardrails. The ingestion process actively avoids ingesting secrets and skips known boilerplate files to keep your personal markdown vault clean and secure.