# Get Results

> Retrieve and analyze simulation results from a Coval run. Use when user wants to review evaluation outcomes or debug agent behavior.

- Skill: `coval-ai/get-results` (Agent Skill)
- Install (CLI): `npx skillmds@latest add coval-ai/get-results`
- Raw SKILL.md: https://api.skillmd.com/api/skills/coval-ai/get-results/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: coval-ai (https://skillmd.com/u/coval-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/coval-ai/get-results

---


# Get Simulation Results

Retrieve results for `$ARGUMENTS`.

## Workflow

### If Run ID Provided

List all simulations for the run:

```bash
coval simulations list --run-id <run_id> --format json
```

### If Simulation ID Provided

Get detailed simulation data:

```bash
coval simulations get <simulation_id> --format json
```

This returns:
- Status (COMPLETED, FAILED)
- Test case ID
- Transcript (conversation history)
- Timestamps
- Error message (if failed)

### Step 2: Analyze Results

For each simulation, extract:

| Field | Description |
|-------|-------------|
| `status` | COMPLETED or FAILED |
| `test_case_id` | Which test case was run |
| `transcript` | Full conversation |
| `has_audio` | Whether audio is available |
| `error_message` | Failure reason (if any) |

### Step 3: Present Summary

```
## Results for Run <run_id>

| Simulation | Status | Test Case | Audio |
|------------|--------|-----------|-------|
| sim_abc123 | COMPLETED | tc_xyz | Yes |
| sim_def456 | FAILED | tc_uvw | No |

### Failed Simulations
- sim_def456: "Connection timeout"

### View Details
`coval simulations get <sim_id>`

### Download Audio
`coval simulations audio <sim_id> -o output.wav`
```

## Filtering

List simulations with filters:

```bash
coval simulations list --run-id <run_id> --filter "status=FAILED"
coval simulations list --run-id <run_id> --filter "has_audio=true"
```