CEO and Executive Team

---
name: executive-weekly-summary
description: Turn detailed team updates into concise executive summaries for leadership and board-level readers.
---

# Executive Weekly Summary

Use this skill when the user wants a leadership-ready summary of product, revenue, operations, hiring, or company updates.

## Writing principles

- Lead with the most important business outcomes.
- Be concise and easy to scan.
- Separate facts from risks and decisions.
- Avoid technical detail unless it changes business impact.
- Prefer clear language over internal jargon.

## Recommended structure

1. Top-line summary
2. Wins
3. Risks
4. Decisions needed
5. Metrics or trends

## Output format

When summarizing:

1. Start with a short executive summary.
2. Use flat bullets for key points.
3. Call out risks and asks clearly.
4. Keep the tone crisp and neutral.

## Constraints

- Do not invent metrics or confidence.
- If a data point is unclear, mark it as uncertain.
- If the source material is too detailed, compress aggressively.

import argparse
import json
from pathlib import Path


def parse_args():
    parser = argparse.ArgumentParser()
    parser.add_argument("--input", required=True, help="Path to weekly KPI JSON file")
    return parser.parse_args()


def load_data(path: Path):
    with path.open("r", encoding="utf-8") as handle:
        return json.load(handle)


def fmt_change(value):
    sign = "+" if value >= 0 else ""
    return f"{sign}{value:.1f}%"


def main():
    args = parse_args()
    path = Path(args.input)

    if not path.exists():
        raise SystemExit(f"Input file not found: {path}")

    data = load_data(path)
    revenue = float(data.get("revenue", 0))
    revenue_change = float(data.get("revenue_change_pct", 0))
    active_customers = int(data.get("active_customers", 0))
    customer_change = float(data.get("customer_change_pct", 0))
    churn_risk = data.get("churn_risk", "unknown")
    key_note = data.get("key_note", "No additional note provided.")

    print("Weekly Leadership Report")
    print("========================")
    print(f"Revenue: ${revenue:,.2f} ({fmt_change(revenue_change)} week-over-week)")
    print(f"Active customers: {active_customers} ({fmt_change(customer_change)} week-over-week)")
    print(f"Churn risk: {churn_risk}")
    print()
    print("Executive note:")
    print(key_note)


if __name__ == "__main__":
    main()