mcpField
O
obsidian-master-skill

obsidian-master-skill

github.com/julianobarbosa生産性1462 回インストール2 日前に更新
リポジトリ

obsidian-master-skill について

obsidian-master-skillは、ノート作成、検索、Vaultの健全性確認、知識の記録をまとめたObsidian向けスキルです。タスク別のワークフローに振り分け、Obsidian稼働時はREST APIを使い、停止時はファイルを直接操作します。

主な機能

  1. 01ノートとデイリーノートの作成
  2. 02本文、タグ、DQLによる検索
  3. 03孤立ノートとリンク切れの確認
  4. 04会話から知識を記録・整理
  5. 05.baseビューの作成と検証
  6. 06REST APIまたはファイルの直接操作

活用シーン

  1. 01プロジェクトノートや日次記録の作成
  2. 02Vault内のテーマ別ノート検索
  3. 03受信箱の整理とリンク問題の確認
  4. 04議論の内容を決定記録として保存

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/julianobarbosa/claude-code-skills --skill obsidian-master-skill

インストール後、Claude Code で/obsidian-master-skillを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

reference/
bases.md
integration-patterns.md
knowledge-capture.md
markdown.md
rest-api.md
vault-organization.md
Tools/
BaseBuilder.py
NoteCreator.py
SearchVault.py
VaultManager.py
Workflows/
CaptureKnowledge.md
CreateBase.md
CreateNote.md
DailyNote.md
ManageVault.md
ProcessInbox.md
SearchVault.md
SyncDocs.md

詳細

obsidian-master-skill

Obsidian の Vault 操作をすべて網羅する統合スキルです。ノートの作成、検索、Vault の健全性チェック、知識の取り込み、Base、デイリーノートに対応します。段階的に情報を開示する構成で、基本ルールを以下に、詳細なリファレンスを reference/ にまとめています。

ディレクトリ構成

obsidian-master-skill/
├── SKILL.md                          # This file (overview + quick reference)
├── reference/                        # Detailed documentation
│   ├── markdown.md                   # Obsidian Flavored Markdown syntax
│   ├── vault-organization.md         # PARA folders, frontmatter, Dataview
│   ├── rest-api.md                   # Local REST API, URI scheme, plugin API
│   ├── bases.md                      # .base YAML schema, filters, formulas
│   ├── integration-patterns.md       # Claude Code integration patterns
│   └── knowledge-capture.md          # ADR, concept, how-to, meeting templates
├── Workflows/                        # Step-by-step workflow definitions
│   ├── CreateNote.md                 # Create notes with templates + PARA placement
│   ├── SearchVault.md                # DQL, content search, tag filtering
│   ├── ManageVault.md                # Health checks, orphans, broken links
│   ├── CaptureKnowledge.md           # Extract insights from conversations
│   ├── CreateBase.md                 # Build .base database views
│   ├── DailyNote.md                  # Daily note creation/enhancement
│   ├── ProcessInbox.md               # Triage inbox into PARA folders
│   └── SyncDocs.md                   # Sync external project docs to vault
└── Tools/                            # Python CLI tools (click + httpx)
    ├── SearchVault.py                # status, auth, search (dataview|content|jsonlogic)
    ├── VaultManager.py               # health, orphans, broken-links, lifecycle, move, inbox
    ├── NoteCreator.py                # create, daily, capture
    └── BaseBuilder.py                # create, validate, preview

ワークフローの振り分け

意図ワークフローツール
ノートを作成する（種類を問わず）Workflows/CreateNote.mdTools/NoteCreator.py
Vault を検索する（DQL、コンテンツ、タグ）Workflows/SearchVault.mdTools/SearchVault.py
Vault の健全性、孤立ノート、リンク切れを確認するWorkflows/ManageVault.mdTools/VaultManager.py
会話から知識を抽出するWorkflows/CaptureKnowledge.mdTools/NoteCreator.py
.base データベースビューを作成・編集するWorkflows/CreateBase.mdTools/BaseBuilder.py
デイリーノートを作成・拡充するWorkflows/DailyNote.mdTools/NoteCreator.py
Inbox のノートを PARA に振り分けるWorkflows/ProcessInbox.mdTools/VaultManager.py
プロジェクトのドキュメントを Vault に同期するWorkflows/SyncDocs.mdTools/VaultManager.py

クイックリファレンス

PARA フォルダーマップ
フォルダー用途ノートの種類
00 - Inbox/すばやく取り込み、未整理思いつき
00 - Maps of Content/インデックスノートMOC、ダッシュボード
01 - Projects/進行中のプロジェクトプロジェクト文書
02 - Areas/継続的な責任領域領域の概要
03 - Resources/参考資料エバーグリーンノート
04 - Archive/完了済み／非アクティブアーカイブ済みプロジェクト
04 - Permanent/ツェッテルカステンノートアトミックなアイデア
06 - Daily/日次ジャーナル（YYYY/MM/YYYYMMDD.md）ジャーナルエントリー
08 - books/書籍ノート読書ノート
10 - 1-1/会議ノート1 対 1 のミーティング

詳細：reference/vault-organization.md

フロントマターのスキーマ

標準ノート：

---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
tags:
  - category/subcategory
---

デイリーノート（v2.0）：

---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
title: YYYYMMDD
type: daily-note
status: true
tags:
  - daily
  - y/YYYY
  - y/YYYY-MM
aliases:
  - YYYY-MM-DD
date_formatted: YYYY-MM-DD
cssclasses:
  - daily
---

プロジェクトノート：

---
created: YYYY-MM-DDTHH:mm
updated: YYYY-MM-DDTHH:mm
type: project
status: active | paused | complete
priority: high | medium | low
tags:
  - project/name
---

詳細：reference/vault-organization.md

リンクの規約
[[Note Name]]                    # Wikilink
[[Note Name|Display Text]]       # Aliased link
[[Note Name#Heading]]            # Heading link
[[Note Name#^block-id]]          # Block reference
![[Note Name]]                   # Embed note
![[image.png]]                   # Embed image
![[image.png|300]]               # Embed with width

詳細：reference/markdown.md

Dataview の一般的なクエリ
LIST FROM "06 - Daily" WHERE file.cday = date(today) SORT file.ctime DESC

TABLE status, tags FROM "01 - Projects" WHERE status != "completed"

TABLE WITHOUT ID file.link AS "Note", file.mtime AS "Modified"
FROM "03 - Resources" SORT file.mtime DESC LIMIT 20

LIST FROM "" WHERE length(file.inlinks) = 0 AND length(file.outlinks) = 0

詳細：reference/vault-organization.md

知識の取り込みを示すシグナル
会話中のシグナル取り込みの種類保存先
「〜と決めました」ADR03 - Resources/decisions/
「X とは何ですか？」／「X は〜の仕組みです」概念04 - Permanent/
「〜するには？」／「手順は〜」ハウツー03 - Resources/howtos/
「会議で〜」会議ノート10 - 1-1/
「〜に関するノートをすべて追跡する」MOC00 - Maps of Content/
ちょっとした気づきや ToDoデイリーへの追記06 - Daily/YYYY/MM/YYYYMMDD.md

詳細：reference/knowledge-capture.md

コールアウトの種類
> [!note] Title
> Content

> [!tip]+ Expandable (default open)
> [!info]- Collapsed (default closed)

種類：note、abstract/summary/tldr、info、todo、tip/hint/important、success/check/done、question/help/faq、warning/caution/attention、failure/fail/missing、danger/error、bug、example、quote/cite

詳細：reference/markdown.md

REST API クイックスタート
# Requires Local REST API plugin enabled in Obsidian
export OBSIDIAN_API_KEY="your-key"
export OBSIDIAN_BASE_URL="https://127.0.0.1:27124"

curl -H "Authorization: Bearer $OBSIDIAN_API_KEY" $OBSIDIAN_BASE_URL/vault/
エンドポイントメソッド用途
/vault/{path}GET/PUT/DELETE/PATCHファイルの CRUD
/search/simple/POSTテキスト検索
/search/POSTDataview クエリ
/search/jsonlogic/POST複雑なフィルタリング
/active/GET/PUTアクティブファイル
/commands/{id}POSTコマンドを実行

詳細：reference/rest-api.md

Base ファイルのクイックスタート
# example.base — table of active projects
filters:
  and:
    - file.inFolder("01 - Projects")
    - 'status == "active"'
views:
  - type: table
    name: "Active Projects"
    order: [file.name, status, priority, due_date]

埋め込み：![[example.base]] または ![[example.base#View Name]]

詳細：reference/bases.md

ツール（Python）

すべてのツールは、CLI に click、REST API に httpx、フロントマターに pyyaml、直接ファイルアクセスに pathlib を使用します。デュアルモードに対応しており、Obsidian の実行中は REST API を使用し、それ以外の場合は直接ファイルアクセスにフォールバックします。

ツールコマンド
Tools/SearchVault.pystatus、auth、search --type dataview|content|jsonlogic
Tools/VaultManager.pyhealth、orphans、broken-links、lifecycle、move、inbox
Tools/NoteCreator.pycreate、daily、capture
Tools/BaseBuilder.pycreate、validate、preview

例

"Create a new project note for API redesign"     -> Workflows/CreateNote.md
"Search my vault for notes about Kubernetes"      -> Workflows/SearchVault.md
"Find orphan notes and suggest connections"       -> Workflows/ManageVault.md
"Save what we just discussed as an ADR"           -> Workflows/CaptureKnowledge.md
"Create a base view of all active projects"       -> Workflows/CreateBase.md
"Create today's daily note"                       -> Workflows/DailyNote.md
"Process my inbox"                                -> Workflows/ProcessInbox.md
"What's the Obsidian markdown syntax for X?"      -> reference/markdown.md
"How do I use the REST API?"                      -> reference/rest-api.md
"How do bases formulas work?"                     -> reference/bases.md

Neovim リファレンス

obsidian.nvim の設定については、reference/integration-patterns.md の Neovim 統合のセクションを参照してください。

コメント

Markdown 対応