Performance: averages are not total impact
Use the shared contract and
units/filter semantics.
Reuse S, baseline F and metadata; do not request a baseline overview for an exact top-bottleneck question.
Ordered recipe
Choose the smallest entry branch:
- Slow activities by mean:
get_bottleneck_analysis_v2 {S,itemsPerPage:5,itemsToSkip:0,mcpFilterOptions:F}.
Omit absent F. Duration is average activity duration, already ranked descending.
Do not pass attributeName, metrics, aggregation or limit.
- Cumulative activity duration: skip step 1 if this alone was requested.
From metadata take the exact Activity import attribute A; never assume its name is "Activity".
If advertised, call
get_attribute_statistics {S,attributeName:A,filterOptions:F,itemsPerPage:5,itemsToSkip:0,metricToSortBy:"TotalDuration",sortOrder:"Descending"}.
There is no _v2 suffix. For an event-level Activity, TotalDuration sums matching
events; AvgDuration is their mean. Keep EventFrequency and CaseFrequency distinct.
RelativeCaseFrequency is a ratio; overlapping activity groups' case counts are not additive.
- Only for unresolved evidence, choose a targeted drilldown:
get_edges_with_metrics_v2 {S,filterOptions:F,itemsPerPage:20,itemsToSkip:0} for handoffs,
or get_cases_with_metrics_v2 {S,filterOptions:F,itemsPerPage:5,itemsToSkip:0,metricToSortBy:"WaitingTime",sortOrder:"Descending"}.
Reuse earlier compatible results. Continue relevant drilldowns/pages without fixed call or
total-row ceilings; each query must resolve missing evidence, not repeat an answered question.
Boundaries and stopping
Missing statistics: report the cumulative-measure gap, optionally average-only bottleneck evidence.
Never derive population totals from top-five averages or call a hidden statistics tool.
Edges expose no sort input: local ranking of one incomplete page is page-local, not global.
Report the native edge Duration mean; do not relabel it as an independently established waiting metric.
For a requested global edge ranking, retrieve necessary pages to complete coverage before ranking;
if coverage is incomplete, explicitly leave the global result unresolved.
Event/attribute filters retain whole cases, not just matching events.
Check timestamp imports before interpreting utilization: zero-duration conventions with
start-only data can produce nonzero ratios without measured active work. Keep raw values
and use same-scope cohort evidence; see the unit reference.
Stop once answered or evidence/capability is exhausted. Show at most five headline rows with separate
mean, total and frequency columns only when returned, scope/units and coverage.
High duration is an investigation lead, not proof of cause or a guaranteed time saving.
Mean activity duration times process case count is not total workload: cases are not activity
occurrences. Even known workload is not an intervention's removable delay.
Use the investigation method to label observations
and tested findings, retain counterevidence and identify a discriminating next check.
1---2name: analyze-performance-23description: Use when investigating slow activities, waiting, handoff duration, bottlenecks or cumulative activity workload.4allowed-tools: Read, AskUserQuestion5metadata:6 source: https://skillmd.com/skills/microsoft/analyze-performance-27---89# Performance: averages are not total impact1011Use the [shared contract](../../references/analysis-contract.md) and12[units/filter semantics](../../references/filters-and-units.md).13Reuse S, baseline F and metadata; do not request a baseline overview for an exact top-bottleneck question.1415## Ordered recipe1617Choose the smallest entry branch:18191. **Slow activities by mean:**20 `get_bottleneck_analysis_v2 {S,itemsPerPage:5,itemsToSkip:0,mcpFilterOptions:F}`.21 Omit absent F. `Duration` is **average activity duration**, already ranked descending.22 Do not pass `attributeName`, `metrics`, `aggregation` or `limit`.232. **Cumulative activity duration:** skip step 1 if this alone was requested.24 From metadata take the exact Activity import attribute A; never assume its name is "Activity".25 If advertised, call26 `get_attribute_statistics {S,attributeName:A,filterOptions:F,itemsPerPage:5,itemsToSkip:0,metricToSortBy:"TotalDuration",sortOrder:"Descending"}`.27 There is **no `_v2` suffix**. For an event-level Activity, TotalDuration sums matching28 events; AvgDuration is their mean. Keep EventFrequency and CaseFrequency distinct.29 RelativeCaseFrequency is a ratio; overlapping activity groups' case counts are not additive.303. Only for unresolved evidence, choose a targeted drilldown:31 `get_edges_with_metrics_v2 {S,filterOptions:F,itemsPerPage:20,itemsToSkip:0}` for handoffs,32 or `get_cases_with_metrics_v2 {S,filterOptions:F,itemsPerPage:5,itemsToSkip:0,metricToSortBy:"WaitingTime",sortOrder:"Descending"}`.33 Reuse earlier compatible results. Continue relevant drilldowns/pages without fixed call or34 total-row ceilings; each query must resolve missing evidence, not repeat an answered question.3536## Boundaries and stopping3738Missing statistics: report the cumulative-measure gap, optionally average-only bottleneck evidence.39Never derive population totals from top-five averages or call a hidden statistics tool.40Edges expose no sort input: local ranking of one incomplete page is **page-local**, not global.41Report the native edge Duration mean; do not relabel it as an independently established waiting metric.42For a requested global edge ranking, retrieve necessary pages to complete coverage before ranking;43if coverage is incomplete, explicitly leave the global result unresolved.44Event/attribute filters retain whole cases, not just matching events.45Check timestamp imports before interpreting utilization: zero-duration conventions with46start-only data can produce nonzero ratios without measured active work. Keep raw values47and use same-scope cohort evidence; see the unit reference.4849Stop once answered or evidence/capability is exhausted. Show at most five headline rows with separate50mean, total and frequency columns only when returned, scope/units and coverage.51High duration is an investigation lead, not proof of cause or a guaranteed time saving.52Mean activity duration times process case count is not total workload: cases are not activity53occurrences. Even known workload is not an intervention's removable delay.54Use the [investigation method](../../references/investigation-method.md) to label observations55and tested findings, retain counterevidence and identify a discriminating next check.