agent-deep-links について
アプリ内の特定項目を開くクリック可能なリンクを作成するスキルです。主に Slack での利用を想定し、対応するディープリンク形式を確認し、未対応または不明な場合は代替手段を示します。
主な機能
- 01対象のアプリと項目を特定
- 02ディープリンク対応表を参照
- 03不明なスキームをローカルで検証
- 04Slack 向けリンク形式を作成
- 05パスや CLI による代替手段を提示
活用シーン
- 01会話やスレッドへのリンクを作る
- 02エディターでファイルを開く
- 03アプリの設定画面へ案内する
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ composio-community/ awesome-codex-skills --skill agent-deep-linksインストール後、Claude Code で/agent-deep-linksを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlreferences/deep-link-matrix.md
詳細
エージェントのディープリンク
概要
ユーザーがアプリで直接開くクリック可能なリンク(通常は Slack から)を求めている場合に、このスキルを使用します。対象アプリがディープリンクに対応しているかの確認、適切な URL 形式の選択、ディープリンクがサポートされていない場合の代替手段の提示が含まれます。
ワークフロー
- 対象アプリと対象オブジェクトを特定します:
- スレッド/会話
- ファイル/フォルダー
- 設定/新しいウィンドウ
- 既知の有効なリンク形式とサポートレベルについて、
references/deep-link-matrix.mdを確認します。 - サポート状況が不明な場合は、送信前にローカルで確認します:
- アプリバンドル内の URL スキームを確認します:
/usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist - 起動動作を簡易テストします:
open '<scheme>://...'
- アプリバンドル内の URL スキームを確認します:
- Slack で安全に使えるリンク構文を作成します:
<url|label>
- サポートされていない、または不確かな場合は、代替手段を提示します:
- プレーンなパスとコマンド
- ドキュメント化された CLI の起動コマンド
- 公式のディープリンク形式が知られていない旨
出力ルール
- ファイル/フォルダーのリンクには絶対パスを優先します。
- ラベルは短く、操作が分かるものにします(
Open in Cursor、Open in Codex)。 - マトリックスに記載されているか、確認済みでない限り、ディープリンクに対応していると断言しないでください。
- アプリのルートが不確かな場合は、推定/実験的なものとして明記します。
よく使うテンプレート
- Codex のスレッド:
<codex://threads/<thread-uuid>|Open in Codex>
- Cursor のファイル:
<cursor://file/<absolute-path>:<line>:<column>|Open in Cursor>
- VS Code のファイル:
<vscode://file/<absolute-path>:<line>:<column>|Open in VS Code>
- VS Code Insiders のファイル:
<vscode-insiders://file/<absolute-path>:<line>:<column>|Open in VS Code Insiders>
アプリ間の全マトリックスとサポートに関する注記は、references/deep-link-matrix.md を参照してください。
コメント
Markdown 対応