Skip to main content

In this article

engagement-reporting

engagement-reporting
FieldValue
Kindskill
Source.github/skills/engagement-reporting/engagement-reporting
InvocationInvoked directly as /engagement-reporting, or loaded on demand by referencing agents
InteractiveNo

What it does​

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

When to use it​

Use this skill to create source-grounded weekly engagement reports. It is suitable for M365-only reporting and can also normalize optional Azure DevOps, or GitHub board evidence.

Use the Engagement Report Generator when a user needs the complete interactive coordination experience. Do not use this skill to publish reports or send email.

Set up the workspace​

Copy the packaged configuration template to the root of the engagement workspace:

cp .github/skills/engagement-reporting/engagement-reporting/assets/engagement.template.yaml \
  engagement.yaml

Edit engagement.yaml with the engagement identity, stakeholders, source locations, and optional distribution settings. Add these local and potentially sensitive paths to the workspace .gitignore before running a report:

/engagement.yaml
/.working/
/reports/
/transcripts/

The HVE Core installer installs the template with the skill but does not create the workspace configuration or modify .gitignore. Keep these paths at the engagement workspace root; do not place customer report data inside the packaged skill directory.

Example usage​

/engagement-reporting weekly August 17-21

With a valid engagement.yaml, the skill discovers configured sources, normalizes evidence, enforces coverage and verification gates, drafts against the selected template, applies review, and returns approved report artifacts. Optional Outlook distribution creates a draft only after separate approval. The agent renders the approved report as HTML inline and uses the dedicated WorkIQ Mail MCP CreateDraftMessage operation. If the WorkIQ Mail MCP server is unavailable or conversion cannot preserve required structures, including tables, distribution stops instead of flattening the report.