archive-crawler

Mine personal file archives for high-value writing and ideas.

5|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/GYF0311/lorekit --skill archive-crawler-gyf0311
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: archive-crawler
Source: https://github.com/GYF0311/lorekit/tree/main/brain/skills/archive-crawler
Command: npx skills add https://github.com/GYF0311/lorekit --skill archive-crawler-gyf0311

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

archive-crawler helps you explore large personal file archives and surface the high-value writing, ideas, and relationship material worth ingesting into your wiki—without accidentally scanning or ingesting sensitive data.

Core Features & Use Cases

  • Safety-gated archive scanning: Refuses to run unless gbrain.yml explicitly allow-lists archive-crawler.scan_paths for the permitted scan roots.
  • Interactive triage with a persistent manifest: Builds an inventory and a priority queue, then records per-item review status and the user’s exact reactions in projects/<archive-slug>/STATUS.md.
  • Gold-filtered ingestion into brain pages: Reads candidate files, applies a “gold” relevance filter, and when you approve, files content into the appropriate brain directories based on your filing rules.
  • Multi-source archive support: Works across local mounts and multiple archive formats/targets (e.g., Dropbox/B2/Gmail takeouts/mbox/pst), while skipping noise like configs, system files, and binary junk.

Quick Start

Add an explicit allow-list under archive-crawler.scan_paths in your gbrain.yml, then tell the agent: "crawl my archive and surface the writing worth keeping".

Frequently Asked Questions about archive-crawler

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

FAQPage Schema
How do I safely scan personal file archives for high-value content without exposing sensitive data?▼

Safely scanning personal file archives requires an allow-list safety gate via gbrain.yml to explicitly permit scan roots, ensuring sensitive data is skipped while surfacing high-value writing and ideas for wiki ingestion.

Can I ingest Gmail takeout mbox files into my personal wiki?▼

Yes, you can ingest Gmail takeouts by adding the archive path to your allow-list, running the gold relevance filter, and approving prioritized items for schema-generic filing into your wiki directories.

What is the best way to triage large Dropbox archives for my personal knowledge base?▼

Triage large Dropbox archives by building an interactive priority queue that records per-item review status and user reactions in a persistent manifest, allowing guided review before wiki ingestion.

Does archive-crawler work with local directories and B2 cloud storage mounts?▼

Yes, archive-crawler works across local mounts and multiple archive formats including B2 cloud storage, applying a gold relevance filter to skip system files and binary junk during the scanning process.

How do I track the ingestion status of reviewed files from my personal archives?▼

Track ingestion status by maintaining a persistent manifest in projects/<archive-slug>/STATUS.md, which records per-item review status and your exact reactions during the interactive triage process.

Why does the archive scanning process refuse to run without configuration?▼

Archive scanning refuses to run without configuration to enforce data safety, requiring explicit allow-listing of scan_paths in gbrain.yml to prevent accidental scanning or ingestion of sensitive personal files.