microsoft/power-platform-skills / plugins/process-intelligence/skills/analyze-performance
analyze-performance
VerifiedUse when investigating slow activities, waiting, handoff duration, bottlenecks or cumulative activity workload.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.4 KB |
SKILL.md
View on GitHub---
name: analyze-performance
description: Use when investigating slow activities, waiting, handoff duration, bottlenecks or cumulative activity workload.
allowed-tools: Read, AskUserQuestion
---
# Performance: averages are not total impact
Use the [shared contract](../../references/analysis-contract.md) and
[units/filter semantics](../../references/filters-and-units.md).
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:
1. **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`.
2. **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.
3. 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](../../references/investigation-method.md) to label observations
and tested findings, retain counterevidence and identify a discriminating next check.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |