obsidian-skills

Obsidian 技能

用于创建和编辑兼容 Obsidian 的纯文本文件的 Agent 技能，遵循 Agent Skills 规范。

何时使用此技能

• 创建格式规范的 Obsidian 笔记
• 使用 Wikilink 构建知识库
• 创建用于可视化整理的画布文件
• 使用 Obsidian Bases（数据库）
• 管理 PKM（个人知识管理）系统
• 以 Zettelkasten 风格记笔记

支持的文件类型

1. Obsidian Flavored Markdown (.md)

带有 Obsidian 扩展的标准 Markdown：

# Note Title

Regular markdown content with [[wikilinks]] to other notes.

## Features

- [[Internal Links]]
- [[Links with Alias|Custom Text]]
- ![[Embedded Notes]]
- ![[image.png]]
- #tags and #nested/tags
- ^block-references
- %%comments%%

## Frontmatter

---
title: Note Title
date: 2025-01-12
tags: [tag1, tag2]
aliases: [alias1, alias2]
---

2. Obsidian Bases (.base)

用于笔记的类数据库视图：

{
  "type": "base",
  "version": 1,
  "name": "Projects Database",
  "source": "folder:Projects",
  "columns": [
    {"name": "Name", "type": "text", "property": "file.name"},
    {"name": "Status", "type": "select", "property": "status"},
    {"name": "Due Date", "type": "date", "property": "due"},
    {"name": "Priority", "type": "number", "property": "priority"}
  ],
  "filters": [
    {"property": "status", "operator": "!=", "value": "done"}
  ],
  "sorts": [
    {"property": "due", "direction": "asc"}
  ]
}

3. JSON Canvas (.canvas)

用于空间组织的可视化画布：

{
  "nodes": [
    {
      "id": "1",
      "type": "text",
      "text": "Main Idea",
      "x": 0,
      "y": 0,
      "width": 200,
      "height": 100
    },
    {
      "id": "2",
      "type": "file",
      "file": "Notes/Related Note.md",
      "x": 300,
      "y": 0,
      "width": 200,
      "height": 100
    }
  ],
  "edges": [
    {
      "id": "e1",
      "fromNode": "1",
      "toNode": "2",
      "label": "relates to"
    }
  ]
}

常见任务

创建新笔记

Create an Obsidian note about [topic]
Include: frontmatter, sections, relevant links

构建 MOC（内容地图）

Create a Map of Content for [topic]
Link to: existing notes in vault
Structure: hierarchical with categories

创建每日笔记

Create daily note for today
Include: tasks, meetings, notes sections
Template: my-daily-template

设计画布

Create a canvas for [project/concept]
Nodes: key ideas, files, images
Connections: relationships between nodes

创建数据库视图

Create a Base for tracking [items]
Columns: [properties to track]
Filters: [criteria]
Sort: [ordering]

Obsidian 语法参考

链接

语法	描述
[[Note]]	内部链接
[[Note|Alias]]	带别名的链接
[[Note#Heading]]	链接到标题
[[Note#^block]]	链接到块
![[Note]]	嵌入笔记
![[image.png]]	嵌入图片

标签

语法	描述
#tag	简单标签
#parent/child	嵌套标签
tags: [a, b]	Frontmatter 标签

标注

> [!note] Title
> Content

> [!warning] Important
> Warning content

> [!tip] Pro tip
> Helpful information

任务

- [ ] Incomplete task
- [x] Completed task
- [ ] Task with [[link]]
- [ ] Task #tag
- [ ] Task 📅 2025-01-12

Dataview 查询

```dataview
TABLE status, due
FROM "Projects"
WHERE status != "done"
SORT due ASC

## Templates

### Note Template

```markdown
---
created: {{date}}
tags: []
---

# {{title}}

## Overview


## Details


## Related
-

会议笔记

---
date: {{date}}
attendees: []
type: meeting
---

# Meeting: {{title}}

## Attendees
-

## Agenda
1.

## Notes


## Action Items
- [ ]

与 PKM 系统集成

Zettelkasten

# 202501121030 Atomic Note Title

Brief atomic concept.

## Links
- [[202501121025 Related Concept]]
- [[202501121035 Another Idea]]

## References
- Source material

PARA 方法

/vault
├── 1 Projects/
├── 2 Areas/
├── 3 Resources/
└── 4 Archive/

最佳实践

1. 原子笔记：每条笔记只包含一个想法
2. 描述性标题：清晰且便于搜索的名称
3. 广泛链接：关联相关概念
4. 一致的 Frontmatter：使用模板
5. 定期回顾：维护关联

致谢

由 kepano（Obsidian 首席执行官 Steph Ango）创建。采用 MIT 许可证。