スキル

Obsidian スキルで双方向リンク付きのノートを書く

代理に Obsidian 流の Markdown を書かせたい人向け。Agent Skills 互換の代理を使い、公式の npx skills add だけを主経路にする。

公式ソース · obsidian-skills

インストール

npx skills add https://github.com/kepano/obsidian-skills

誰向けか

Agent Skills 互換の代理に、Obsidian 流で Markdown を作成・編集させたいときに、このスキル一式を使う。Obsidian Flavored Markdown、つまり .md のノートを扱い、双方向リンク、埋め込み、コールアウト、プロパティ、その他 Obsidian 特有の構文を使うことを教える。構文説明は

https://help.obsidian.md/obsidian-flavored-markdown

公式リポジトリは

https://github.com/kepano/obsidian-skills

原文はこれらのスキルが Agent Skills 仕様に従うと書く。したがってその仕様に互換な代理なら使える。仕様に出たいくつかの製品名を本文へ使用範囲として写さない。その環境だけ入れられるとも推論しない。互換代理が無い、またはこのマシンで公式インストールコマンドを実行する準備が無いなら、先に続けない。

これはすでに Obsidian ノートの習慣があり、倉庫が正しく理解できる Markdown を代理に書かせたい人向け。普通の Markdown だけで、双方向リンクやプロパティが要らないなら、このスキルを取る必要は無い。仕様住所は

https://agentskills.io/specification

3 分で最初の試行を終える

先に、今の代理が Agent Skills を受け取れるか確認する。公式リポジトリを開いて照合する:

https://github.com/kepano/obsidian-skills

推奨インストールはこの一本だけ。スキルを入れるとこのマシンへスキルファイルを書く。実行前に、この Obsidian スキル一式を残すか確認する:

npx skills add https://github.com/kepano/obsidian-skills

コマンド内の住所は公式リポジトリと完全に一致すること。成功の合図はこのコマンドが正常に終わること。原文は汎用の着地ディレクトリを書いていない。経路を自分で足さない。原文には特定クライアント向けのプラグインやクローンの書き方もある。最初はそれを第二の主経路として並列にしない。受け方を説明していない環境へ市場コマンドを当てはめない。

代理では最初は照合だけ。本番ノート庫を先に変えない。代理に、Obsidian Flavored Markdown における双方向リンク、埋め込み、コールアウト、プロパティが何か、.md ファイルをどう作成または編集するつもりかを言わせる。観察点は、これらの構文点を復唱でき、まだどのファイルにも書いていないこと。

次に本当の作成または編集を一度試すなら、先に捨ててよいノートを指定し、今回ディスクを変えると確認する。原文に倉庫経路やファイル名の見本は無い。庫の位置を作らない。最初は複数ファイルを一括で変えず、出ていない CLI サブコマンドも作らない。

利用事例

事例一:公式 npx 経路どおりスキルが入ったか先に確認する。Agent Skills 互換の代理で、このマシンがスキルファイルを書くことを受け入れたあと、npx skills add だけを実行する。目標住所は

https://github.com/kepano/obsidian-skills

Obsidian スキルを代理へつなぐだけで、まだノートを変える準備が無い人向け。成功の合図はインストールコマンドが正常に終わり、代理が双方向リンク、埋め込み、コールアウト、プロパティ付きの Markdown を作成・編集すると言えること。原文はインストール後のディレクトリ木を書いていない。ファイル名を作らない。インストールが失敗したら止める。主経路に選んでいないプラグインやクローンコマンドに切り替えない。

事例二:捨ててよいノートで作成または編集を一度試す。原文は Obsidian Flavored Markdown の作成と編集ができると書く。構文は双方向リンク、埋め込み、コールアウト、プロパティを含む。スキルを入れ済みで、代理が Obsidian 構文で .md を書くかを見たい人向け。実行前に、目標ファイルを捨ててよく、今回の書き込みを受け入れると確認する。終わったらその .md を開き、上記構文が出るか見る。普通のプレーンテキストではないこと。原文に具体的なファイル名、庫経路、コマンドラインスイッチは無い。作らない。見出しに出て摘録に無い他の形式を、すでに実行できる手順だと思わない。

利用上の境界

主経路は npx skills add だけ。住所は必ず

https://github.com/kepano/obsidian-skills

原文はプラグイン市場と、特定クライアントディレクトリへのクローンという入れ方も書いた。それは最初の試行の主経路ではない。npx と並列にせず、説明していない環境へ広げない。スキルは Agent Skills 仕様に従い、その仕様に互換な代理にだけ向く。見よ

https://agentskills.io/specification

能力範囲は Obsidian Flavored Markdown の作成と編集、および双方向リンク、埋め込み、コールアウト、プロパティ、その他 Obsidian 特有構文。ヘルプ頁は

https://help.obsidian.md/obsidian-flavored-markdown

根拠に具体的なサブコマンド、庫経路、アンインストール手順は無い。書いていない形式名、CLI 操作、クライアント独占の結論を補わない。最初の成功はインストール終了と代理が構文を復唱できることだけ。本当にディスクへ書く前に、目標ノートを捨ててよいと確認する。根拠にアンインストール、更新、代理内でこのスキル一式を閉じる方法は無い。手順を自分で足さない。代理が本番庫の複数ノートを変え始めたら先に止め、捨ててよい単一ファイルへ戻る。摘録に無い他の形式やコマンドライン操作を、すでに実行できる手順と書かない。