Agent skill

Obsidian Wiki Log Fold

by AgriciDaniel in AgriciDaniel/claude-obsidian

Creates a bounded, extractive rollup of recent Obsidian wiki log entries, previewed by default, with one optional apply step and no changes to child pages.

MITAuto-check passedKnowledge Management

Install Obsidian Wiki Log Fold

skills CLI
$ npx skills add AgriciDaniel/claude-obsidian --skill wiki-fold -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/claude-obsidian wiki-fold --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/claude-obsidian.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/wiki-fold .claude/skills/wiki-fold && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wiki-fold
GitHub stars
15k
Token cost
~1.2k tokens
SKILL.md length
519 words
Files
2 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Creates a bounded, extractive rollup of recent Obsidian wiki log entries, previewed by default, with one optional apply step and no changes to child pages.

  • Compressing a run of Obsidian wiki log entries into a rollup
  • SKILL.md covers Select a bounded range, Draft extractively and Preview by default
  • Calls python3
  • Previewing a log fold before committing it

What it does

The skill folds raw wiki/log.md entries into an additive rollup page without modifying, moving or deleting the entries or their pages, and it never folds a fold or triggers one by itself. It finds your vault from an explicit --vault, the CLAUDE_OBSIDIAN_VAULT variable, workspace config or the current directory, and never treats the plugin root as a vault. It needs no network access.

A batch holds 2 to the power k entries, with k defaulting to 4, and if fewer exist it reports the shortfall and stops. The agent reads the selected entries fully and child pages only when needed, with a target of 0 to 10 reads and a ceiling of 15, then builds a structural ID from the exponent, date range and count. An existing fold page makes the run a no-op. The draft follows fold-template.md, every outcome must cite its source entry, every number must be checkable, and checks on the ID, frontmatter and table matching, numeric traceability and untouched sources run before any write is proposed.

When your agent uses it

  • Compressing a run of Obsidian wiki log entries into a rollup
  • Previewing a log fold before committing it
  • Keeping wiki log history readable without editing child pages

Example prompts

  • “Run wiki-fold and show me the dry-run preview.”
  • “Fold the latest log entries and commit the fold if the checks pass.”
  • “Roll up the log entries from this month.”

Requirements

  • An Obsidian vault with a wiki/log.md file
  • The installed claude-obsidian plugin and its Python core script

What it can do on your machine

Read from SKILL.md and the folder at commit 32ac5a0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Obsidian Wiki Log Fold loads about 1.2k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 85 tokens; SKILL.md has 519 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/claude-obsidian at commit 32ac5a0, republished under its MIT licence (© AgriciDaniel). 519 words, ~1,154 tokens.

Download SKILL.mdSave it as .claude/skills/wiki-fold/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
wiki-fold
description
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.

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.

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

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

Show full SKILL.md (167 more words)Show less

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:

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

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

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/wiki-fold of AgriciDaniel/claude-obsidian.

  • SKILL.md
  • references/fold-template.md

Open the folder on GitHubat commit 32ac5a0

Compare with similar skills

Obsidian Wiki Log Fold next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Obsidian Wiki Log Fold compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obsidian Wiki Log Fold this skillAgriciDaniel/claude-obsidian15k—~1.2kAutomated safety check: PassMIT
My LLM WikiMartinLwx/dotfiles140—~2.7kAutomated safety check: PassNone
Obsidian Knowledge BuilderMichael-OvO/obsidian-knowledge-agent205—~917Automated safety check: PassMIT
LLM Wikilewislulu/llm-wiki-skill655—~3.7kAutomated safety check: PassNone
Swarmvaultswarmclawai/swarmvault708—~6.1kAutomated safety check: PassMIT
Karpathy WikiSherwinQ/karpathy-wiki114—~967Automated safety check: PassMIT

Similar skills

  • My LLM Wiki

    MartinLwx/dotfiles

    Provides access to the user's personal wiki, including notes, research, project documentation, decisions, and archived knowledge.

    140 GitHub stars~2.7k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Obsidian Knowledge Builder

    Michael-OvO/obsidian-knowledge-agent

    Turns PDFs, slides, syllabi, papers and transcripts into structured, teaching-quality Obsidian notes, matching how much structure is built to how much the material needs.

    205 GitHub stars~917 tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    lewislulu/llm-wiki-skill

    Build and maintain a Karpathy-style LLM knowledge base — a self-compiling Obsidian markdown wiki where an Agent ingests raw sources, compiles cross-linked concept/entity/summary pages, answers…

    655 GitHub stars~3.7k tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • Swarmvault

    swarmclawai/swarmvault

    Use SwarmVault when the user needs a local-first knowledge vault that writes durable markdown, graph, search, dashboard, review, chat-session, context-pack, task-ledger, static AI export, retrieval…

    708 GitHub stars~6.1k tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed
  • Karpathy Wiki

    SherwinQ/karpathy-wiki

    A skill your agent uses when building or maintaining a personal knowledge base with LLM assistance.

    114 GitHub stars~967 tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • AI Second Brain

    charlie947/ai-second-brain

    Walks the user through Charlie Hills's AI Second Brain + Karpathy Wiki setup from the MarTech AI newsletter.

    187 GitHub stars~3.5k tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed

More from AgriciDaniel/claude-obsidian

All 15 skills in this repo
  • Bounded Autoresearch

    AgriciDaniel/claude-obsidian

    Runs a bounded, source-grounded research loop that drafts a cited dossier and can propose a separately reviewed merge into an Obsidian vault.

    15k GitHub stars~1.6k tokensUpdated 28 days ago
    Auto-check passed
  • Obsidian Canvas Boards

    AgriciDaniel/claude-obsidian

    Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.

    15k GitHub stars~1.4k tokensUpdated 28 days ago
    Auto-check passed
  • Obsidian Wiki Vault Setup

    AgriciDaniel/claude-obsidian

    Sets up or adopts a separate Obsidian knowledge vault through the claude-obsidian core script and routes follow-up work to the right wiki sub-skill.

    15k GitHub stars~1.3k tokensUpdated 28 days ago
    Auto-check passed
  • Defuddle Web Page Cleaner

    AgriciDaniel/claude-obsidian

    Plans, and with explicit network consent runs, an external Defuddle extractor that turns an article-like HTTPS page into clean Markdown for later wiki ingestion.

    15k GitHub stars~1.1k tokensUpdated 28 days ago
    Auto-check passed
  • Obsidian Bases Editor

    AgriciDaniel/claude-obsidian

    Explains, drafts and validates Obsidian Bases .base files, building filters, formulas and table, card or list views, and applying edits only through one inspected transaction.

    15k GitHub stars~1.2k tokensUpdated 28 days ago
    Auto-check passed
  • Obsidian Markdown Syntax

    AgriciDaniel/claude-obsidian

    Explains, drafts and validates Obsidian Flavored Markdown such as properties, wikilinks, embeds, callouts and Mermaid, with vault edits applied through approved transactions.

    15k GitHub stars~1.1k tokensUpdated 28 days ago
    Auto-check passed

Works with

Questions about Obsidian Wiki Log Fold

What does Obsidian Wiki Log Fold do?

Creates a bounded, extractive rollup of recent Obsidian wiki log entries, previewed by default, with one optional apply step and no changes to child pages. md entries into an additive rollup page without modifying, moving or deleting the entries or their pages, and it never folds a fold or triggers one by itself. It finds your vault from an explicit --vault, the CLAUDE_OBSIDIAN_VAULT variable, workspace config or the current directory, and never treats the plugin root as a vault.

When should I use Obsidian Wiki Log Fold?

Obsidian Wiki Log Fold fits situations like: compressing a run of Obsidian wiki log entries into a rollup; previewing a log fold before committing it; keeping wiki log history readable without editing child pages.

How do I install Obsidian Wiki Log Fold in Claude Code?

Run `npx skills add AgriciDaniel/claude-obsidian --skill wiki-fold -a claude-code`. Or copy the skill folder (skills/wiki-fold in AgriciDaniel/claude-obsidian) into .claude/skills/wiki-fold in your project. Claude Code loads it when a task matches its description.

How do I install Obsidian Wiki Log Fold in Codex?

Run `npx skills add AgriciDaniel/claude-obsidian --skill wiki-fold -a codex`. Or copy the skill folder (skills/wiki-fold in AgriciDaniel/claude-obsidian) into .agents/skills/wiki-fold in your project. Codex loads it when a task matches its description.

Can I use Obsidian Wiki Log Fold in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/claude-obsidian --skill wiki-fold -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wiki-fold, .gemini/skills/wiki-fold, .github/skills/wiki-fold and .opencode/skills/wiki-fold in your project.

What does Obsidian Wiki Log Fold need to run?

Going by SKILL.md and its folder, Obsidian Wiki Log Fold needs the command-line tools its instructions call (python3). Our summary lists: An Obsidian vault with a wiki/log.md file; The installed claude-obsidian plugin and its Python core script.

Does Obsidian Wiki Log Fold access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Obsidian Wiki Log Fold safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Obsidian Wiki Log Fold use?

Obsidian Wiki Log Fold is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Obsidian Wiki Log Fold use?

About 1.2k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 828 tokens, read only when the agent opens those files.

What are the alternatives to Obsidian Wiki Log Fold?

Skills that share tags, products or a category with Obsidian Wiki Log Fold: My LLM Wiki (MartinLwx/dotfiles, 140 stars), Obsidian Knowledge Builder (Michael-OvO/obsidian-knowledge-agent, 205 stars), LLM Wiki (lewislulu/llm-wiki-skill, 655 stars) and Swarmvault (swarmclawai/swarmvault, 708 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Obsidian Wiki Log Fold?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-obsidian, which has 15,420 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 10, 2026.

Source: AgriciDaniel/claude-obsidian on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.