mcpField
A
agent-deep-links

agent-deep-links

github.com/composio-communityProductivity17.1k467 installsUpdated 14w ago
Repository

About agent-deep-links

A skill for creating clickable links that open specific items in apps, often from Slack. It checks supported deep-link formats and supplies a fallback when support is unavailable or uncertain.

Key features

  1. 01Identify the target app and item
  2. 02Consult a deep-link support matrix
  3. 03Verify unknown schemes locally
  4. 04Format links for Slack
  5. 05Provide path or CLI fallbacks

Use cases

  1. 01Link to a conversation or thread
  2. 02Open a file in an editor
  3. 03Direct someone to app settings

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/composio-community/awesome-codex-skills --skill agent-deep-links

After installing, type/agent-deep-linksin Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlreferences/deep-link-matrix.md

Details

From the project README

Agent Deep Links

Overview

Use this skill when a user asks for clickable links that should open directly in an app (usually from Slack). This includes verifying whether a target app supports deep links at all, selecting the right URL shape, and providing fallbacks when deep links are unsupported.

Workflow

  1. Identify target app + target object:
    • Thread/conversation
    • File/folder
    • Settings/new window
  2. Read references/deep-link-matrix.md for known-good link formats and support level.
  3. If support is unknown, verify locally before sending:
    • Check URL schemes in the app bundle: 
      /usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist
    • Smoke test launch behavior: 
      open '<scheme>://...'
  4. Construct Slack-safe link syntax:
    • <url|label>
  5. If unsupported or uncertain, send a fallback:
    • Plain path + command
    • Documented CLI open command
    • Statement that no official deep-link format is known

Output Rules

  • Prefer absolute paths for file/folder links.
  • Keep labels short and action-oriented (Open in Cursor, Open in Codex).
  • Do not claim deep-link support unless it is in the matrix or just verified.
  • For uncertain app routes, clearly mark as inferred/experimental.

Common Templates

  • Codex thread:
    • <codex://threads/<thread-uuid>|Open in Codex>
  • Cursor file:
    • <cursor://file/<absolute-path>:<line>:<column>|Open in Cursor>
  • VS Code file:
    • <vscode://file/<absolute-path>:<line>:<column>|Open in VS Code>
  • VS Code Insiders file:
    • <vscode-insiders://file/<absolute-path>:<line>:<column>|Open in VS Code Insiders>

Use references/deep-link-matrix.md for the full cross-app matrix and support notes.

Comments

Markdown supported