Skip to content

[skills] Add vercel-tracing skill - #336

Open
kakadiadarpan wants to merge 11 commits into
mainfrom
add-vercel-tracing-skill
Open

kakadiadarpan wants to merge 11 commits into
mainfrom
add-vercel-tracing-skill

Conversation

@kakadiadarpan

Copy link
Copy Markdown

Problem / Intent

Agents have no guidance for setting up OpenTelemetry on Vercel. They guess where registerOTel goes, miss incoming trace context, and misread vercel traces output. Spans then land in the wrong trace, or nobody checks them.

Approach

A new vercel-tracing skill focused on instrumentation setup. SKILL.md has a setup workflow with the Next.js registration snippet, an investigation workflow, and notes on how the CLI behaves in agent (non-interactive) mode. Short references cover framework setup (Next.js, SvelteKit, any other framework), custom spans, context propagation, sampling, capture, search, inspection, performance, and troubleshooting. Search guidance matches the JSON Lines output of Vercel CLI 64.

The performance-optimizer agent includes the investigation workflow. vercel-cli and vercel-functions chain to the skill on vercel traces and @vercel/otel.

Agents followed the skill on fresh Next.js 16.4 and SvelteKit 3 apps deployed to Vercel previews. Setup worked on the first deploy, and custom spans nested under the request in the same trace.

@lucleray lucleray left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good, thanks! a few non-blocking notes inline 👍

Comment thread skills/vercel-tracing/references/search.md Outdated
Comment thread skills/vercel-tracing/SKILL.md Outdated
Comment thread skills/vercel-tracing/SKILL.md Outdated
Comment thread agents/performance-optimizer.md.tmpl
Comment thread skills/vercel-tracing/references/custom-spans.md Outdated
Comment thread skills/vercel-tracing/references/nextjs.md Outdated
Comment thread skills/vercel-tracing/SKILL.md Outdated
@kakadiadarpan
kakadiadarpan marked this pull request as ready for review October 14, 2026 14:50
@vercel
vercel Bot requested a review from molebox October 14, 2026 14:50

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants