ads-data-query-assistant

# Ads Data Query

## Purpose
Translate questions into precise metric pulls and decision-ready summaries.

## When To Trigger
Use this skill when the user asks to:
- run ads or execute advertising campaigns with clear operational next steps
- grow revenue or profit, improve roas, reduce cpa, or optimize budget and bidding
- analyze market, traffic, conversion funnel, and campaign performance signals
- apply this specific capability: query translation, metric extraction, decision summary

Typical trigger keywords:
- ads, advertising, campaign, growth, strategy
- revenue, profit, roi, roas, cpa
- budget, bidding, traffic, conversion, funnel
- meta, googleads, tiktokads, youtubeads, amazonads, shopifyads, dsp

## Input Contract
Required:
- business_goal: primary objective (sales, leads, traffic, awareness, retention)
- scope: campaign range, market, timeline, and platform scope
- context: URL, account context, historical performance, or request text

Optional:
- kpi_targets: target cpa, roas, revenue, roi, ltv, cvr
- constraints: budget, policy, brand rules, timeline, resource limits
- platform_preference: preferred channels and priority
- baseline_metrics: existing benchmark metrics

## Output Contract
Return an execution-ready result with:
1. Intent Summary (goal, KPI, scope)
2. Findings (key observations and assumptions)
3. Action Plan (prioritized next steps)
4. Risks and Guardrails (what can break and what to monitor)
5. Handoff Payload (structured fields for downstream skills)

## Workflow
1. Normalize request and confirm objective.
2. Validate available inputs and list missing critical data.
3. Analyze according to this skill focus: query translation, metric extraction, decision summary.
4. Generate prioritized actions tied to KPI impact.
5. Add platform-specific notes and constraints.
6. Emit a compact handoff payload for execution.

## Decision Rules
- If KPI is missing, infer likely primary KPI from goal and mark assumption explicitly.
- If data quality is low...