relay-conformance-audit

Audits Sentry Cocoa SDK protocol mismatches against Relay specifications.

1.1k|410|Updated Apr 5, 2016
One-click install
npx skills add https://github.com/getsentry/sentry-cocoa --skill relay-conformance-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: relay-conformance-audit
Source: https://github.com/getsentry/sentry-cocoa/tree/main/skills/relay-conformance-audit
Command: npx skills add https://github.com/getsentry/sentry-cocoa --skill relay-conformance-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill detects silent protocol and wire-format mismatches between the Sentry Cocoa SDK and Relay that can drop, misroute, or miscount telemetry without producing obvious errors.

Core Features & Use Cases

  • Comprehensive Protocol Auditing: Checks headers, rate limits, data categories, envelope formats, client reports, authentication, dynamic sampling context, tracing, sessions, and sampling invariants against Relay specifications.
  • Cross-SDK Corroboration: Compares candidate mismatches with independent implementations in Sentry peer SDKs to distinguish Cocoa-specific defects from ecosystem-wide behavior or false positives.
  • Guarded Issue Management: Deduplicates and updates relay-audit GitHub issues, respects human-maintained ignore scenarios, performs reverse checks for resolved findings, and audits coverage-map drift.
  • Use Case: Run the weekly audit after a networking or protocol change to identify a casing error in a rate-limit header, verify it against Relay and peer SDKs, and file a precise, commit-pinned issue without modifying SDK code.

Quick Start

Run the relay-conformance-audit skill from a sentry-cocoa checkout to audit the current protocol surface and report corroborated findings through GitHub.

Frequently Asked Questions about relay-conformance-audit

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

FAQPage Schema
How do I audit Sentry Cocoa SDK protocol conformance against Relay?

To audit Sentry Cocoa SDK protocol conformance against Relay, run the relay-conformance-audit skill from a sentry-cocoa checkout to check headers, rate limits, envelope formats, and telemetry data categories against Relay specifications.

What causes silent telemetry drops between Sentry Cocoa and Relay?

Silent telemetry drops between Sentry Cocoa and Relay are caused by protocol and wire-format mismatches that misroute or drop data without producing obvious errors, requiring a conformance audit to detect.

Can I use relay-conformance-audit to file GitHub issues for SDK protocol drift?

Yes, relay-conformance-audit deduplicates and updates relay-audit GitHub issues using authenticated GitHub CLI access, filing precise, commit-pinned issues for corroborated protocol drift findings without modifying SDK code.

Do I need authenticated GitHub CLI access to run a Relay protocol audit?

Yes, you need authenticated GitHub CLI access for issue and draft pull request workflows, alongside repository access and Relay source inspection, to fully execute the Relay protocol audit and issue management.

When should I run a Relay wire-format conformance check on the Cocoa SDK?

You should run a Relay wire-format conformance check on the Cocoa SDK during scheduled weekly audits or immediately after networking, envelope, telemetry, or wire-format changes to identify silent protocol drift.

What protocol surfaces are validated during a Relay telemetry conformance audit?

A Relay telemetry conformance audit validates headers, rate limits, data categories, envelope formats, client reports, authentication, dynamic sampling context, tracing, sessions, and sampling invariants against Relay specifications.