wiki-fold
Create a bounded, extractive, structurally idempotent rollup of recent Obsidian wiki log entries, with dry-run preview by default and one optional transaction apply. Use for manual log compression without modifying child pages. Triggers: fold the log, run a fold, run wiki-fold, log rollup, roll up l
By agricidaniel · 354 installs
npx skills add agricidaniel/claude-obsidian --skill wiki-fold
Source repository · Upstream listing
Extractive log fold
Create an additive rollup of raw wiki/log.md entries. Never modify, move, or
delete child entries or their pages. Do not perform fold of folds or trigger a
fold automatically.
Resolve the portable core from this skill's installation. Resolve the user vault
by explicit vault , CLAUDE OBSIDIAN VAULT , workspace config, then
current directory discovery. Never treat the plugin/product root as a vault.
Every ../wiki/references/ link in this file resolves the same way, relative
to this skill's own directory under $PRODUCT ROOT , never relative to the
selected vault's wiki/ directory.
This skill needs no network egress. Do not call external services.
Select a bounded range
Use batch exponent k with size 2^k ; default to k=4 . An explicit entry range
may override it. If fewer entries exist than requested, report the shortfall and
stop rather than folding a partial batch.
Read the selected log entries completely. Read referenced child pages only when
the log lacks enough context: target 0 10 reads, hard ceiling 15. Missing pages
remain explicit page missing records.
Derive the structural ID only from inputs:
If wiki/folds/{FOLD ID}.md already exists, return a no op. Replacing it requires
an explicit force request and a separately reviewed replace proposal.
Draft extractively
Follow [fold template.md](references/fold template.md). Every child log entry must
have one deterministic child key in frontmatter and exactly one matching row
in the Child Entries table. Do not deduplicate children by page, although the
final Child Pages link list may be deduplicated.
Every outcome must name its source entry. Every number must be verifiable in the
selected entry. A cross entry theme must name at least two contributing entries.
Prefer ambiguous in source or source missing to invention. When a child page
and log entry disagree, preserve both and identify the mismatch; the log entry is
the fold's primary source.
Run these checks before proposing any write:
deterministic ID and exact entry count;
frontmatter/table bijection;
numeric traceability;
source citation for every outcome and theme;
no change to a child, source, source ledger, or claim ledger.
A fold adds no new factual evidence, so it does not upgrade claim assessments or
create source records. Report discovered contradictions for later review instead
of editing canonical claims.
Preview by default
Return the complete fold draft, ID, child range, read budget, and proposed changed
paths without modifying the vault. Parallel agents may check child entries and
return extracts, but only the orchestrator assembles the fold; workers never
write.
When the user explicitly says to apply or commit the fold, build one
claude obsidian.transaction.v1 bundle with operation type: fold . Read
[the transaction contract](../wiki/references/operation transactions.md). Couple:
wiki/folds/{FOLD ID}.md in create mode by default;
the fold catalog entry in wiki/index.md ;
one new top of file fold entry in wiki/log.md .
Do not update wiki/hot.md . Record SHA 256 preconditions for all three targets.
Do not use host Write/Edit, Obsidian transport writes, deprecated locks, automatic
commits, or one apply per file.
Inspect before the single apply:
Report the operation ID and exact changed paths. The identical bundle and ID are
idempotent. On exit 75, re read and rebuild; after interruption, use
transaction recover .
Git history is a separate optional action:
Observe all selected entries, verify traceability and counts, then grow the
rollup only from what its children actually say.