SKILL.md

---
name: damoov-mcp-compare-periods
description: Compares Damoov fleet or driving metrics between two periods and explains the change. Use when a user asks for period-over-period change, trends, increases, decreases, or reasons for a metric difference.
---

# Damoov period comparison

Use the Damoov Telematics MCP tools.

## Workflow

1. Resolve the company with `list_companies`.
2. Use `list_metrics` if the metric ID or supported periods are unclear.
3. Confirm two non-overlapping periods when the user's wording is ambiguous.
4. Call `compare_periods`.
5. When the metric supports it and the user asks why it changed, call `explain_change`.
6. Report:
   - base-period value;
   - comparison-period value;
   - absolute delta;
   - percentage change when available;
   - exact period boundaries;
   - non-causal change components when returned.

## Rules

- Treat delta as comparison value minus base value.
- Describe `explain_change` output as non-causal components, not proven causes.
- Never invent missing data or infer unsupported causality.
- Keep the company and filters identical across both periods unless the user explicitly requests otherwise.
- Do not expose raw SQL, credentials, tokens, or database schema.
- Avoid `active_drivers`; it has a known timeout limitation.