definitionmetric-catalog
Document key metrics, definitions, and segmentation required to track product success.
When & Why to Use This Skill
The Metric Catalog skill streamlines the process of defining and documenting key performance indicators (KPIs) for product success. It enables Product Managers and Data Analysts to create a centralized source of truth for metric definitions, formulas, and segmentation requirements, ensuring data consistency and organizational alignment across analytics platforms.
Use Cases
- Product Launch Planning: Defining success metrics and required data dimensions before a new feature release to ensure immediate and accurate performance tracking.
- Data Governance: Standardizing business definitions and formulas across departments to eliminate reporting discrepancies and ensure everyone relies on the same data logic.
- Analytics Onboarding: Creating a comprehensive knowledge base for new team members to understand the product's measurement framework and available data tools.
- Instrumentation Requirements: Bridging the gap between business goals and engineering by providing clear checklists for data logging and tracking implementation.
| name | definition.metric_catalog |
|---|---|
| phase | definition |
| description | Stakeholders who rely on the metrics. |
| - name | stakeholders |
Purpose
Ensure product and analytics teams align on the metrics that matter, how they are defined, and how they will be reported.
Pre-run Checklist
- ✅ Review existing dashboards and metric definitions.
- ✅ Confirm segmentation requirements with stakeholders.
- ✅ Verify data availability or instrumentation plans for new metrics.
Invocation Guidance
codex run --skill definition.metric_catalog \
--vars "theme={{theme}}" \
"required_segments={{required_segments}}" \
"measurement_tools={{measurement_tools}}" \
"stakeholders={{stakeholders}}"
Recommended Input Attachments
- Current metric definitions or SQL queries.
- Business reviews or KPI scorecards.
Claude Workflow Outline
- Summarize the theme and stakeholders.
- Build a catalog table with metric names, definitions, formulas, owners, and tools.
- Detail segmentation requirements, data sources, and known gaps.
- Provide governance and instrumentation checklist for each metric.
- Suggest review cadence and communication plan.
Output Template
## Metric Catalog — {{theme}}
| Metric | Definition | Formula / Source | Owner | Tool | Segments |
| --- | --- | --- | --- | --- | --- |
## Segmentation Guidance
- Required Segments:
- Data Availability:
- Known Gaps:
## Governance & Instrumentation
| Metric | Quality Checks | Instrumentation Actions | Review Cadence |
| --- | --- | --- | --- |
Follow-up Actions
- Publish the catalog in the analytics knowledge base.
- Align with engineering on instrumentation stories.
- Schedule periodic metric reviews to ensure definitions stay current.