investigate-application-performance
Skill18 starsChanged 2 months agoApache-2.0View on GitHub
Investigate reviewed Grafana APM evidence for request rate, error rate, and operational latency. Use when an application is slow, erroring, dropping traffic, regressing against a baseline, or needs a bounded request-rate, error, and p95 latency health assessment.
In this repository22 other files it gives its agents.
- AGENTS.mdAGENTS.md
- create-fusion-deliverablesSkill
- edit-fusion-designSkill
- handoff-fusion-engineeringSkill
- inspect-fusion-designSkill
- prepare-fusion-manufacturingSkill
- reconcile-fusion-dataSkill
- run-fusion-cloud-recipesSkill
- setup-autodesk-fusionSkill
- analyze-log-signalsSkill
- inspect-infrastructure-healthSkill
- monitor-iot-edgeSkill
- review-business-kpisSkill
- setup-grafana-observabilitySkill
- audit-ios-readinessSkill
- plan-react-native-portSkill
- port-react-native-sliceSkill
- verify-swiftui-paritySkill
- audit-review-eval-validitySkill
- benchmark-review-configsSkill
- normalize-review-runsSkill
- recommend-review-reference-architectureSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 3 are distinctive, and 8 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
8
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Run the fixed grafana.apm pack to compare request, error, and latency signals while keeping provider queries and configuration server-side.
- Very specific: line 12
Use only grafana_profile_status, grafana_list_packs, grafana_run_pack, grafana_get_evidence, and grafana_resolve_link.
- Distinctive: line 14
Never accept or construct PromQL, LogQL, TraceQL, SQL, URLs, headers, datasource IDs, panel JSON, variables, or raw provider requests.
- Distinctive: line 15
Keep Grafana, datasources, alerts, deployments, and runtime state read-only.
- Very specific: line 21
Call grafana_profile_status({profileAlias}).
- Very specific: line 22
Call grafana_list_packs({profileAlias}) and require the exact active pack ID grafana.apm.
- Distinctive: line 23
Create one non-secret idempotency key and reuse it only for an exact retry.
- Very specific: line 24
Call grafana_run_pack with that key, the aliases, packId: "grafana.apm", origin, current window, and optional baseline window.
- Very specific: line 26
Call grafana_get_evidence({reportRef,evidenceRef}) only for report-owned references needed to substantiate a claim.
- Very specific: line 27
Call grafana_resolve_link({reportRef,linkRef}) only for a same-report link reference that helps verify the finding.
- Very specific: line 29
Call a change a regression only when a returned issue has classification: SIGNED_RULE and kind: REGRESSION.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Investigate Application Performance
Run the fixed grafana.apm pack to compare request, error, and latency signals while keeping provider queries and configuration server-side.
Safety contract
- Use only
grafana_profile_status,grafana_list_packs,grafana_run_pack,grafana_get_evidence, andgrafana_resolve_link. - Accept only profile and scope aliases; one declared
LIVE,REPLAY, orSIMULATEDorigin; bounded current and baseline windows; and opaque references returned by these tools. - Never accept or construct PromQL, LogQL, TraceQL, SQL, URLs, headers, datasource IDs, panel JSON, variables, or raw provider requests.
- Keep Grafana, datasources, alerts, deployments, and runtime state read-only. A result cannot authorize a code patch or production change.
- Confirm
LIVEaccess and never substituteREPLAYorSIMULATEDevidence without saying so.
Workflow
- Establish
profileAlias,scopeAlias, origin, and a current window no longer than seven days. When the user asks whether performance regressed, use an earlier baseline that does not overlap the current window and has exactly the same duration. - Call
grafana_profile_status({profileAlias}). Stop onERRORor blocked readiness; disclosePARTIALreadiness before collection. - Call
grafana_list_packs({profileAlias})and require the exact active pack IDgrafana.apm. - Create one non-secret idempotency key and reuse it only for an exact retry.
- Call
grafana_run_packwith that key, the aliases,packId: "grafana.apm", origin, current window, and optional baseline window. - Review request rate first, then the bounded error-code table, error rate, p95 latency, and required
grafana.apm.traces.slowTempo evidence. Preserve units and distinguish volume changes from reliability or latency changes. - Call
grafana_get_evidence({reportRef,evidenceRef})only for report-owned references needed to substantiate a claim. Do not claim a specific error code or trace cause unless returned evidence explicitly supports it. - Call
grafana_resolve_link({reportRef,linkRef})only for a same-report link reference that helps verify the finding. Never accept a URL as input.
Call a change a regression only when a returned issue has classification: SIGNED_RULE and kind: REGRESSION; it must cite its qualifying equal-duration, non-overlapping baseline evidence. Treat classification: DEVIATION as a deviation. Correlation among traffic, errors, latency, and slow traces is not proof of causation.
Interpret report status exactly
COMPLETE: all expected evidence completed; still distinguish healthy, warning, and critical returned signals.EMPTY: no usable requests or performance evidence were returned; do not translate this into zero errors.STALE: evidence is too old for a current APM claim; expose its timestamps.PARTIAL: evidence or baseline coverage is missing, failed, or mixed; narrow the conclusion accordingly.CONTRADICTORY: signals conflict; preserve the competing evidence and withhold a single causal conclusion.ERROR: collection failed or was rejected; report the sanitized error and stop.
Completion format
Return scope, origin, both windows when used, overall status, request rate, returned error-code counts, error rate, latency signals, slow-trace evidence, issues with their returned classification, evidence gaps and contradictions, evidence references for material claims, and only report-owned trusted links that were resolved successfully.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

