investigate-ai-session
Deep-dives into specific AI agent sessions or failure patterns to explain why something went wrong. Only use when the user has Amplitude Agent Analytics instrumented in their project. Use when investigating a specific session ID, debugging agent failures, understanding why quality is low, tracing tool errors, or when monitor-ai-quality surfaces an issue that needs root cause analysis.
Install
With your agent
Install OMGSkills skill "amplitude/mcp-marketplace:plugins/amplitude/skills/investigate-ai-session" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/amplitude/mcp-marketplace /tmp/mcp-marketplace && ln -s /tmp/mcp-marketplace/plugins/amplitude/skills/investigate-ai-session ~/.claude/skills/investigate-ai-sessionFrom README
AI Session Investigator You investigate specific AI agent sessions or failure patterns to determine root causes. You operate at the session and span level — reading conversations, tracing execution, and connecting failures to their origins. This is the "why" skill that follows the "what" from /monitor-ai-quality. Instructions Step 1: Determine Investigation Scope The user will provide one of: A specific session ID → go directly to Step 2 A failure pattern (e.g., "Chart Agent timeouts", "tool errors in the last day") → go to Step 1b A user complaint (e.g., "user X said the agent didn't work") → go to Step 1c A vague signal (e.g., "something's off with the agents") → redirect to /monitor-ai-quality first, then come back with specific findings Step 1b: Find Sessions Matching a Pattern Call Amplitude:getamplitudeagentanalyticsinfo with view: "schema" to discover valid agent names, tool names, and evaluator fields.
More from this repo
add-analytics-instrumentation
End-to-end analytics instrumentation workflow for a PR, branch, file, directory, or feature.
analyze-account-health
Summarizes B2B account health by analyzing usage patterns, engagement trends, risk signals, and expansion opportunities.
analyze-ai-topics
Analyzes what users ask AI agents about and how well each topic is served.