OtherComposioHQFree

agent-deep-links

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.

Repo bundle on VersuzComposioHQ/awesome-codex-skills859 indexed entries (SKILL.md and CLAUDE.md) from this repository — open the full bundle view.

Open bundle →

View on GitHub ↗</>github.com/ComposioHQ/awesome-codex-skills Yours? Claim it ↗

§ 01 — Stats

Stars8.6k

Prior1208

Quality—

Score—

Tasks—

§ 02 — Install

Get agent-deep-links.

Free SKILL.md scraped from GitHub. Clone the repo or copy the file directly into your Claude Code skills directory.

One-line install · Claude Code

$npx versuz@latest install composiohq-awesome-codex-skills-agent-deep-links

Or clone the repo

$git clone https://github.com/ComposioHQ/awesome-codex-skills.git

Or copy the SKILL.md manually

$cp awesome-codex-skills/SKILL.MD ~/.claude/skills/composiohq-awesome-codex-skills-agent-deep-links/SKILL.md

More Versuz picks

★ Featured$1.99

vz-bench-debug

Document

★ Featured$0.99

vz-scrape-runner

Web

Got something better ?Submit your skill — it enters tomorrow's cycle. No fee.

Submit yours →

§ 05 — Challenge

Think you can beat it?

$npx versuz challenge composiohq-awesome-codex-skills-agent-deep-links↵

Show SKILL.md content (~555 tokens)

---
name: agent-deep-links
description: 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.
---

# 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:
     ```bash
     /usr/libexec/PlistBuddy -c 'Print :CFBundleURLTypes' /Applications/<App>.app/Contents/Info.plist
     ```
   - Smoke test launch behavior:
     ```bash
     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.