obsidian

obsidian — プラグイン開発＋デスクトップ自動化

置き換え対象：obsidian-plugin · obsidian-cli プラグインのインストール：claude plugin marketplace add akillness/jeo-skills スキルのインストール：npx skills add https://github.com/akillness/jeo-skills --skill obsidian

このスキルを使う場面

プラグイン開発の手順：

• 無駄のないボイラープレートで Obsidian プラグインを新規作成する
• eslint-plugin-obsidianmd の ESLint 違反（27 ルール）を修正する
• コミュニティディレクトリへの登録申請に向けてプラグインを準備する
• メモリ安全なライフサイクル、型安全性、アクセシビリティ、CSS 変数を適用する

CLI 自動化の手順：

• 公式 CLI（obsidian コマンド）を使ってデスクトップ版 Obsidian を操作する
• Vault／ノートの指定、デイリーノート、検索、作成、読み取り、タスクを実行する
• ランチャー／ブラウザー／スクリプトからアプリに引き継ぐために obsidian:// URI を使う
• プラグイン／テーマの開発サイクル（再読み込み、スクリーンショット、eval、開発者ツール）

Markdown とコンテンツのパターン（kepano/obsidian-skills）：

• Wikilink、埋め込み、コールアウト、フロントマター、Obsidian Bases クエリ、JSON Canvas

このスキルを使わない場面

• デスクトップを使わない Headless Sync／Publish → Obsidian Headless
• ファイルシステム上の Markdown を直接編集する場合 → ファイルシステムへの直接書き込み
• シェルネイティブなノートバックエンド → nb、zk、または Joplin Terminal
• より高機能な外部 CRUD／フロントマター操作 → Local REST API または Advanced URI プラグイン

手順

ルーティング：最初に手順を選択する

obsidian_intent:
  path: plugin-dev | cli-automation | markdown-patterns
  surface: boilerplate | eslint-fix | submission | cli-command | uri-handoff | developer-mode | content-patterns

プラグイン開発クイックスタート

# Generate boilerplate
npx github:gapmiss/obsidian-plugin-skill create-plugin

# Install ESLint validation
npm install --save-dev eslint eslint-plugin-obsidianmd
npx eslint src/         # validate all 27 rules
npx eslint src/ --fix   # auto-fix where possible

主なルール：prefer-register-event（メモリ）、no-tfile-cast（型安全性）、 require-aria-label（アクセシビリティ）、prefer-css-variables（スタイル設定）。 27 個のルールとコードパターンについては、references/plugin-dev.md を参照してください。

CLI 自動化クイックスタート

obsidian help && obsidian version   # verify CLI is enabled
obsidian vault="My Vault" search query="meeting notes"
obsidian vault="My Vault" read path="Projects/Roadmap.md"
obsidian daily:append content="- [ ] Follow up"
obsidian plugin:reload id=my-plugin   # developer mode

URI による引き継ぎ：

obsidian://open?vault=my%20vault&file=my%20note
obsidian://new?vault=my%20vault&name=new-note

コマンドの全リファレンスについては、references/cli-automation.md を参照してください。

Markdown とコンテンツのパターン（kepano）

• Wikilink：[[Note Name]]、[[Note|Alias]]、[[Note#Heading]]
• 埋め込み：![[Note]]、![[image.png|300]]
• コールアウト：> [!NOTE]、> [!WARNING]、> [!TIP]
• Bases：from、filter、sort、group を使った \``base` クエリ
• JSON Canvas：ビジュアルナレッジグラフ用のノード＋エッジ構造

構文の全容については、references/content-patterns.md を参照してください。

プラグインのインストールと配布

# Install this skill as a Claude Code plugin
claude plugin marketplace add akillness/jeo-skills

# Or install just the obsidian skill via skills CLI
npx skills add https://github.com/akillness/jeo-skills --skill obsidian

例

# Example 1: verify CLI availability, then search and append to daily note
obsidian version
obsidian vault="Work" search query="incident postmortem"
obsidian daily:append content="- [ ] Share postmortem summary"

# Example 2: plugin-dev lint/fix loop before submission
npm install --save-dev eslint eslint-plugin-obsidianmd
npx eslint src/
npx eslint src/ --fix

リファレンス

• references/plugin-dev.md — ESLint の全 27 ルール、コードパターン、申請
• references/cli-automation.md — CLI コマンド、URI、開発者モード
• references/content-patterns.md — Markdown、Bases、JSON Canvas
• eslint-plugin-obsidianmd
• Obsidian Plugin Docs
• Obsidian CLI
• kepano/obsidian-skills

ベストプラクティス

• 出力は決定論的で、監査可能な状態に保ちます。
• 広範囲に及ぶリスクの高い編集より、小規模で元に戻せる変更を優先します。
• 前提条件を明確に記録します。