Adtech / Analytics Engineering

Weekly Performance Review BI

Chain dashboard generation, QA gating, and executive narrative writing for deterministic weekly BI reporting.

DocumentationAgent instructionsRequirements & limits

Use when weekly BI reporting needs deterministic orchestration across dashboard generation, QA, and narrative drafting.

Inputs

  • normalized_performance_table with standardized marketing metrics.
  • source_totals and data timestamps for QA.
  • metric_dictionary and QA rule thresholds.
  • audience profile for executive summary tone.
  • reporting windows: current period and comparison period.

Outputs

  • Publish decision
  • QA package
  • Narrative package

Before you begin

  • Reading and copying the procedure require no terminal setup. Check requirements for any packaged programs separately.

Try this first

Read the procedure and supply its documented inputs. Use the full text in an agent app or chat that supports pasted instructions, following that host's guidance.

Limits for this step
  • Instruction package only; it does not provide or authorize an executable runtime capability.
  • Safe for orchestrating read-only reporting steps; require human approval before external publication.
Read full instructionsHide full instructionsSKILL.md · v0.1.0

Weekly Performance Review BI

When to use

  • Use for recurring weekly performance marketing reporting with BI publish gates.
  • Use when output must follow a fixed structure across runs.
  • Use when reporting must stop automatically on critical data-quality failures.

Inputs required

  • normalized_performance_table with standardized marketing metrics.
  • source_totals and data timestamps for QA.
  • metric_dictionary and QA rule thresholds.
  • audience profile for executive summary tone.
  • reporting windows: current period and comparison period.

Workflow

  1. Run dashboard-generator on normalized data.
  2. Validate dashboard-generator output schema and required sections.
  3. Run dashboard-qa-checker against source totals, freshness, completeness, reconciliation, anomaly rules, and schema drift.
  4. If QA result is blocked, stop workflow and return QA package plus alert payload.
  5. If QA result is approved, run executive-narrative-writer with QA-approved dashboard output.
  6. Return consolidated package with publish decision, dashboard sections, and executive narrative.

Output format

  • Run Metadata: run_id, reporting windows, execution timestamp.
  • Publish Decision: approved or blocked with reasons.
  • Dashboard Package: executive summary, channel table, anomaly panel, action panel, publish payload.
  • QA Package: summary, check results, blocking reasons, alert payload.
  • Executive Narrative: headline, concise summary, driver breakdown, risks, next actions.

Guardrails

  • Never run executive narrative step when QA status is blocked.
  • Never override a critical QA failure without explicit user approval.
  • Preserve metric definitions and output schema contracts across all steps.
  • Keep section order stable so BI consumers receive deterministic outputs.
View file metadata
---
name: weekly-performance-review-bi
description: Orchestrate end-to-end weekly BI performance reporting by chaining dashboard generation, QA validation, and executive narrative writing. Use when teams need a deterministic weekly workflow that blocks publish on critical data-quality failures and only produces leadership summaries after QA approval.
---

Summary sources · Catalogue metadata, skill.yaml, SKILL.md, examples/input.json, examples/output.json · v0.1.0 · Release package

Install instruction files

These commands copy guidance into the selected runtime directories. Confirm that your agent app discovers it. Any packaged programs need separate setup and verification.

Install (Codex)

./bin/skills-hub install adtech/[email protected] --runtime codex

Install (Claude)

./bin/skills-hub install adtech/[email protected] --runtime claude

Install (Generic)

./bin/skills-hub install adtech/[email protected] --runtime generic --target ./my-agent/skills

How You Can Use This

Documentation

Resource form: Agent instructions

Read or copy the guidance. Any packaged programs have separate execution requirements and evidence.

First run: Read SKILL.md and follow the documented workflow.

Current limits

  • Instruction package only; it does not provide or authorize an executable runtime capability.
What installation and verification mean
File installation
Places package files and generated configuration in the selected directories.
Native discovery
Your agent app finds and accepts the instructions, tools or plugin registrations.
Mock execution
Exercises sample fixtures. Connected data and provider effects need a separate check.
Connected operation
Requires current configuration, provider authentication, scoped permissions and a successful operation in your intended environment.

Declared compatibility

Compatibility unknown: versions and capabilities have not been declared.

Classification: declared

Technical details and release files

Operational Summary

Execution mode: analysis-only

Approval boundary: Safe for orchestrating read-only reporting steps; require human approval before external publication.

Review and lifecycle

Review maturity: Experimental

Security review declaration: Not declared

Lifecycle: Active

These release declarations are separate from evidence that a workflow operates in your environment.

Runtime & Dependencies

ID: adtech/weekly-performance-review-bi

Tags: bi, orchestration, weekly-reporting, qa-gating, dashboard

Runtimes: codex, claude, generic

Tool dependencies: 1

API dependencies: 0

Dependencies

Tools: python3

APIs: Not documented

Outputs

  • Publish decision
  • QA package
  • Narrative package