SKILL.md

---
name: damoov-mcp-breakdown
description: Breaks down Damoov fleet and driving metrics by an approved dimension or ranks top contributors. Use when a user asks for daily detail, trip-type composition, event categories, drivers, trips, segments, or top contributors.
---

# Damoov metric breakdown

Use the Damoov Telematics MCP tools.

## Workflow

1. Resolve the company with `list_companies`.
2. Call `list_metrics` to confirm the metric supports the requested dimension.
3. For grouped analysis, call `breakdown_by` with a limit no greater than 50.
4. For ranked driver or trip entities, call `get_top_contributors` with a limit no greater than 50.
5. Report the dimension, period, filters, returned rows, and whether the result was truncated.

## Rules

- Use only dimensions and entity types advertised by `list_metrics`.
- If `truncated=true`, state that additional rows exist; do not present the output as complete.
- For a daily breakdown, preserve ascending date order.
- Do not combine pages or periods in ways that change the requested metric semantics.
- Never expose raw SQL, database schema, credentials, tokens, or internal identifiers beyond tool output.
- Avoid `active_drivers`; it has a known timeout limitation.