概要
Agent Skills 仕様に準拠したスキルセットを提供し、Claude Code、Codex、OpenCode などの互換エージェントが Obsidian Markdown、Bases、JSON Canvas ファイルを作成・編集し、Obsidian CLI と連携できるようにします。Web ページからクリーンな Markdown を抽出するための Defuddle を含みます。
README プレビュー
Agent Skills for use with Obsidian.\n\nThese skills follow the [Agent Skills specification](https://agentskills.io/specification) so they can be used by any skills-compatible agent, including Claude Code, Codex, and Open Code.\n\n## Installation\n\n### Marketplace\n\n```\n/plugin marketplace add kepano/obsidian-skills\n/plugin install obsidian@obsidian-skills\n```\n\n### npx skills\n\n```\nnpx skills add git@github.com:kepano/obsidian-skills.git\n```\n\nInstead of ssh, if you prefer to use https:\n\n```\nnpx skills add https://github.com/kepano/obsidian-skills\n```\n\n### Manually\n\n#### Claude Code\n\nAdd the contents of this repo to a `/.claude` folder in the root of your Obsidian vault (or whichever folder you're using with Claude Code). See more in the [official Claude Skills documentation](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview).\n\n#### Codex\n\nCopy the `skills/` directory into your Codex skills path (typically `~/.codex/skills`). See the [Agent Skills specification](https://agentskills.io/specification) for the standard skill format.\n\n#### OpenCode\n\nClone the entire repo into the OpenCode skills directory (`~/.opencode/skills/`):\n\n```sh\ngit clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills\n```\n\nDo not copy only the inner `skills/` folder — clone the full repo so the directory structure is `~/.opencode/skills/obsidian-skills/skills//SKILL.md`.\n\nOpenCode auto-discovers all `SKILL.md` files under `~/.opencode/skills/`. No changes to `opencode.json` or any config file are needed. Skills become available after restarting OpenCode.\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| [obsidian-markdown](skills/obsidian-markdown) | Create and edit [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown) (`.md`) with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax |\n| [obsidian-bases](skills/obsidian-bases) | Crea
FAQ (3)
トラブル対応Obsidian Bases のエラー「"filters" may only have one of an "and", "or", or "not" keys」を修正するにはどうすればよいですか?
filters の下ではトップレベルの演算子を1つだけ使用してください。包含と除外のロジックを組み合わせるには、and、or、not を兄弟として並べるのではなく、もう一方の演算子をネストしてください。
無効な YAML:
filters:
and: []
or: []
not: []有効な YAML:
filters:
and:
- '包含条件'
- not:
- '除外条件'たとえば、必須のタグ条件とテンプレート除外の条件を、1つのトップレベルの and の下に配置してください。obsidian-bases/SKILL.md にあった誤ったスキーマ例は、PR #68 で修正されました。
トラブル対応なぜ `obsidian help` を `head` にパイプすると、ハングしたり、2つ目の Obsidian Electron インスタンスが起動したりするのですか？
obsidian help は静的なヘルプを表示するだけでなく、Electron プロセスをブートストラップします。その出力が | head のようにパイプされて途中で閉じられると、Electron ヘルパープロセスがクリーンなシャットダウンシグナルを受け取れず、親シェルがブロックされたままになることがあります。このコマンドをパイプに渡すのは避けてください。ターミナルで直接 obsidian help を実行するか、obsidian help > obsidian-help.txt のようにファイルにリダイレクトしてください。実行時間を制限する必要がある場合は、timeout 5 obsidian help > obsidian-help.txt を使用してください。恒久的な回避策としては、obsidian help を実行する代わりに、静的ヘルプテキストのローカルなチートシートを手元に保持しておいてください。これは Obsidian Skill の問題ではなく、CLI の動作に関する問題です。Obsidian の CLI トラブルシューティングドキュメントを参照してください。
トラブル対応AIエージェントスキルがObsidian CLIを使用する際に 'obsidian: command not found' エラーを修正するにはどうすればよいですか？
別途 obsidian-cli パッケージをインストールする代わりに、Obsidian 組み込みの CLI を有効にしてください：
1. Obsidian デスクトップアプリを開きます。
2. **Settings → General → Command line interface** に進みます。
3. **Enable CLI** をオンにします。
4. ターミナルを再起動します（またはシェル環境を再読み込みします）。
5. which obsidian または obsidian --version で確認します。
有効化後、Obsidian はスキルが必要とする obsidian コマンドを作成します。セットアップ中にターミナルを開いていた場合は、新しいコマンドが検出されるようにターミナルを再起動してください。