Index of every page on this site: llms.txt
All skills
agricidaniel avatar

/wiki-fold

@2e54556
Run it yourself

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 log entries, commit the fold.

Use this Skill: https://skilld.dev/gh/agricidaniel/claude-obsidian/wiki-fold

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈85 tokens for metadata: the name and description. ≈1.1k when used: this file. ≈828 more on demand in 1 file.

Description uses 4.3% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈340 characters, or 4.3%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py"
test -f "$CORE"

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:

fold-k{K}-from-{EARLIEST-DATE}-to-{LATEST-DATE}-n{COUNT}

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. 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. 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:

python3 "$CORE" transaction inspect /path/to/fold-bundle.json --vault /path/to/vault
# Set APPROVAL_SHA256 to the inspect result's approval_sha256 after review.
python3 "$CORE" transaction apply /path/to/fold-bundle.json --vault /path/to/vault \
  --approved-plan-sha256 "$APPROVAL_SHA256"

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:

python3 "$CORE" checkpoint OPERATION_ID --vault /path/to/vault

Observe all selected entries, verify traceability and counts, then grow the rollup only from what its children actually say.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is designed to manage and roll up Obsidian log entries. It is categorized as low risk primarily due to its processing of untrusted markdown files from a user's vault, which creates a surface for indirect prompt injection, and its reliance on executing a local Python helper script for file operations.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

Signed by skilld at 2e54556. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Activeupdated 2 months ago

README badge

README badge for agricidaniel/claude-obsidian/wiki-fold