logseq-plugin-dev
Logseqプラグインの新規作成、APIを使った機能実装、デバッグ、開発環境構築など、開発全般を支援するSkill。
📜 元の英語説明(参考)
Comprehensive guide and resources for developing Logseq plugins. Use this skill when asked to: (1) Create a new Logseq plugin, (2) Implement features using the Logseq Plugin API (Editor, App, DB, UI), (3) Debug or refactor existing Logseq plugins, (4) Set up a development environment for Logseq plugins.
🇯🇵 日本人クリエイター向け解説
Logseqプラグインの新規作成、APIを使った機能実装、デバッグ、開発環境構築など、開発全般を支援するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-17
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Logseq プラグイン開発
このスキルは、@logseq/libs SDK を使用して Logseq 用の高品質なプラグインを構築するのに役立ちます。
コアコンセプト
Logseq プラグインはサンドボックス化された iframe 内で実行され、RPC ブリッジを介してメインの Logseq アプリケーションと通信します。
- マニフェスト: すべてのプラグインには
logseqフィールドを持つpackage.jsonが必要です。 - SDK: Logseq と対話するには
@logseq/libsを使用します。 - ライフサイクル: プラグインを初期化するには
logseq.ready(main)を使用します。
はじめに
- 足場を固める:
- 基本的な TS:
assets/template/ - React + Vite:
assets/template-react/
- 基本的な TS:
- 依存関係をインストールする:
npm install @logseq/libs。 - ビルドする: Vite または同様のバンドラーを使用して JS/TS コードをパッケージ化します。
- ロードする: Logseq で
Settings -> Plugins -> Developer Modeに移動し、Load unpacked pluginを選択してプラグインディレクトリを選択します。
一般的なワークフロー
1. コマンドの登録
logseq.Editor.registerSlashCommand または logseq.App.registerCommandPalette を使用します。
2. コンテンツとの対話
- 読み取り:
logseq.Editor.getCurrentPageBlocksTree() - 書き込み:
logseq.Editor.insertBlock(parentBlockId, content) - クエリ:
logseq.DB.datascriptQuery(query)
3. UI とテーマ設定
- UI: HTML を挿入するには
logseq.provideUIを使用するか、全画面アプリを表示するにはlogseq.showMainUIを使用します。 - テーマ設定: 一貫性のために Logseq CSS 変数(例:
--ls-primary-background-color)を使用します。
リソース
- API リファレンス: 利用可能なメソッドと例の詳細なリストについては、references/api.md を参照してください。
- ボイラープレート:
- assets/template/ (Vanilla TS)
- assets/template-react/ (React + Vite)
- 例: マインドマップやスラッシュコマンドなどの一般的なパターンについては、references/examples.md を参照してください。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Logseq Plugin Development
This skill helps you build high-quality plugins for Logseq using the @logseq/libs SDK.
Core Concepts
Logseq plugins run in a sandboxed iframe and communicate with the main Logseq application via an RPC bridge.
- Manifest: Every plugin needs a
package.jsonwith alogseqfield. - SDK: Use
@logseq/libsto interact with Logseq. - Lifecycle: Use
logseq.ready(main)to initialize your plugin.
Getting Started
- Scaffold:
- Basic TS:
assets/template/ - React + Vite:
assets/template-react/
- Basic TS:
- Install Dependencies:
npm install @logseq/libs. - Build: Use Vite or a similar bundler to package your JS/TS code.
- Load: In Logseq, go to
Settings -> Plugins -> Developer Mode, thenLoad unpacked pluginand select your plugin directory.
Common Workflows
1. Registering Commands
Use logseq.Editor.registerSlashCommand or logseq.App.registerCommandPalette.
2. Interacting with Content
- Read:
logseq.Editor.getCurrentPageBlocksTree() - Write:
logseq.Editor.insertBlock(parentBlockId, content) - Query:
logseq.DB.datascriptQuery(query)
3. UI and Theming
- UI: Use
logseq.provideUIto inject HTML orlogseq.showMainUIto show a full-screen app. - Theming: Use Logseq CSS variables (e.g.,
--ls-primary-background-color) for consistency.
Resources
- API Reference: See references/api.md for a detailed list of available methods and examples.
- Boilerplates:
- assets/template/ (Vanilla TS)
- assets/template-react/ (React + Vite)
- Examples: See references/examples.md for common patterns like mind maps and slash commands.