skills.rest
sergiodxa
sergiodxaCOMMUNITY
Explore all skills by this author →
Website𝕏@sergiodxaGitHub

sdxc-server-timing

Collects per-request Server-Timing measurements and renders them onto response headers.

5|Updated Feb 2, 2026
Search Tags:#performance#cloudflare workers#profiling#instrumentation#timing#server-timing#http headers
One-click install
npx skills add https://github.com/sergiodxa/monorepo --skill sdxc-server-timing-sergiodxa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdxc-server-timing
Source: https://github.com/sergiodxa/monorepo/tree/main/.agents/skills/sdxc-server-timing
Command: npx skills add https://github.com/sergiodxa/monorepo --skill sdxc-server-timing-sergiodxa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a response is slow, it is hard to tell which part — database, cache, auth, or an upstream call — caused the delay. This Skill instruments request handlers with a TimingCollector so every response carries a Server-Timing header that browser network panels display as per-segment timings. ## Core Features & Use Cases - Per-request timing collection: A TimingCollector lives for one request; its measure method wraps any async operation, records its duration, and returns the resolved value unchanged. - Header rendering: toString renders the header value and toHeaders writes it onto a Headers object, including copying immutable response headers into a new Response. - Zero-dependency and runtime-agnostic: The package has no dependencies and runs on any runtime that provides the standard Headers API. - Use Case: Wrap a findUserById database call with collector.measure("db", "findUserById", ...) and return the response with collector.toHeaders() so the browser network panel shows Server-Timing: db;desc="findUserById";dur=12.34. ## Quick Start Add @sdxc/server-timing as a workspace dependency and wrap my request handler's database and cache calls with a TimingCollector so every response includes a Server-Timing header.

Frequently Asked Questions about sdxc-server-timing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add Server-Timing headers to HTTP responses?▼

Create one TimingCollector per request, wrap each operation with collector.measure(name, description, fn), and pass collector.toHeaders() into the Response. The header appears as segments like db;desc="findUserById";dur=12.34 in browser network panels.

How do I measure database and cache timing in a request handler?▼

Wrap each async call with collector.measure using a short stable name like db or cache as the grouping key and the varying detail in the description. The measured value is returned unchanged, so existing handler logic stays intact.

Does Server-Timing work with immutable response headers?▼

Yes, but toHeaders sets rather than appends, so for immutable headers from redirects or upstream fetch responses, copy them first: new Response with timing.toHeaders(new Headers(response.headers)).

What runtimes support the Server-Timing collector?▼

The package has no dependencies and runs on any runtime that provides the standard Headers API, including Cloudflare Workers and Bun. Note some runtimes only advance the clock across I/O, so timing I/O calls produces meaningful durations.

What happens to timing when a measured function throws?▼

The measurement is recorded whether the function resolves or rejects, and the rejection is re-thrown untouched. Failed operations still appear in the Server-Timing header with their elapsed duration.

Related Skills

Explore More Software Engineering Skills→
aashahinaashahin

next-cache-components

Implement Next.js 16 Cache Components with use cache, cacheLife, and cacheTag for Partial Prerendering.

Community
Intermediate
gwpjpgwpjp
3

performance-auditor

Measure navigation timings, core web vitals, and network usage in Chrome.

Community
Intermediate
timbuchingertimbuchinger
1

tempo-troubleshoot

Guide TraceQL query crafting for diagnosing latency and errors in Grafana Tempo distributed traces.

Community
Basic
PostHogPostHog
713

exploring-apm-traces

Investigates distributed OpenTelemetry traces and spans in PostHog APM via MCP tools.

Official
Advanced