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
Identify target app + target object:
Thread/conversation
File/folder
Settings/new window
Read references/deep-link-matrix.md for known-good link formats and support level.
If support is unknown, verify locally before sending:
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.
1---2name: agent-deep-links3description: Agent Deep Links4---56# Agent Deep Links78## Overview910Use 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.1112## Workflow13141. Identify target app + target object:15 - Thread/conversation16 - File/folder17 - Settings/new window182. Read `references/deep-link-matrix.md` for known-good link formats and support level.193. If support is unknown, verify locally before sending:20 - Check URL schemes in the app bundle:21 ```bash22 /usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist23 ```24 - Smoke test launch behavior:25 ```bash26 open '<scheme>://...'27 ```284. Construct Slack-safe link syntax:29 - `<url|label>`305. If unsupported or uncertain, send a fallback:31 - Plain path + command32 - Documented CLI open command33 - Statement that no official deep-link format is known3435## Output Rules3637- Prefer absolute paths for file/folder links.38- Keep labels short and action-oriented (`Open in Cursor`, `Open in Codex`).39- Do not claim deep-link support unless it is in the matrix or just verified.40- For uncertain app routes, clearly mark as inferred/experimental.4142## Common Templates4344- Codex thread:45 - `<codex://threads/<thread-uuid>|Open in Codex>`46- Cursor file:47 - `<cursor://file/<absolute-path>:<line>:<column>|Open in Cursor>`48- VS Code file:49 - `<vscode://file/<absolute-path>:<line>:<column>|Open in VS Code>`50- VS Code Insiders file:51 - `<vscode-insiders://file/<absolute-path>:<line>:<column>|Open in VS Code Insiders>`5253Use `references/deep-link-matrix.md` for the full cross-app matrix and support notes.
Run npx skillmds@latest add whz39coding/agent-deep-links in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Agent Deep Links It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
whz39coding (@whz39coding) published this skill. Their other Agent Skills are listed on their SkillMD profile.
whz39coding