agent-deep-links
$
npx mdskill add ComposioHQ/awesome-codex-skills/agent-deep-linksGenerate clickable app links for threads, files, and settings.
- Creates Slack-ready URLs that launch specific app objects.
- Consults a deep-link matrix and verifies bundle URL schemes.
- Tests launch behavior locally before recommending a format.
- Outputs formatted Markdown or plain text fallbacks.
SKILL.md
.github/skills/agent-deep-linksView on GitHub ↗
---
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.
More from ComposioHQ/awesome-codex-skills
- codebase-migrateRun large codebase migrations and multi-file refactors. Uses the Composio CLI to coordinate issue tracking, batched PRs, and CI verification while the agent executes the transforms locally across hundreds of files.
- create-planCreate a concise plan. Use when a user explicitly asks for a plan related to a coding task.
- datadog-logsQuery and filter Datadog logs from the shell using the Composio CLI. Run scoped log searches, pivot across services/environments, and export structured JSON for downstream agents instead of click-driving the Datadog UI.
- deploy-pipelineRun end-to-end deploy pipelines across Stripe, Supabase, and Vercel using the Composio CLI. Promote Stripe products, push Supabase migrations, ship Vercel deployments, and verify with post-deploy checks — all from one script.
- email-draft-polishDraft, rewrite, or condense emails with target tone, length, and audience; use for cold outreach, replies, status updates, or escalations where clarity and brevity matter.
- gh-address-commentsHelp address review/issue comments on the open GitHub PR for the current branch using gh CLI; verify gh auth first and prompt the user to authenticate if not logged in.
- gh-fix-ciInspect GitHub PR checks with gh, pull failing GitHub Actions logs, summarize failure context, then create a fix plan and implement after user approval. Use when a user asks to debug or fix failing PR CI/CD checks on GitHub Actions and wants a plan + code changes; for external checks (e.g., Buildkite), only report the details URL and mark them out of scope.
- helium-mcpSearch real-time news with bias scoring, get live stock/ETF/crypto data with AI analysis, ML options pricing, balanced news synthesis, and meme search via the Helium MCP server.
- issue-triageTriage Linear or Jira backlogs and run bug sweeps via the Composio CLI. Bulk-fetch issues, dedupe, relabel, reassign, and post summaries — all from the shell without clicking through the UI.
- meeting-notes-and-actionsTurn meeting transcripts or rough notes into crisp summaries with decisions, risks, and owner-tagged action items; use for Zoom/Meet/Teams transcripts, call notes, or long meeting chats to generate share-ready outputs.