Report Generator

Report Generator

This skill helps you create professional influencer marketing reports that tell the story of your campaign performance. It adapts content and depth based on the audience.

> Cross-discipline (paid ads): this is also the paid-ads reporting surface — build exec/client/channel reports from RQS history (memory/audits/ad/) and measurement-loop readback verdicts. It presents metrics; it does not compute them (return math stays in roi-calculator). Save paid runs under memory/ad/report-generator/.

Quick Start

Shortest invocation:

Create a campaign report for [campaign name] for [audience: executive/client/team]

Common scenario:

Generate an executive summary for our Q3 influencer campaigns

Skill Contract

• Reads: campaign name, reporting period, target audience, and computed metrics (reach, engagement, conversions, spend, revenue, ROI/ROAS, per-influencer results). Prior outputs from performance-analyzer and roi-calculator if available.
• Writes: a finished report in the audience-appropriate template, saved to memory/influencer/report-generator/YYYY-MM-DD-<topic>.md.
• Promotes: durable verdicts (final ROI/ROAS, top performers, renew/drop calls, headline learnings) to memory/hot-cache.md.
• Done when:
• The report matches the requested audience template (executive, client, team, or board).
• Every metric is paired with context (target, benchmark, or prior period).
• The report ends with concrete recommendations and, where relevant, action items.
• Primary next skill: content-quality-auditor

Handoff Summary

> Emit the standard shape from skill-contract.md §Handoff Summary Format.

Data Sources

This family ships Tier 1: every step works with no live integration. Give the skill the campaign metrics directly and it builds the report from your inputs.

Optional connectors that can pre-fill data where available:

• ~~social platform analytics — reach, impressions, engagement, video views per post
• ~~influencer database — creator handles, tiers, fees, audience demographics
• ~~analytics — link clicks, conversions, attributed revenue
• ~~CRM — new-customer counts and downstream revenue

Without any of these, the skill asks you for the numbers and proceeds. See CONNECTORS.md for the free/keyless data recipe per category.

Instructions

When a user requests a report:

• Determine report parameters — set report type (post-campaign/monthly/quarterly/annual), campaign(s), period, and audience. Match depth to the audience: executive wants ROI and strategy at a high level; client wants results and value; team wants detailed learnings and optimization; board wants business impact. See the audience-needs matrix in report-templates.md.

• Pick the audience template and fill it in — full executive, client, and internal-team templates live in report-templates.md. Pull metrics from performance-analyzer and roi-calculator outputs when present; otherwise ask the user for the numbers. Pair every metric with context (target, benchmark, or prior period).

• Apply visualization and writing guidance — choose the right chart per data point and per audience, and follow the lead-with-outcomes narrative arc. See the visualization recommendations and writing best practices in report-templates.md.

• Close with recommendations and action items — end every report with concrete next steps; add an owner/deadline action-items table for team and board audiences.

• Save and promote — write the finished report to memory/influencer/report-generator/YYYY-MM-DD-<topic>.md (paid runs to memory/ad/report-generator/). Promote durable verdicts (final ROI/ROAS, top performers, renew/drop calls, headline learnings) to memory/hot-cache.md.

Example

User: "Create an executive report for our holiday campaign: $50K spend, $165K revenue, 3.5M reach across 15 influencers"

Output (excerpt — full template in report-templates.md):

# Holiday Campaign 2024: Executive Summary

## Bottom Line: Campaign Exceeded All Targets ✅

**ROI: 230%** | **ROAS: 3.3:1** | **Revenue: $165,000**

| Metric | Target | Actual | Status |
|--------|--------|--------|--------|
| Revenue | $100K | $165K | ✅ +65% |
| ROAS | 2:1 | 3.3:1 | ✅ +65% |
| Reach | 2M | 3.5M | ✅ +75% |

### Recommendation

Increase Q1 influencer budget by 25%, focused on TikTok micro-influencers and product-demo content.

Reference Materials

• report-templates.md — full executive/client/team templates, visualization recs, writing best practices, worked example
• skill-contract.md — shared contract and handoff format
• state-model.md — memory tiers and save-path convention
• CONNECTORS.md — free/keyless data recipes per connector category
• performance-analyzer — generates the metrics this report consumes
• roi-calculator — supplies ROI/ROAS figures
• campaign-planner — original plan to compare results against
• content-amplifier — amplification results to report on
• content-quality-auditor — quality gate for the report itself

Next Best Skill

Primary: content-quality-auditor — run the finished report through the publish-readiness gate before it goes to a stakeholder.

Alternates (same report phase / influencer family):

• performance-analyzer — if the report exposes data gaps, re-analyze before re-reporting.
• roi-calculator — recompute return figures if the financial inputs changed.

Termination note (visited-set): if a recommended skill has already been invoked this session, stop and report the chain as complete instead of re-running it. Honor a max chain depth of 3 hops to avoid loops.