# Engagement Reporting

Creates source-grounded internal or external weekly engagement status reports with...

- Repository: https://github.com/microsoft/hve-core (1591 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add microsoft/hve-core --skill engagement-reporting -g -a claude-code -y`
Codex: `npx skills add microsoft/hve-core --skill engagement-reporting -g -a codex -y`
Cursor: `npx skills add microsoft/hve-core --skill engagement-reporting -g -a cursor -y`
Gemini CLI: `npx skills add microsoft/hve-core --skill engagement-reporting -g -a gemini-cli -y`

## Description

Creates source-grounded internal or external weekly engagement status reports with optional Outlook draft creation.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# engagement-reporting

## Goal

Produce an audience-calibrated engagement report whose factual claims trace to
primary sources. Preserve source coverage, review decisions, and retention
state without publishing or sending the report.

This skill and its bundled references are the single runtime authority whether
the skill is invoked directly or through the Engagement Report Generator. A
parent may coordinate interaction, state, and bounded subagent dispatch, but it
must not replace or restate this workflow.

Read the bundled references when entering their phase:

* [Research contract](references/research.md) for source discovery, WorkIQ
  retrieval, board normalization, and coverage gates
* [Report contract](references/report-contract.md) for synthesis, traceability,
  review, output, and talk tracks
* [Distribution contract](references/distribution.md) for optional Outlook
  draft creation

Use the [engagement template](assets/engagement.template.yaml) to scaffold
engagement configuration and the
[weekly standard template](assets/weekly-standard.yaml) for the default weekly
report contract. Render Outlook draft bodies as faithful HTML; never manually
flatten Markdown or substitute plain text.

## Flow

The rest: https://github.com/microsoft/hve-core/blob/HEAD/.github/skills/engagement-reporting/engagement-reporting/SKILL.md