gh-gtmagents-gtm-agents-plugins-data-signal-enrichment/skills/signal-taxonomy/SKILL.md

name, description

name	description
signal-taxonomy	Use to define schemas, topic tags, and lineage metadata for enriched signals.

Signal Taxonomy Skill

When to Use

• Normalizing multiple provider outputs into a unified schema.
• Rolling out new intent topics, enrichment attributes, or scoring dimensions.
• Auditing lineage + compliance requirements.

Framework

1. Schema Definition – fields, datatypes, required/optional flags.
2. Topic & Attribute Mapping – align provider-specific attributes to canonical names.
3. Versioning – maintain change logs, effective dates, and migration steps.
4. Validation Rules – min/max values, allowed lists, dependency rules.
5. Documentation – publish data dictionary + lineage diagrams.

Templates

• Data dictionary sheet (field, description, source, owner).
• Topic mapping table by provider.
• Migration checklist for schema changes.

Tips

• Keep names human-readable for GTM teams but consistent with data warehouse standards.
• Tag every field with owner + refresh cadence.
• Pair with identity-resolution to ensure IDs and linkages stay consistent.

---