Claude-Skills scrum-master

install
source · Clone the upstream repo
git clone https://github.com/borghei/Claude-Skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/borghei/Claude-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/project-management/scrum-master" ~/.claude/skills/borghei-claude-skills-scrum-master && rm -rf "$T"
manifest: project-management/scrum-master/SKILL.md
source content

Scrum Master Expert

The agent acts as a data-driven Scrum Master combining sprint analytics, behavioral science, and continuous improvement methodologies. It analyzes velocity trends, scores sprint health across 6 dimensions, identifies retrospective patterns, and recommends stage-specific coaching interventions.

Workflow

1. Assess Current State

The agent collects sprint data and establishes baselines:

python scripts/velocity_analyzer.py sprint_data.json --format json > velocity_baseline.json
python scripts/sprint_health_scorer.py sprint_data.json --format text
python scripts/retrospective_analyzer.py sprint_data.json --format text

Validation checkpoint: Confirm at least 3 sprints of data exist (6+ recommended for statistical significance).

2. Analyze Sprint Health

The agent scores the team across 6 weighted dimensions:

DimensionWeightWhat It Measures
Commitment Reliability25%Sprint goal achievement consistency
Scope Stability20%Mid-sprint scope change frequency
Blocker Resolution15%Average time to resolve impediments
Ceremony Engagement15%Participation and effectiveness
Story Completion Distribution15%Completed vs. partial stories ratio
Velocity Predictability10%Delivery consistency (CV target: <20%)

Output: Overall health score (0-100) with grade, dimension breakdowns, trend analysis, and intervention priority matrix.

3. Forecast Velocity

The agent runs Monte Carlo simulation on historical velocity data:

python scripts/velocity_analyzer.py sprint_data.json --format text

Output includes:

  • Rolling averages (3, 5, 8 sprint windows)
  • Trend detection via linear regression
  • Volatility classification (coefficient of variation)
  • Anomaly detection (outliers beyond 2 sigma)
  • 6-sprint forecast with 50%, 70%, 85%, 95% confidence intervals

Validation checkpoint: If CV > 30%, flag team as "high volatility" and recommend root-cause investigation before using forecasts for planning.

4. Plan Sprint Capacity

python scripts/sprint_capacity_calculator.py team_data.json --format text

The calculator accounts for:

  • Per-member availability (PTO, allocation percentage)
  • Ceremony overhead: planning (2h) + daily standup (15min/day) + review (1h) + retro (1h) + refinement (1h)
  • Focus factor (80% realistic, 85% optimistic)
  • Story point estimates (conservative, realistic, optimistic) from historical velocity

Validation checkpoint: If any team member has >40% PTO or <50% allocation, the tool raises a warning.

5. Facilitate Retrospective

The agent uses retrospective analyzer insights to guide discussion:

python scripts/retrospective_analyzer.py sprint_data.json --format text

Analysis includes:

  • Action item completion rates by priority and owner
  • Recurring theme identification with persistence scoring
  • Sentiment trend tracking (positive/negative)
  • Team maturity assessment (forming/storming/norming/performing)

Validation checkpoint: Limit new action items to the team's historical completion rate. If the team completes 50% of action items, cap at 2-3 new items per retro.

6. Coach Team Development

The agent maps team behaviors to Tuckman's stages and recommends interventions:

StageBehavioral IndicatorsCoaching Approach
FormingPolite, tentative, dependent on SMProvide structure, educate on process, build relationships
StormingConflict, resistance, frustrationFacilitate conflict, maintain safety, flex process
NormingCollaboration emerging, shared normsBuild autonomy, transfer ownership, develop skills
PerformingHigh productivity, self-organizingIntroduce challenges, support innovation, expand impact

Psychological safety assessment uses Edmondson's 7-point scale. Track speaking-up frequency, mistake discussion openness, and help-seeking behavior.

Example: Sprint Planning with Forecast

Given 6 sprints of velocity data [18, 22, 20, 19, 23, 21]:

$ python scripts/velocity_analyzer.py sprint_data.json --format text

Velocity Analysis
=================
Average: 20.5 points
Trend: Stable (slope: +0.3/sprint)
Volatility: Low (CV: 8.7%)

Monte Carlo Forecast (next sprint):
  50% confidence: 19-22 points
  85% confidence: 17-24 points
  95% confidence: 16-25 points

Recommendation: Commit to 19-20 points for reliable delivery.
Use 22 points only if team has no PTO and no known blockers.

The agent then cross-references this with capacity calculator output and health scores to recommend a sustainable commitment level.

Input Schema

All tools accept JSON following

assets/sample_sprint_data.json
:

{
  "team_info": { "name": "string", "size": "number", "scrum_master": "string" },
  "sprints": [
    {
      "sprint_number": "number",
      "planned_points": "number",
      "completed_points": "number",
      "stories": [],
      "blockers": [],
      "ceremonies": {}
    }
  ],
  "retrospectives": [
    {
      "sprint_number": "number",
      "went_well": ["string"],
      "to_improve": ["string"],
      "action_items": []
    }
  ]
}

Tools

ToolPurposeCommand
velocity_analyzer.py
Velocity trends, Monte Carlo forecasting
python scripts/velocity_analyzer.py sprint_data.json --format text
sprint_health_scorer.py
6-dimension health scoring
python scripts/sprint_health_scorer.py sprint_data.json --format text
retrospective_analyzer.py
Retro pattern analysis, action tracking
python scripts/retrospective_analyzer.py sprint_data.json --format text
sprint_capacity_calculator.py
Capacity planning with ceremony overhead
python scripts/sprint_capacity_calculator.py team_data.json --format text

Templates & Assets

  • assets/sprint_report_template.md
    -- Sprint report with health grade, velocity trends, quality metrics
  • assets/team_health_check_template.md
    -- Spotify Squad Health Check adaptation (9 dimensions)
  • assets/sample_sprint_data.json
    -- 6-sprint dataset for testing tools
  • assets/expected_output.json
    -- Reference outputs (velocity avg 20.2, health 78.3/100)
  • assets/user_story_template.md
    -- Classic and Job Story formats with INVEST criteria
  • assets/sprint_plan_template.md
    -- Sprint plan with capacity, commitments, risks

References

  • references/velocity-forecasting-guide.md
    -- Monte Carlo implementation, confidence intervals, seasonality adjustment
  • references/team-dynamics-framework.md
    -- Tuckman's stages, psychological safety building, conflict resolution
  • references/sprint-planning-guide.md
    -- Pre-planning checklist, SMART goals, capacity methodology

Key Metrics & Targets

MetricTargetMeasurement
Health Score>80/100Sprint-level, 6 dimensions
Velocity Predictability (CV)<20%Rolling 6-sprint window
Commitment Reliability>85%Sprint goals achieved / attempted
Scope Stability<15% changeMid-sprint scope changes
Blocker Resolution<3 days avgTime from raised to resolved
Action Item Completion>70%Retro items done by next retro
Ceremony Engagement>90%Attendance + participation quality
Psychological Safety>4.0/5.0Monthly pulse survey

Troubleshooting

SymptomLikely CauseResolution
Velocity drops for 2+ sprints without team changeHidden scope creep, unclear definition of done, or tech debt accumulationRun
sprint_health_scorer.py
to check scope stability score; tighten DoD and refinement process
CV exceeds 30% despite stable teamInconsistent story sizing, mid-sprint scope injection, or unplanned absencesAnalyze anomalies via
velocity_analyzer.py
; introduce reference stories for estimation calibration
Action item completion rate below 50%Too many action items per retro, no owners assigned, or unrealistic scopeCap new items at 2-3 per retro based on
retrospective_analyzer.py
historical completion data
Health score below 60 but team feels productiveDimension weights may not match team context, or ceremony data is incompleteReview dimension weights in HEALTH_DIMENSIONS config; ensure ceremony attendance data is populated
Monte Carlo forecast has wide confidence intervalsInsufficient historical data or high velocity volatilityAccumulate 6+ sprints of data; address root causes of volatility before relying on forecasts
Sprint capacity calculator overestimatesFocus factor set too high or ceremony overhead not calibratedAdjust focus factor from 0.85 to 0.80; verify ceremony durations match actual team practices
Retrospective themes keep recurring across sprintsSystemic issues not addressed at root cause, or action items too superficialUse
retrospective_analyzer.py
persistent issue detection; escalate recurring themes to management

Success Criteria

  • Sprint health score consistently above 80/100 across 6-dimension assessment
  • Velocity coefficient of variation (CV) maintained below 20% over rolling 6-sprint window
  • Sprint commitment reliability exceeds 85% (completed vs. planned points)
  • Action item completion rate from retrospectives exceeds 70% by next retro
  • Blocker average resolution time under 3 working days
  • Team maturity advances at least one Tuckman stage within 3-6 months of coaching
  • Psychological safety score on Edmondson scale exceeds 4.0/5.0

Scope & Limitations

In Scope:

  • Sprint-level data analysis (velocity, health, capacity, retrospectives)
  • Statistical forecasting using Monte Carlo simulation on historical velocity
  • Team dynamics coaching based on Tuckman model and Edmondson psychological safety
  • Ceremony facilitation guidance and retrospective pattern analysis

Out of Scope:

  • Portfolio-level project management (see
    senior-pm/
    skill)
  • Product backlog prioritization and roadmap decisions (see
    execution/prioritization-frameworks/
    )
  • Individual performance evaluation -- this skill measures team-level metrics only
  • Real-time Jira/Confluence integration (see
    jira-expert/
    and
    confluence-expert/
    skills)
  • SAFe-specific PI planning or cross-team dependency management (see
    program-manager/
    )

Important Caveats:

  • The Scrum Guide 2020 removed the term "velocity" as a required artifact; this skill treats velocity as a diagnostic tool, not a performance measure. Flow metrics (cycle time, throughput, WIP) complement velocity for delivery forecasting. Use both -- velocity for sprint planning, flow metrics for process improvement.
  • Monte Carlo forecasts require minimum 3 sprints of data (6+ recommended); forecasts with fewer data points carry high uncertainty.
  • Health scores are heuristics, not absolute measures. Calibrate dimension weights to your team context.

Integration Points

IntegrationDirectionDescription
senior-pm/
Feeds intoSprint velocity and health data informs portfolio-level health dashboards and executive reporting
sprint-retrospective/
ComplementsGit-based velocity analysis complements this skill's JSON-based sprint data analysis
execution/brainstorm-okrs/
Feeds intoSprint capacity data helps set realistic OKR targets for the quarter
execution/prioritization-frameworks/
Receives fromPrioritized backlog items feed into sprint planning commitment decisions
discovery/pre-mortem/
Receives fromLaunch-blocking tigers may surface as sprint blockers requiring SM intervention
Jira via Atlassian MCPBidirectionalPull sprint data for analysis; push health reports to Confluence dashboards
CI/CD PipelinesReceives fromDeployment frequency and lead time data supplement velocity metrics

Tool Reference

velocity_analyzer.py

Analyzes sprint velocity data with trend detection, Monte Carlo forecasting, and anomaly identification.

FlagTypeDefaultDescription
data_file
positional(required)Path to JSON file containing sprint data
--format
choice
text
Output format:
text
or
json

sprint_health_scorer.py

Scores sprint health across 6 weighted dimensions with composite grading and recommendations.

FlagTypeDefaultDescription
data_file
positional(required)Path to JSON file containing sprint health data
--format
choice
text
Output format:
text
or
json

retrospective_analyzer.py

Processes retrospective data to track action item completion, identify recurring themes, and assess team maturity.

FlagTypeDefaultDescription
data_file
positional(required)Path to JSON file containing retrospective data
--format
choice
text
Output format:
text
or
json

sprint_capacity_calculator.py

Calculates sprint capacity accounting for ceremony overhead, PTO, allocation percentages, and focus factor.

FlagTypeDefaultDescription
data_file
positional(optional)Path to JSON file containing team capacity data
--format
choice
text
Output format:
text
or
json
--demo
flagoffRun with built-in sample data