second-brain-backfill

Solid

Import a large archive into the vault in controlled batches: triage what is worth ingesting, process oldest first, checkpoint after every batch, and keep cost visible. Use this skill whenever the user wants to import years of bookmarks, an export from another notes app, a downloads folder, a chat history dump, or says "backfill", "bulk import", "process my archive". Do NOT use for ingesting one or a few new sources, which is second-brain-ingest.

AI & Automation 46 stars 7 forks Updated today MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
56
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
75
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Backfill an archive A backfill is where cost and quality both go wrong quietly. Done in the wrong order it also inverts the vault's history, because later sources should update pages that earlier ones created. ## Core rule Oldest first, ten sources per batch, stop for a go-ahead between batches. ## Workflow 1. **Triage before ingesting.** Read titles and first paragraphs. Sort into worth-ingesting, keep-in-raw, and delete. Most archives are half dead links and things saved but never opened. 2. **Order by date, oldest first.** Run it the other way and every old source arrives as a contradiction against a page that already has the final answer. 3. **Batch of ten.** Ingest following `second-brain-ingest`. 4. **Checkpoint:** update `index.md`, append to `log.md`, commit with the batch range in the message, report counts. 5. **Stop and wait** before the next batch. 6. **Full lint at the end.** Large imports always leave orphans and duplicates. ## Output format ``` Batch <n>/<total>: <range> Ingested: <n> sources -> <n> new pages, <n> updated, <n> links Skipped: <n> (reason) Running total: <n> of <n> Next batch: <what it contains> ``` ## Calibration Read every page the first batch produced, all of them. A flaw you let through in batch one is a flaw in four hundred pages by the end, and fixing it afterwards costs more than the original run. If the archive is over about two hundred sources, propose a filter before starting rather than quoting the full cost.

Details

Author
undefined-ui
Repository
undefined-ui/second-brain-os
Created
3 days ago
Last Updated
today
Language
HTML
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

second-brain-ingest

Turn raw source material in a second-brain vault into linked wiki pages: read the source, split it into concepts and entities, write or update pages, connect them to existing pages, and record the run in the log. Use this skill whenever the user drops a file into raw/, pastes an article, transcript or PDF and asks to add it to the vault, says "ingest this", "add this to my second brain", "process raw", or asks to catch up on unprocessed sources, even if they do not name the ingest command. Do NOT use for answering questions from an existing vault, for linting or repairing pages, or for editing notes the user wrote by hand.

46 Updated today
undefined-ui
AI & Automation Listed

brain-ingest

Work sources into the Brain — split PDFs/transcripts/articles from the vault's 00-inbox/raw/ (or a URL) into atomic, linked knowledge notes. Use when the user says "ingest", "work in this source", "split this PDF/transcript", or when new files land in raw/.

2 Updated 1 months ago
nikolajhh2008-svg
AI & Automation Solid

second-brain-lint

Audit a second-brain vault for structural problems and repair them: broken wikilinks, orphan pages, empty stubs, frontmatter that violates the schema, near-duplicate pages, and stale index entries. Use this skill whenever the user asks to lint, clean, audit or check the health of their vault, says pages feel messy or links are broken, after a large bulk import, or when a scheduled maintenance run fires. Do NOT use for ingesting new sources, for answering questions from the vault, or for rewriting page content that is structurally fine but reads badly.

46 Updated today
undefined-ui