Inspect and debug live streaming agent sessions to understand what the agent did.

Apache-2.0Auto-check passedDevOps & Cloud

Install Inspect

skills CLI
$ npx skills add agentevals-dev/agentevals --skill inspect -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install agentevals-dev/agentevals inspect --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/agentevals-dev/agentevals.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/inspect .claude/skills/inspect && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
inspect
GitHub stars
162
Token cost
~534 tokens
SKILL.md length
192 words
Files
2
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Inspect and debug live streaming agent sessions to understand what the agent did.

  • Works in 5 steps: List sessions with list_sessions. Show… → Summarize with summarize_session. This… → Present as a readable narrative. For… → …
  • The user wants to see what happened in a recent agent run
  • Calls uv
  • Trace through the tool calls step by step

What it does

Inspect is an agent skill from agentevals-dev/agentevals. Inspect and debug live streaming agent sessions to understand what the agent did. Use this skill when the user wants to see what happened in a recent agent run, trace through the tool calls step by step, debug unexpected agent behavior, or get a readable narrative of a session. Trigger on phrases like "show me what my agent did", "inspect session", "what happened in that run", "debug my agent", "trace through session", "walk me through the last run", "what tools did it call". Requires agentevals serve --dev to be…

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `evals/evals.json`).

It sits in DevOps & Cloud, covering LLM evaluation and Observability. It works with OpenTelemetry. The repository describes itself as: agentevals is a framework-agnostic evaluations solution based on OpenTelemetry traces. The licence is Apache-2.0.

When your agent uses it

  • The user wants to see what happened in a recent agent run
  • Trace through the tool calls step by step
  • Debug unexpected agent behavior
  • Get a readable narrative of a session

Example prompts

  • “show me what my agent did”
  • “inspect session”
  • “what happened in that run”
  • “/inspect”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. List sessions with list_sessions. Show session ID, completion status,
  2. Summarize with summarize_session. This converts raw OTLP spans into
  3. Present as a readable narrative. For each turn
  4. Flag anything worth investigating
  5. Offer next steps. If the user wants to score the session against a golden

What it can do on your machine

Read from SKILL.md and the folder at commit 94785bb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Inspect loads about 534 tokens when it runs. Until then it costs about 148 tokens; SKILL.md has 192 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~148
When it runs · the whole SKILL.md, loaded when a task matches
~534

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from agentevals-dev/agentevals at commit 94785bb, republished under its Apache-2.0 licence (© agentevals-dev). 192 words, ~534 tokens.

Download SKILL.mdSave it as .claude/skills/inspect/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
inspect
description
Inspect and debug live streaming agent sessions to understand what the agent did. Use this skill when the user wants to see what happened in a recent agent run, trace through the tool calls step by step, debug unexpected agent behavior, or get a readable narrative of a session. Trigger on phrases like "show me what my agent did", "inspect session", "what happened in that run", "debug my agent", "trace through session", "walk me through the last run", "what tools did it call". Requires `agentevals serve --dev` to be running. For scoring/pass-fail evaluation, use /eval instead.

Help the user understand what happened in a live streaming agent session.

If list_sessions or summarize_session fail with a connection error, the server is not running. Tell the user:

bash
uv run agentevals serve --dev

The --dev flag is required — plain serve does not enable the WebSocket endpoint that sessions stream to. Also note: sessions are in-memory only with a 2-hour TTL. If the server was restarted or the session is older than 2 hours, it is gone.

  1. List sessions with list_sessions. Show session ID, completion status, span count, and start time. Default to the most recent completed session unless the user specifies one.

  2. Summarize with summarize_session. This converts raw OTLP spans into structured invocations with user messages, tool calls, and agent responses.

  3. Present as a readable narrative. For each turn:

    Turn 1:
      User: [what the user asked]
      Tools: tool_name(arg=val, ...) → [one-line description of what this achieves]
      Response: [response text, truncated if long]
  4. Flag anything worth investigating:

    • Turns with no tool calls when tools would be expected
    • Empty or very short response after a long tool chain
    • Same tool called repeatedly in one turn (possible loop)
    • Abrupt stop mid-conversation
  5. Offer next steps. If the user wants to score the session against a golden reference (pass/fail), suggest /eval with the session ID or a comparison run.

© agentevals-dev, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .claude/skills/inspect of agentevals-dev/agentevals.

  • SKILL.md
  • evals/evals.json

Open the folder on GitHubat commit 94785bb

Compare with similar skills

Inspect next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Inspect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Inspect this skillagentevals-dev/agentevals162—~534Automated safety check: PassApache-2.0
Improve PromptAgentX-ai/AgentX-Trace-Eval106—~2kAutomated safety check: PassCustom licence
Dt Obs GenaiDynatrace/dynatrace-for-ai161—~4.5kAutomated safety check: PassApache-2.0
Agent Kill Switchvivekchand/clawmetry424—~1.1kAutomated safety check: PassMIT
Sls Dashboard Builderalibaba/loongsuite-pilot198—~1.8kAutomated safety check: PassApache-2.0
Agent Platform Alert Configurationgoogle/skills21k—~4.2kAutomated safety check: PassApache-2.0

Similar skills

  • Improve Prompt

    AgentX-ai/AgentX-Trace-Eval

    Propose an improved version of a prompt registered in a self-hosted AgentX (AgentX-trace-eval) instance, using real low-rated evaluation results as evidence, then publish it as a new version once…

    106 GitHub stars~2k tokensUpdated 6 days ago
    DevOps & CloudAuto-check passed
  • Dt Obs Genai

    Dynatrace/dynatrace-for-ai

    Analyze & debug GenAI/LLM apps: token cost & caching by prompt, model & provider; latency/errors; agent & tool loops/failures; conversations; guardrails; evaluations; OpenTelemetry/dt-evals setup.

    161 GitHub stars~4.5k tokensUpdated 6 days ago
    AI & LLM EngineeringAuto-check passed
  • Agent Kill Switch

    vivekchand/clawmetry

    Give the human an off switch and a cost meter for the coding agents on this machine, using ClawMetry.

    424 GitHub stars~1.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Sls Dashboard Builder

    alibaba/loongsuite-pilot

    当任务需要创建、修改、扩展或重组阿里云 SLS 的 dashboard JSON 或可导入的大盘配置时使用;尤其适用于线上大盘、强对比的分析看板、已校验的查询包,或需要专业中文标签与指标定义的运维向大盘。

    198 GitHub stars~1.8k tokensUpdated 8 days ago
    DevOps & CloudAuto-check passed
  • Official

    Writes Terraform alerting policies for AI agents that emit OpenTelemetry metrics, covering reliability, cost, safety, security and quality signals on Google Cloud.

    21k GitHub stars~4.2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Clawmetry Selfcheck

    vivekchand/clawmetry

    Read your own agent telemetry from ClawMetry (waste, progress, cost) and act on it before finishing a task.

    424 GitHub stars~515 tokensUpdated today
    DevOps & CloudAuto-check passed

More from agentevals-dev/agentevals

  • Eval

    agentevals-dev/agentevals

    Evaluate and score agent behavior against a golden reference.

    162 GitHub stars~904 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Inspect

What does Inspect do?

Inspect and debug live streaming agent sessions to understand what the agent did. Inspect is an agent skill from agentevals-dev/agentevals. Inspect and debug live streaming agent sessions to understand what the agent did.

When should I use Inspect?

Inspect fits situations like: the user wants to see what happened in a recent agent run; trace through the tool calls step by step; debug unexpected agent behavior; get a readable narrative of a session.

How do I install Inspect in Claude Code?

Run `npx skills add agentevals-dev/agentevals --skill inspect -a claude-code`. Or copy the skill folder (.claude/skills/inspect in agentevals-dev/agentevals) into .claude/skills/inspect in your project. Claude Code loads it when a task matches its description.

How do I install Inspect in Codex?

Run `npx skills add agentevals-dev/agentevals --skill inspect -a codex`. Or copy the skill folder (.claude/skills/inspect in agentevals-dev/agentevals) into .agents/skills/inspect in your project. Codex loads it when a task matches its description.

Can I use Inspect in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agentevals-dev/agentevals --skill inspect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/inspect, .gemini/skills/inspect, .github/skills/inspect and .opencode/skills/inspect in your project.

What does Inspect need to run?

Going by SKILL.md and its folder, Inspect needs the command-line tools its instructions call (uv).

Does Inspect access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Inspect safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Inspect use?

Inspect is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Inspect use?

About 534 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Inspect?

Skills that share tags, products or a category with Inspect: Improve Prompt (AgentX-ai/AgentX-Trace-Eval, 106 stars), Dt Obs Genai (Dynatrace/dynatrace-for-ai, 161 stars), Agent Kill Switch (vivekchand/clawmetry, 424 stars) and Sls Dashboard Builder (alibaba/loongsuite-pilot, 198 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Inspect?

agentevals-dev (a GitHub organization) maintains it in agentevals-dev/agentevals, which has 162 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 6, 2026.

Source: agentevals-dev/agentevals on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.