Weekly Executive Digest

What it does

Produce a highly concise weekly executive update comparing the latest result snapshots against prior snapshots, highlighting key deltas, positives, risks, and next steps.

Execution Contract

Every execution of this skill must operate under the following contract:
- **ingestion_plan**: A documented plan for pulling data.
- **max_api_calls**: 3 (default, strictly enforced).
- **cache_key**: A unique key identifying the cached API dataset.
- **dataset_timestamp**: ISO timestamp of the ingested dataset.
- **analysis_mode**: `offline_only`

Data Access Policy

• API Target: Consume data from the FullMention API at GET /v2/runs/{runId}.
• Controlled Ingestion: Perform exactly one controlled ingestion pull from the FullMention API. Paginated batch fetching is preferred.
• API Decoupling: Do NOT treat the FullMention API as a persistent database or state-store; it is a read-only snapshot provider.
• 24-Hour TTL: FullMention v2 deletes run data after 24 hours, meaning offline persistence/database caching is a strict requirement for historical tracking.
• Local Persistence: Save all analytical outputs locally in the current workspace directory.
  • Raw structured JSON must be saved to [skill_name].json (e.g. weekly-executive-digest.json).
  • A premium, beautifully styled markdown report must be saved to [skill_name].md (e.g. weekly-executive-digest.md).
• Caching: Reuse the same stored dataset across iterative prompts. Do not repeat identical API calls.
• Refresh Window: Make additional API calls only if the user explicitly requests a refresh window or a missing page fetch.
• Rate Limits & Backoff: Respect API rate limits and backoff policies. Never run open-ended call loops.
• Allowed Sources:
  • Local working dataset produced from one ingestion pull of FullMention API data.
  • Optional user-provided local file/DB snapshot (read-only).
  • No repeated API fetching during analysis.

Required Input Fields & Parameters

The input dataset from the API/file must map to these fields:

• updatedAt (string, ISO-8601 timestamp of snapshot update)
• keyword (string, searched keyword)
• brandRankings[].name (string, brand name)
• brandRankings[].position (integer, brand rank position)
• websiteRankings[].domain (string, domain name)
• websiteRankings[].position (integer, domain rank position)
• productRankings[].name (string, product name)
• productRankings[].position (integer, product rank position)

Analytical Method

Follow these step-by-step logic rules during analysis:

1. Delta Calculation: Compare the latest snapshot metrics against the immediate prior snapshot in the dataset to calculate:
   • SOV Change: Brand Share of Voice percentage shifts.
   • Rank Wins/Losses: Direct position changes for monitored brands.
   • Citation Concentration: Variations in the distribution of recommended websites/domains.
   • Product Visibility Change: Direct position changes and entry/exit of monitored products in productRankings[].
2. Impact Selection: Identify and classify:
   • Highlights: Top positive performance deltas and strategic opportunities.
   • Risks: Notable decreases in SOV, rank losses, or rising competitor momentum.
3. Action Projections: Formulate actionable next steps designed to capitalize on highlights or mitigate identified risks.

Expected Output

The skill must generate two outputs in the local workspace:

1. weekly-executive-digest.json: Contains the raw structured analytical output, including the execution contract metadata, deltas, selected highlights, risks, next actions, confidence metrics, and the evidence map.

2. weekly-executive-digest.md: A premium, beautiful human-readable report. This report must contain:

   • Headline: A brief, high-impact executive summary statement.
   • KPI Delta Block: A visual block/table displaying key metric changes (e.g. Metric | Current | Delta | Status).
   • Highlights, Risks & Next Actions:
     • Highlights: Key positive accomplishments or positive shifts.
     • Risks: Critical threats or negative trends.
     • Next Actions: Actionable recommendations.
   • Confidence & Limitations:
     • A confidence score from 0-100.
     • Confidence Rationale: Explanation of how the confidence score was derived.
     • Limitations: A list of data limitations or gaps.
   • Evidence Map: An array of objects evidence_map[] with:
     • finding_id
     • metric_name
     • source_field_paths[]
     • sample_result_ids[]

Guardrails & Constraints

• Evidence-Based and Concise: Keep the analysis extremely concise, focused, and directly supported by data.
• Traceable Deltas Only: Every claim, highlight, or risk must be directly traceable to a calculated delta in the dataset. Do not make assumptions or claims without explicit data backing.
• No Web Lookups: Do not perform external web lookups or enrichment of brand data.
• No Hallucination: Do not invent brands, rankings, websites, or hidden fields that are not present in the ingested dataset.

Copy-ready Skill Prompt

Use this as a full copy/paste prompt in your AI tool:

Skill: Weekly Executive Digest
Goal: Produce a short executive update from latest vs prior snapshots.

Data Access Policy:
- **API Target**: Consume data from the FullMention API at `GET /v2/runs/{runId}`.
- **Controlled Ingestion**: Perform exactly one controlled ingestion pull from the FullMention API. Paginated batch fetching is preferred.
- **API Decoupling**: Do NOT treat the FullMention API as a persistent database or state-store; it is a read-only snapshot provider.
- **24-Hour TTL**: FullMention v2 deletes run data after 24 hours, meaning offline persistence/database caching is a strict requirement for historical tracking.
- **Local Persistence**: Save all analytical outputs locally in the current workspace directory.
  - Raw structured JSON must be saved to `[skill_name].json` (e.g. `weekly-executive-digest.json`).
  - A premium, beautifully styled markdown report must be saved to `[skill_name].md` (e.g. `weekly-executive-digest.md`).
- **Caching**: Reuse the same stored dataset across iterative prompts. Do not repeat identical API calls.
- **Refresh Window**: Make additional API calls only if the user explicitly requests a refresh window or a missing page fetch.
- **Rate Limits & Backoff**: Respect API rate limits and backoff policies. Never run open-ended call loops.
- **Allowed Sources**:
  - Local working dataset produced from one ingestion pull of FullMention API data.
  - Optional user-provided local file/DB snapshot (read-only).
  - No repeated API fetching during analysis.

Input Fields & Params:
The input dataset from the API/file must map to these fields:
- `updatedAt` (string, ISO-8601 timestamp of snapshot update)
- `keyword` (string, searched keyword)
- `brandRankings[].name` (string, brand name)
- `brandRankings[].position` (integer, brand rank position)
- `websiteRankings[].domain` (string, domain name)
- `websiteRankings[].position` (integer, domain rank position)
- `productRankings[].name` (string, product name)
- `productRankings[].position` (integer, product rank position)

Method:
Follow these step-by-step logic rules during analysis:
1. **Delta Calculation**: Compare the latest snapshot metrics against the immediate prior snapshot in the dataset to calculate:
   - **SOV Change**: Brand Share of Voice percentage shifts.
   - **Rank Wins/Losses**: Direct position changes for monitored brands.
   - **Citation Concentration**: Variations in the distribution of recommended websites/domains.
   - **Product Visibility Change**: Direct position changes and entry/exit of monitored products in `productRankings[]`.
2. **Impact Selection**: Identify and classify:
   - **Highlights**: Top positive performance deltas and strategic opportunities.
   - **Risks**: Notable decreases in SOV, rank losses, or rising competitor momentum.
3. **Action Projections**: Formulate actionable next steps designed to capitalize on highlights or mitigate identified risks.

Expected Output:
The skill must generate two outputs in the local workspace:

1. **`weekly-executive-digest.json`**:
   Contains the raw structured analytical output, including the execution contract metadata, deltas, selected highlights, risks, next actions, confidence metrics, and the evidence map.

2. **`weekly-executive-digest.md`**:
   A premium, beautiful human-readable report. This report must contain:
   - **Headline**: A brief, high-impact executive summary statement.
   - **KPI Delta Block**: A visual block/table displaying key metric changes (e.g. `Metric | Current | Delta | Status`).
   - **Highlights, Risks & Next Actions**:
     - **Highlights**: Key positive accomplishments or positive shifts.
     - **Risks**: Critical threats or negative trends.
     - **Next Actions**: Actionable recommendations.
   - **Confidence & Limitations**:
     - A confidence score from 0-100.
     - **Confidence Rationale**: Explanation of how the confidence score was derived.
     - **Limitations**: A list of data limitations or gaps.
   - **Evidence Map**: An array of objects `evidence_map[]` with:
     - `finding_id`
     - `metric_name`
     - `source_field_paths[]`
     - `sample_result_ids[]`

Guardrails:
- **Evidence-Based and Concise**: Keep the analysis extremely concise, focused, and directly supported by data.
- **Traceable Deltas Only**: Every claim, highlight, or risk must be directly traceable to a calculated delta in the dataset. Do not make assumptions or claims without explicit data backing.
- **No Web Lookups**: Do not perform external web lookups or enrichment of brand data.
- **No Hallucination**: Do not invent brands, rankings, websites, or hidden fields that are not present in the ingested dataset.