telemetry-best-practices Skill

Source

• Creator: microsoft
• Repository: microsoft/vscode-cosmosdb
• Skill file: .github/skills/telemetry-best-practices/SKILL.md

What it does

Reviews and authors telemetry code in this extension. Use when adding, modifying, or reviewing any callWithTelemetryAndErrorHandling call, any context.telemetry.properties/measurements assignment, or any helper that reports stats to telemetry. Ensures no PII/EUII is emitted, that property vs. measurement usage is corre

Skill instructions

Telemetry Best Practices This extension uses @microsoft/vscode-azext-utils (callWithTelemetryAndErrorHandling, IActionContext.telemetry) to emit telemetry events. Telemetry is public — assume every property and measurement value is shipped to a backend and visible to whoever has access to the dashboards. Treat every new property as a privacy decision. These rules apply to the entire codebase (extension host, webviews, language services, helper packages), not to any single feature area. When to Use This Skill Apply it whenever code: - Calls callWithTelemetryAndErrorHandling(...), callWithTelemetryAndErrorHandlingSync(...), or registers a command (which wraps the same). - Assigns to context.telemetry.properties. or context.telemetry.measurements.. - Defines a helper (e.g. reportStats, track, Telemetry) that mutates an IActionContext. - Adds or renames a telemetry event string (the first argument to callWithTelemetryAndErrorHandling). Hard Rules — Never Emit PII / EUII The following must