About get-results
A Coval skill for retrieving and summarizing simulation results by run or simulation ID. It reports statuses, test cases, transcripts, audio availability, and failure details, with filters for failed or audio-enabled simulations.
Key features
- 01List simulations for a run
- 02Retrieve simulation details
- 03Review status and test case
- 04Inspect transcript and timestamps
- 05Check audio availability and errors
- 06Filter by status or audio
Use cases
- 01Summarize simulations belonging to a run
- 02Investigate a failed simulation
- 03Find simulations with available audio
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ coval-ai/ coval-external-skills --skill get-resultsAfter installing, type/get-resultsin Claude Code to confirm it loaded.
Details
From the project READMEGet Simulation Results
Retrieve results for $ARGUMENTS.
Workflow
If Run ID Provided
List all simulations for the run:
coval simulations list --run-id <run_id> --format json
If Simulation ID Provided
Get detailed simulation data:
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:
coval simulations list --run-id <run_id> --filter "status=FAILED"
coval simulations list --run-id <run_id> --filter "has_audio=true"
Comments
Markdown supported