What problem does it solve?
This Skill enforces strict rules for managing semantic conventions in claude.* attributes, ensuring consistency, backward compatibility, and adherence to naming patterns.
Core Features & Use Cases
- Additive-Only Changes: Guarantees that existing attributes are never removed or renamed, preventing breakage in user monitoring pipelines.
- Naming Pattern Enforcement: Validates that all new attributes follow the
claude.[category].[name] pattern.
- Category and Type Validation: Restricts attributes to predefined categories (
session, turn, tool, cost) and allowed data types (string, int, float, bool, string[]).
- Use Case: When a developer proposes adding a new telemetry attribute for agent cost, this Skill automatically checks if the name is valid, if the category is correct, and if the data type is appropriate, preventing potential future issues.
Quick Start
Use the semconv skill to validate the naming convention for a new attribute claude.session.user_agent.