New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Obsidian Bases Editor

by AgriciDaniel in 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.

MITAuto-check passedKnowledge Management

Install Obsidian Bases Editor

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

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

GitHub CLI
$ gh skill install AgriciDaniel/claude-obsidian obsidian-bases --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/obsidian-bases .claude/skills/obsidian-bases && 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
obsidian-bases
GitHub stars
15k
Token cost
~1.2k tokens
SKILL.md length
422 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 8 steps: Inspect representative note properties… → Define the smallest filter that selects… → Add formulas only for values that must… → …
  • Drafting a new Obsidian Bases .base file with filters and views
  • SKILL.md covers Workflow, Compact schema and Formula and YAML rules
  • Calls python3

What it does

The skill treats this content as a compact fallback reference, preferring a separately installed Bases skill or the official Bases syntax documentation for detailed or version-sensitive fields. Design and syntax questions are answered read-only; a requested edit instead resolves the user's vault and goes through one inspected transaction rather than writing the .base file directly, with the skill's own product root and script path resolved from its own installed location, never from the vault or the current working directory.

The workflow inspects representative note properties and any existing .base file, defines the smallest filter that selects the intended notes, adds formulas only where a value must be computed, and chooses views without assuming a type is supported by the user's Obsidian version or plugins, validating YAML, expression quoting and property names before previewing the complete file and its expected result set. An edit is built as one transaction bundle, inspected, then applied once with an approval hash set only after review; a .base file is YAML with top-level keys such as filters, formulas, properties, summaries and views.

When your agent uses it

  • Drafting a new Obsidian Bases .base file with filters and views
  • Adding a computed formula column to an existing Base
  • Editing an existing .base file's filters or view configuration safely

Example prompts

  • “Create a Base that filters notes tagged concept and shows them as cards.”
  • “Add a formula column to this Base that computes days since last modified.”
  • “Change this Base's table view to group by status.”

Requirements

  • An Obsidian vault with the Bases feature

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Inspect representative note properties and any existing .base file.
  2. Define the smallest filter that selects the intended notes.
  3. Add formulas only for values that must be computed.
  4. Choose views and display order. Do not assume a view type or option is
  5. Validate YAML, expression quoting, property names, formula references, and
  6. Preview the complete file and expected result set before a mutation.
  7. If an edit was requested, read
  8. Ask the user to render the Base in Obsidian when application-level behavior

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

    Links to these hosts (documentation or services it may open):

    • help.obsidian.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 Bases Editor loads about 1.2k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 422 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~1.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). 422 words, ~1,169 tokens.

Download SKILL.mdSave it as .claude/skills/obsidian-bases/SKILL.md (or your agent's skills folder).
name
obsidian-bases
description
Explain, draft, and validate Obsidian Bases .base files with filters, formulas, properties, summaries, and table, card, or list views. Use for Obsidian Bases, database-like vault views, dynamic tables, reading lists, task trackers, filters, formulas, summaries, and .base file edits.

Obsidian Bases

Use this as a compact workflow and fallback syntax reference. Prefer a separately installed kepano/obsidian-skills obsidian-bases skill, then the current official Bases syntax, for detailed or version-sensitive fields and functions.

Answer design and syntax questions read-only. For a requested .base edit, resolve the user vault and use one inspected transaction; never write the file directly.

Resolve the installed product root from this skill's own location, not from the vault or current working directory:

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.

Workflow

  1. Inspect representative note properties and any existing .base file.

  2. Define the smallest filter that selects the intended notes.

  3. Add formulas only for values that must be computed.

  4. Choose views and display order. Do not assume a view type or option is supported by the user's Obsidian version or installed plugins.

  5. Validate YAML, expression quoting, property names, formula references, and null handling.

  6. Preview the complete file and expected result set before a mutation.

  7. If an edit was requested, read operation-transactions.md, keep the .base file under wiki/, and build one claude-obsidian.transaction.v1 bundle with operation_type: base. Inspect it, then set APPROVAL_SHA256 to the returned approval_sha256 only after review and apply once:

    bash
    python3 "$CORE" transaction inspect "$BUNDLE" --vault "$VAULT"
python3 "$CORE" transaction apply "$BUNDLE" --vault "$VAULT" \
  --approved-plan-sha256 "$APPROVAL_SHA256"

  8. Ask the user to render the Base in Obsidian when application-level behavior cannot be verified locally.

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

Compact schema

.base files are YAML. Common top-level keys are filters, formulas, properties, summaries, and views.

yaml
filters:
  and:
    - file.inFolder("wiki")
    - 'status != "archived"'

formulas:
  age_days: '((now() - file.ctime) / 86400000).round(0)'
  status_label: 'if(status == "mature", "Ready", "Review")'

properties:
  status:
    displayName: "Status"
  formula.age_days:
    displayName: "Age (days)"

views:
  - type: table
    name: "Wiki pages"
    order:
      - file.name
      - type
      - status
      - updated
      - formula.age_days

Global filters apply to every view. A view may also define its own filters. Recursive filter objects use one of and, or, or not at each level.

yaml
filters:
  or:
    - file.hasTag("concept")
    - and:
        - file.hasTag("source")
        - 'status == "active"'

Use note properties by name, file metadata as file.name, file.path, file.folder, file.ext, file.ctime, file.mtime, or file.tags, and computed properties as formula.<name>.

Formula and YAML rules

  • Quote expressions that contain operators, colons, or nested string quotes.
  • Guard nullable properties with if().
  • Subtracting two dates returns a millisecond number. Divide by 86400000 before rounding when a whole-day count is intended.
  • Define every formula.<name> before referencing it in a view or property display configuration.
  • Do not transplant Dataview-only keys such as from or where into a Base.
  • Do not invent properties absent from the selected notes without explaining that the resulting column will be empty.
yaml
formulas:
  days_until: 'if(due_date, ((date(due_date) - today()) / 86400000).round(0), "")'

Table, cards, and list views are common:

yaml
views:
  - type: cards
    name: "Reading list"
    order:
      - file.name
      - author
      - status
  - type: list
    name: "Quick list"
    order:
      - file.name
      - status

Embed a Base or one named view in a Markdown note:

markdown
![[Dashboard.base]]
![[Dashboard.base#Wiki pages]]

After an applied edit, report the operation ID, exact changed path, validation performed, and anything that still requires rendering in Obsidian. Do not commit Git.

© 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

Just SKILL.md in skills/obsidian-bases of AgriciDaniel/claude-obsidian.

Open the folder on GitHubat commit 32ac5a0

Compare with similar skills

Obsidian Bases Editor 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 Bases Editor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obsidian Bases Editor 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
NexusProfSynapse/nexus157—~1.3kAutomated safety check: PassMIT
Obsidian Project Knowledge BaseGalaxy-Dawn/claude-scholar5.7k—~551Automated safety check: PassMIT
Obsidian Vault Operationsballred/obsidian-claude-pkm1.9k—~652Automated 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 yesterday
    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

  • Nexus

    ProfSynapse/nexus

    Read, search, and edit the user's Obsidian vault (notes, folders, canvas, bases, tasks, memory/workspaces, saved prompts) from the shell via the nexus CLI — no MCP connection needed.

    157 GitHub stars~1.3k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed

  • Obsidian Project Knowledge Base

    Galaxy-Dawn/claude-scholar

    Maintains a project-scoped Obsidian research knowledge base: bootstrapping its folders, routing notes, updating hub, plan and index notes, and linting.

    5.7k GitHub stars~551 tokensUpdated 16 days ago
    Knowledge ManagementAuto-check passed

  • Obsidian Vault Operations

    ballred/obsidian-claude-pkm

    Reads, creates and edits notes in an Obsidian vault while preserving wiki-links, YAML frontmatter, tags and template variables.

    1.9k GitHub stars~652 tokensUpdated 7 mo ago
    Knowledge ManagementAuto-check passed

  • Luhmann Note Numberer

    twhsi/skills

    Assigns and checks Luhmann-style codes for book manuscript notes and Obsidian card folders without renumbering existing notes.

    259 GitHub stars~1.5k tokensUpdated 2 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 29 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 29 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 29 days ago
    Auto-check passed

  • Obsidian Wiki Log Fold

    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.

    15k GitHub stars~1.2k tokensUpdated 29 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 29 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 29 days ago
    Auto-check passed

Works with

Categories

Questions about Obsidian Bases Editor

What does Obsidian Bases Editor do?

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. The skill treats this content as a compact fallback reference, preferring a separately installed Bases skill or the official Bases syntax documentation for detailed or version-sensitive fields.base file directly, with the skill's own product root and script path resolved from its own installed location, never from the vault or the current working directory.

When should I use Obsidian Bases Editor?

Obsidian Bases Editor fits situations like: drafting a new Obsidian Bases .base file with filters and views; adding a computed formula column to an existing Base; editing an existing .base file's filters or view configuration safely.

How do I install Obsidian Bases Editor in Claude Code?

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

How do I install Obsidian Bases Editor in Codex?

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

Can I use Obsidian Bases Editor 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 obsidian-bases -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/obsidian-bases, .gemini/skills/obsidian-bases, .github/skills/obsidian-bases and .opencode/skills/obsidian-bases in your project.

What does Obsidian Bases Editor need to run?

Going by SKILL.md and its folder, Obsidian Bases Editor needs the command-line tools its instructions call (python3). Our summary lists: An Obsidian vault with the Bases feature.

Does Obsidian Bases Editor access the network?

SKILL.md names 1 domain. As links in the text: help.obsidian.md. This is read from the text; nothing was executed.

Is Obsidian Bases Editor 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 Bases Editor use?

Obsidian Bases Editor 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 Bases Editor use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Obsidian Bases Editor?

Skills that share tags, products or a category with Obsidian Bases Editor: My LLM Wiki (MartinLwx/dotfiles, 140 stars), Obsidian Knowledge Builder (Michael-OvO/obsidian-knowledge-agent, 205 stars), Nexus (ProfSynapse/nexus, 157 stars) and Obsidian Project Knowledge Base (Galaxy-Dawn/claude-scholar, 5.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Obsidian Bases Editor?

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.