Expert methodology for defining, tracking, and interpreting engineering performance metrics including DORA, team health, productivity, and executive reporting.
This skill provides a comprehensive framework for measuring engineering organization performance. Use it to define metrics, create dashboards, interpret data, and communicate engineering impact to different stakeholders (executives, board, engineering team).
Trigger this skill when you need to:
Follow this systematic approach to engineering metrics:
Identify the Question
Know Your Audience
Avoid Metric Traps
Choose the appropriate framework for your context:
The gold standard for measuring DevOps effectiveness:
Use references/frameworks/dora-metrics.md for detailed implementation.
When to use: Assessing DevOps maturity, improving deployment pipeline
Holistic view of developer productivity across 5 dimensions:
Use references/frameworks/space-framework.md for implementation.
When to use: Understanding developer experience, diagnosing productivity issues
Connect engineering to business outcomes:
Use references/frameworks/business-impact-metrics.md for details.
When to use: Demonstrating value to executives/board, justifying budget
Measure team sustainability and morale:
Use references/frameworks/team-health-metrics.md for surveys and benchmarks.
When to use: Preventing burnout, improving retention, building culture
Identify Data Sources
Automate Collection
Establish Baselines
Use references/templates/metrics-implementation-plan.md for step-by-step setup.
Look for Patterns
Ask "Why?"
Define Actions
Avoid Anti-Patterns
Use references/templates/metrics-interpretation-guide.md for analysis playbook.
Tailor your message to the audience:
Focus: Risk, strategic progress, competitive positioning
Key Metrics:
Format: High-level dashboard, traffic-light status, narrative
Use references/templates/board-dashboard.md
Focus: Business impact, velocity, quality, efficiency
Key Metrics:
Format: Executive dashboard with trends and insights
Use references/templates/executive-dashboard.md
Focus: Flow, improvements, celebrating wins
Key Metrics:
Format: Live dashboard, retrospectives, all-hands updates
Use references/templates/team-dashboard.md
Frameworks (references/frameworks/):
dora-metrics.md - Complete DORA implementation guide with benchmarksspace-framework.md - Developer productivity measurementbusiness-impact-metrics.md - Connecting engineering to revenueteam-health-metrics.md - Satisfaction, retention, burnout indicatorsTemplates (references/templates/):
metrics-implementation-plan.md - Step-by-step setup guideboard-dashboard.md - Board presentation templateexecutive-dashboard.md - CEO/executive reportingteam-dashboard.md - Engineering team metricsmetrics-interpretation-guide.md - How to analyze and act on datasurvey-templates.md - Developer satisfaction surveysExamples (references/examples/):
Example 1: User says "Set up DORA metrics for my 30-person engineering team"
ā Load references/frameworks/dora-metrics.md
ā Identify data sources (e.g., GitHub + CircleCI + PagerDuty)
ā Create implementation plan using template
ā Define baseline benchmarks for team stage
ā Set up dashboard with targets
ā Provide interpretation guide
Example 2: User says "Create board presentation showing engineering performance"
ā Load references/templates/board-dashboard.md
ā Focus on: reliability, security, strategic initiatives, team health
ā Use traffic-light status for clarity
ā Include 1-2 key risks and mitigation plans
ā Keep to 3-5 slides maximum
ā Provide talking points
Example 3: User says "Our deployment frequency is low, help diagnose why"
ā Look at full DORA metrics: lead time, MTTR, change failure rate ā Check deployment process: manual steps, review bottlenecks, test duration ā Survey team for qualitative insights ā Identify top 3 blockers ā Create improvement plan with expected metrics impact
Example 4: User says "Prove that engineering is being productive to the CEO"
ā Load references/frameworks/business-impact-metrics.md
ā Calculate: features shipped, customer impact, time to market
ā Show efficiency: cost per feature, productivity trends
ā Demonstrate quality: bug rates, incident trends
ā Connect to business goals: revenue features vs. platform investment
ā Use executive dashboard template
Focus: Speed to learn, customer feedback
Key Metrics (3-5):
Anti-Pattern: Over-measuring at this stage. Stay lean.
Focus: Scaling processes, maintaining quality
Key Metrics (5-7):
Challenge: Maintaining speed while adding process
Focus: Efficiency, coordination, technical excellence
Key Metrics (7-10):
Challenge: Comparing teams fairly, avoiding metric gaming
Focus: Strategic alignment, innovation balance, efficiency
Key Metrics (10-15):
Challenge: Not drowning in metrics, maintaining agility
These metric patterns indicate issues:
| Pattern | Possible Issue | Action |
|---|---|---|
| Deploy frequency ā | Fear of breaking things, process overhead | Simplify process, improve testing |
| Lead time ā | Bottlenecks, growing complexity | Find bottlenecks (code review? testing?) |
| MTTR ā | Poor monitoring, unclear ownership | Improve observability, on-call process |
| Change failure rate ā | Insufficient testing, rushing | Strengthen testing, review release process |
| Satisfaction ā | Burnout, unclear direction, blockers | Talk to team, address top frustrations |
| Retention rate ā | Culture issues, compensation, growth | Exit interviews, competitive analysis |
All outputs should be:
Version: 1.0.0 Philosophy: Measure what matters, act on insights, improve continuously