1How It Works & Mechanism
Pure knowledge-injection skill: SKILL.md injects the complete YAML schema and semantics of Obsidian Bases into the model context, allowing the model to produce valid .base files accordingly—with no scripts, CLI, or network resources involved in the directory.
skills/obsidian-bases/SKILL.mdThis skill enables skills-compatible agents to create and edit valid Obsidian Bases (`.base` files) including views, filters, formulas, and all related configurations.
What is being done here: Defines skill boundaries in a single sentence (creating/editing .base), relying entirely on textual specifications rather than executable code.
First defines file nature and hosting format: Bases are written in YAML and can exist as standalone .base files or embedded within Markdown code blocks.
skills/obsidian-bases/SKILL.mdObsidian Bases are YAML-based files that define dynamic views of notes in an Obsidian vault.
What is being done here: Prompts the model to first establish the mental model of 'Bases = YAML declarations' before diving into specific fields.
Provides a complete, copyable schema skeleton (covering the five sections: filters, formulas, properties, summaries, and views), clarifying that global filters apply across all views.
skills/obsidian-bases/SKILL.md# Global filters apply to ALL views in the base
What is being done here: Highlights scope semantics via comments to prevent the model from mistaking filters as view-level only.
Filter syntax follows a recursive and/or/not structure that can be applied globally or per view.
skills/obsidian-bases/SKILL.mdFilters narrow down results. They can be applied globally or per-view.
What is being done here: Establishes the two distinct scopes and nestable nature of filters.
The formula language computes values fetched from properties and can be reused across views once defined centrally in the formulas section.
skills/obsidian-bases/SKILL.mdFormulas compute values from properties. Defined in the `formulas` section.
What is being done here: Positions formulas as reusable derived properties.
The `this` keyword changes its reference target depending on context (main workspace = the .base file itself, embedded = the embedding file, sidebar = active file in the main workspace).
skills/obsidian-bases/SKILL.mdIn main content area: refers to the base file itself
What is being done here: Resolves the ambiguity of `this`, which is the most error-prone semantic concept in Bases formulas.
Supports four view types: table, cards, list, and map; map views depend on latitude/longitude properties and the Maps community plugin.
skills/obsidian-bases/SKILL.mdRequires latitude/longitude properties and the Maps community plugin.
What is being done here: Highlights external prerequisites for map views to prevent the model from blindly generating unusable views.
Delivery format supports Markdown embedding: either embedding the entire base or embedding only a specific view.
skills/obsidian-bases/SKILL.mdEmbed in Markdown files:
What is being done here: Bridges the usage between Bases and regular notes by providing the `![MyBase.base#View Name]` syntax.
2Core Capabilities
01Complete .base YAML schema: the five sections (filters, formulas, properties, summaries, views) and their respective fields
02Recursive filter syntax: single conditions, nested and/or/not logic, and view-level filters
03Formula syntax: arithmetic, conditionals, string formatting, date operations, and complex expressions
04Nine-category function library reference: global, date, string, number, list, file, link, object, and regex
05Four view types (table, cards, list, map) along with limit, groupBy, order, and summaries configurations
06Default summary formula table (15 items including Average, Min, Max, Sum, Median, Stddev) and custom summaries
07Markdown embedding: embedding whole files or targeting specific views
08YAML quoting rules and common filtering patterns (by tag, folder, date range, property value, and combined conditions)
4Recommended Governance & Evidence
Suggested Controls for Safe Operation
For Agent Runtime
Can be auto-loaded
For Administrators
Register source and version
Evidence & Triggers (File Paths & Excerpts)
- SKILL.md: Consists purely of prompt instructions and rule text, without script execution or external impact.
Audit Notes: Purely instruction-based: SKILL.md consists entirely of Markdown specifications and YAML examples. A §3 scan confirms no script execution, network requests, credential reading, disk writes, or dangerous flags. The directory contains only one file: SKILL.md. Note that .base syntax evolves with Obsidian versions; because the skill does not specify a target version, examples may lag behind.
5Second-Pass Verification
- [ok] 文件面核对（是否有未列脚本/资产） — §1 清单仅 skills/obsidian-bases/SKILL.md 一个文件（16442 字节 / 619 行），无 scripts/references/assets；bundle 未标「已截断」，无需额外 read。
- [ok] 外部资源条目复核 — §3 的 4 条 URL 全为文末 References 段的 help.obsidian.md 文档链接（syntax/functions/views/formulas），非运行时调用，故 external_deps 判空。
- [ok] 安全结论反例搜索 — §3 显示凭证/外部程序/写盘/网络请求/危险旗标/沙箱均无命中；全文为文本，无代码执行面。
- [ok] 能力清单是否夸大 — description 声称的 views/filters/formulas/summaries 均可在 §2 找到对应章节与示例；技能只产出 YAML，不生成渲染结果，无越界承诺。
- [ok] 档位判定复核 — 按 §4 口径，纯指令型且无任何脚本/网络/写盘 → 🟢 green 成立。
6Verdict & Scenarios
Handbook-level coverage of Bases syntax, enabling offline guidance for the model to generate valid .base files using a single document.Directly reusable examples covering four common use cases: task tracking, reading lists, project notes, and daily note indexes.Zero dependencies and zero execution surface—ready to use upon installation and completely secure.Best for: Users who need to create or edit Obsidian Bases (.base): building database-like note views such as task trackers, reading lists, and project kanbans; or injecting Bases syntax as specifications into models to avoid hallucinated fields.
Not for: Scenarios not using Obsidian Bases; situations requiring the skill to directly render visual outputs or automatically install the Maps plugin; or contexts sensitive to Bases versions that require strict synchronization with upstream cutting-edge syntax.