- name
- developer-performance-diagnostic
- description
- This skill should be used when the user asks to "diagnose performance issues", "analyze team performance", "investigate underperformance", "identify performance patterns", or "assess team health". Analyzes performance data to detect patterns, systemic issues, and individual concerns with data-driven recommendations.
- version
- 0.1.0
- license
- MIT
Developer Performance Diagnostic
Systematically diagnose team and individual performance issues using data-driven analysis.
Purpose
- Detect performance patterns (systemic vs. individual)
- Identify root causes (not just symptoms)
- Distinguish performance issues from external factors
- Recommend targeted interventions
- Track performance trends over time
Diagnostic Framework
Data Collection
Quantitative Signals:
- Velocity/throughput (stories/sprint, PRs/month)
- Quality (bug rates, incident frequency)
- Code review metrics (time to review, feedback quality)
- On-time delivery (deadline adherence)
- Availability (attendance, responsiveness)
Qualitative Signals:
- Peer feedback
- Stakeholder satisfaction
- 1:1 notes
- Code review comments
- Meeting participation
Pattern Analysis
Individual Underperformance:
- Isolated to one person
- Peer feedback identifies specific behaviors
- Manager has documented concerns
- Performance gaps vs. level expectations
Systemic Issues:
- Multiple team members affected
- External factors (org changes, unclear priorities)
- Resource constraints (tooling, access)
- Process problems (inefficient workflows)
Root Cause Identification
Common Root Causes:
- Skill gaps (training needed)
- Unclear expectations (communication issue)
- Personal issues (health, family, burnout)
- Poor management (lack of feedback, support)
- Role misfit (wrong level or role type)
- External blockers (dependencies, priorities)
Diagnostic Output
{
"team": "Platform",
"period": "Q4 2025",
"findings": [
{
"type": "individual",
"employee": "Name",
"pattern": "Consistently missing sprint commitments",
"evidence": [
"Missed 4 of last 6 sprint goals",
"Peer feedback: unclear communication about blockers"
],
"root_cause": "Skill gap in task estimation + reluctance to ask for help",
"recommendation": "Mentorship on estimation, explicit encouragement to surface blockers early",
"urgency": "medium"
},
{
"type": "systemic",
"pattern": "Team velocity down 30% this quarter",
"evidence": [
"Average velocity: 45 → 32 story points",
"All engineers report similar drop"
],
"root_cause": "Increased on-call load (2x incidents) + unclear Q4 priorities",
"recommendation": "Reduce scope, clarify priorities, investigate incident root causes",
"urgency": "high"
}
]
}Using Supporting Resources
Templates
templates/metrics-template.json- Performance metrics to tracktemplates/diagnostic-framework.md- Root cause analysis guide
Scripts
scripts/analyze-patterns.py- Auto-detect performance anomalies