obsidian-bases
内容创作者与技术写作员在管理海量笔记时,当需要构建 Obsidian 数据库视图、配置过滤器或编写 YAML 公式,使用此技能可自动生成标准 .base 文件,轻松实现笔记的表格/卡片多维展示与数据汇总,让知识库管理效率翻倍。
Install / Use
npx skills add anbeime/skill --skill obsidian-basesInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of obsidian-bases
obsidian-bases scores 93/100 on our quality scale, 605th of 4,698 Development & Engineering skills we index (top 13%).
Its SKILL.md is 17 KB long, well organised into 64 sections with 19 code examples: a thorough specification that gives an agent plenty to work with.
With 7,172 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so obsidian-bases is actively maintained.
- Our last check on 2026-10-26 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-27. Automated pattern scan on 2026-09-27. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
obsidian-bases compared with similar skills
All 4 of these similar skills score higher than obsidian-bases; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| obsidian-bases (this skill)by anbeime | 93 | 7.2k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install obsidian-bases?
- Run
npx skills add anbeime/skill --skill obsidian-bases. The install tabs above show the steps for each supported agent. - Which AI agents does obsidian-bases work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is obsidian-bases safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is obsidian-bases still maintained?
- The repository was last updated about 2 months ago, so obsidian-bases is actively maintained.
Skill content
View source on GitHubname: obsidian-bases description: 内容创作者与技术写作员在管理海量笔记时,当需要构建 Obsidian 数据库视图、配置过滤器或编写 YAML 公式,使用此技能可自动生成标准 .base 文件,轻松实现笔记的表格/卡片多维展示与数据汇总,让知识库管理效率翻倍。
Obsidian Bases Skill
This skill enables skills-compatible agents to create and edit valid Obsidian Bases (.base files) including views, filters, formulas, and all related configurations.
Overview
Obsidian Bases are YAML-based files that define dynamic views of notes in an Obsidian vault. A Base file can contain multiple views, global filters, formulas, property configurations, and custom summaries.
File Format
Base files use the .base extension and contain valid YAML. They can also be embedded in Markdown code blocks.
Complete Schema
# Global filters apply to ALL views in the base
filters:
# Can be a single filter string
# OR a recursive filter object with and/or/not
and: []
or: []
not: []
# Define formula properties that can be used across all views
formulas:
formula_name: 'expression'
# Configure display names and settings for properties
properties:
property_name:
displayName: "Display Name"
formula.formula_name:
displayName: "Formula Display Name"
file.ext:
displayName: "Extension"
# Define custom summary formulas
summaries:
custom_summary_name: 'values.mean().round(3)'
# Define one or more views
views:
- type: table | cards | list | map
name: "View Name"
limit: 10 # Optional: limit results
groupBy: # Optional: group results
property: property_name
direction: ASC | DESC
filters: # View-specific filters
and: []
order: # Properties to display in order
- file.name
- property_name
- formula.formula_name
summaries: # Map properties to summary formulas
property_name: Average
Filter Syntax
Filters narrow down results. They can be applied globally or per-view.
Filter Structure
# Single filter
filters: 'status == "done"'
# AND - all conditions must be true
filters:
and:
- 'status == "done"'
- 'priority > 3'
# OR - any condition can be true
filters:
or:
- 'file.hasTag("book")'
- 'file.hasTag("article")'
# NOT - exclude matching items
filters:
not:
- 'file.hasTag("archived")'
# Nested filters
filters:
or:
- file.hasTag("tag")
- and:
- file.hasTag("book")
- file.hasLink("Textbook")
- not:
- file.hasTag("book")
- file.inFolder("Required Reading")
Filter Operators
| Operator | Description |
|----------|-------------|
| == | equals |
| != | not equal |
| > | greater than |
| < | less than |
| >= | greater than or equal |
| <= | less than or equal |
| && | logical and |
| \|\| | logical or |
| <code>!</code> | logical not |
Properties
Three Types of Properties
- Note properties - From frontmatter:
note.authoror justauthor - File properties - File metadata:
file.name,file.mtime, etc. - Formula properties - Computed values:
formula.my_formula
File Properties Reference
| Property | Type | Description |
|----------|------|-------------|
| file.name | String | File name |
| file.basename | String | File name without extension |
| file.path | String | Full path to file |
| file.folder | String | Parent folder path |
| file.ext | String | File extension |
| file.size | Number | File size in bytes |
| file.ctime | Date | Created time |
| file.mtime | Date | Modified time |
| file.tags | List | All tags in file |
| file.links | List | Internal links in file |
| file.backlinks | List | Files linking to this file |
| file.embeds | List | Embeds in the note |
| file.properties | Object | All frontmatter properties |
The this Keyword
- In main content area: refers to the base file itself
- When embedded: refers to the embedding file
- In sidebar: refers to the active file in main content
Formula Syntax
Formulas compute values from properties. Defined in the formulas section.
formulas:
# Simple arithmetic
total: "price * quantity"
# Conditional logic
status_icon: 'if(done, "✅", "⏳")'
# String formatting
formatted_price: 'if(price, price.toFixed(2) + " dollars")'
# Date formatting
created: 'file.ctime.format("YYYY-MM-DD")'
# Calculate days since created (use .days for Duration)
days_old: '(now() - file.ctime).days'
# Calculate days until due date
days_until_due: 'if(due_date, (date(due_date) - today()).days, "")'
Functions Reference
Global Functions
| Function | Signature | Description |
|----------|-----------|-------------|
| date() | date(string): date | Parse string to date. Format: YYYY-MM-DD HH:mm:ss |
| duration() | duration(string): duration | Parse duration string |
| now() | now(): date | Current date and time |
| today() | today(): date | Current date (time = 00:00:00) |
| if() | if(condition, trueResult, falseResult?) | Conditional |
| min() | min(n1, n2, ...): number | Smallest number |
| max() | max(n1, n2, ...): number | Largest number |
| number() | number(any): number | Convert to number |
| link() | link(path, display?): Link | Create a link |
| list() | list(element): List | Wrap in list if not already |
| file() | file(path): file | Get file object |
| image() | image(path): image | Create image for rendering |
| icon() | icon(name): icon | Lucide icon by name |
| html() | html(string): html | Render as HTML |
| escapeHTML() | escapeHTML(string): string | Escape HTML characters |
Any Type Functions
| Function | Signature | Description |
|----------|-----------|-------------|
| isTruthy() | any.isTruthy(): boolean | Coerce to boolean |
| isType() | any.isType(type): boolean | Check type |
| toString() | any.toString(): string | Convert to string |
Date Functions & Fields
Fields: date.year, date.month, date.day, date.hour, date.minute, date.second, date.millisecond
| Function | Signature | Description |
|----------|-----------|-------------|
| date() | date.date(): date | Remove time portion |
| format() | date.format(string): string | Format with Moment.js pattern |
| time() | date.time(): string | Get time as string |
| relative() | date.relative(): string | Human-readable relative time |
| isEmpty() | date.isEmpty(): boolean | Always false for dates |
Duration Type
When subtracting two dates, the result is a Duration type (not a number). Duration has its own properties and methods.
Duration Fields:
| Field | Type | Description |
|-------|------|-------------|
| duration.days | Number | Total days in duration |
| duration.hours | Number | Total hours in duration |
| duration.minutes | Number | Total minutes in duration |
| duration.seconds | Number | Total seconds in duration |
| duration.milliseconds | Number | Total milliseconds in duration |
IMPORTANT: Duration does NOT support .round(), .floor(), .ceil() directly. You must access a numeric field first (like .days), then apply number functions.
# CORRECT: Calculate days between dates
"(date(due_date) - today()).days" # Returns number of days
"(now() - file.ctime).days" # Days since created
# CORRECT: Round the numeric result if needed
"(date(due_date) - today()).days.round(0)" # Rounded days
"(now() - file.ctime).hours.round(0)" # Rounded hours
# WRONG - will cause error:
# "((date(due) - today()) / 86400000).round(0)" # Duration doesn't support division then round
Date Arithmetic
# Duration units: y/year/years, M/month/months, d/day/days,
# w/week/weeks, h/hour/hours, m/minute/minutes, s/second/seconds
# Add/subtract durations
"date + \"1M\"" # Add 1 month
"date - \"2h\"" # Subtract 2 hours
"now() + \"1 day\"" # Tomorrow
"today() + \"7d\"" # A week from today
# Subtract dates returns Duration type
"now() - file.ctime" # Returns Duration
"(now() - file.ctime).days" # Get days as number
"(now() - file.ctime).hours" # Get hours as number
# Complex duration arithmetic
"now() + (duration('1d') * 2)"
String Functions
Field: string.length
| Function | Signature | Description |
|----------|-----------|-------------|
| contains() | string.contains(value): boolean | Check substring |
| containsAll() | string.containsAll(...values): boolean | All substrings present |
| containsAny() | string.containsAny(...values): boolean | Any substring present |
| startsWith() | string.startsWith(query): boolean | Starts with query |
| endsWith() | string.endsWith(query): boolean | Ends with query |
| isEmpty() | string.isEmpty(): boolean | Empty or not present |
| lower() | string.lower(): string | To lowercase |
| title() | string.title(): string | To Title Case |
| trim() | string.trim(): string | Remove whitespace |
| replace() | string.replace(pattern, replacement): string | Replace pattern |
| repeat() | string.repeat(count): string | Repeat string |
| reverse() | string.reverse(): string | Reverse string |
| slice() | string.slice(start, end?): string | Substring |
| split() | string.split(separator, n?): list | Split to list |
Number Functions
| Function | Signature | Description |
|----------|-----------|-------------|
| abs() | number.abs(): number | Absolute value |
| ceil() | number.ceil(): number | Round up |
| floor() | number.floor(): number | Round down |
| round() | number.round(digits?): number | Round to digits |
| toFixed() | number.toFixed(precision): string | Fixed-point notation |
| isEmpty() | number.isEmpty(): boolean | Not present |
List Functions
Field: list.length
| Function | Signature | Description |
|----------|-----------|-------------|
| contains() | list.contains(value): boolean | Element exists |
| containsAll() | list.containsAll(...values): boolean | All elements exist |
| containsAny() | list.containsAny(...values): boolean | Any element exists |
| filter() | list.filter(expression): list | Filter by condition (uses value, index) |
| map() | list.map(expression): list | Transform elements (uses value, index) |
| reduce() | list.reduce(expression, initial): any | Reduce to single value (uses value, index, acc) |
| flat() | list.flat(): list | Flatten nested lists |
| join() | list.join(separator): string | Join to string |
| reverse() | list.reverse(): list | Reverse order |
| slice() | list.slice(start, end?): list | Sublist |
| sort() | list.sort(): list | Sort ascending |
| unique() | list.unique(): list | Remove duplicates |
| isEmpty() | list.isEmpty(): boolean | No elements |
File Functions
| Function | Signature | Description |
|----------|-----------|-------------|
| asLink() | file.asLink(display?): Link | Convert to link |
| hasLink() | file.hasLink(otherFile): boolean | Has link to file |
| hasTag() | file.hasTag(...tags): boolean | Has any of the tags |
| hasProperty() | file.hasProperty(name): boolean | Has property |
| inFolder() | file.inFolder(folder): boolean | In folder or subfolder |
Link Functions
| Function | Signature | Description |
|----------|-----------|-------------|
| asFile() | link.asFile(): file | Get file object |
| linksTo() | link.linksTo(file): boolean | Links to file |
Object Functions
| Function | Signature | Description |
|----------|-----------|-------------|
| isEmpty() | object.isEmpty(): boolean | No properties |
| keys() | object.keys(): list | List of keys |
| values() | object.values(): list | List of values |
Regular Expression Functi
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
