技能包

用 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 操作和用戶端獨占結論,不要補全。第一次成功只看安裝結束和代理能複述語法,真正寫盤前必須先確認目標筆記可以丟棄。證據沒有寫到卸載、更新或如何從代理裡關閉這組技能,不要自行補步驟。若代理開始改正式庫裡的多篇筆記,先停下來,回到可丟棄的單檔。摘錄沒有寫到的其他格式或命令列操作,不要寫成已經可執行的步驟。