agent-deep-links

Q: How do I install agent-deep-links?

Run npx skills add https://github.com/composio-community/awesome-codex-skills --skill agent-deep-links in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/agent-deep-links/ (personal) or .claude/skills/agent-deep-links/ (project).

by composio-communityProductivity & Automation

Build, validate, and troubleshoot deep links for Codex, Cursor, VS Code, Visual Studio, and similar tools. Use when users ask for clickable links (especially in Slack) that open threads, files, folders, or app settings.

Installs: 465
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

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

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads agent-deep-links automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

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:
- 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>://...'
```
Construct Slack-safe link syntax:
- <url|label>
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.

FAQ

What does the agent-deep-links skill do?

How do I install agent-deep-links?

Run npx skills add https://github.com/composio-community/awesome-codex-skills --skill agent-deep-links in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/agent-deep-links/ (personal) or .claude/skills/agent-deep-links/ (project).

Which AI agents can use agent-deep-links?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is agent-deep-links safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains agent-deep-links?

It is published by composio-community in composio-community/awesome-codex-skills. It has 465 recorded installs.