agent build

skills/executive-summary.md

@@ -0,0 +1,81 @@
+---
+id: executive-summary
+name: Executive Summary
+description: The whole workspace in one reading — positions, candidates, hires, talent and attendance.
+category: analytics
+pages:
+  - control-center
+status: active
+version: 1
+triggers:
+  - executive summary
+  - workspace summary
+  - overall summary
+  - state of the workspace
+  - brief me
+owliver:
+  enabled: true
+  suggestions:
+    - label: Give me an executive summary
+      capability: summary
+    - label: Show the headline figures
+      capability: stats
+  capabilities:
+    - summary
+    - stats
+    - card
+    - table
+    - insight
+  responses:
+    summary:
+      title: Workspace summary
+      source: workspace.summary
+    stats:
+      title: Workspace summary
+      source: workspace.summary
+    card:
+      title: Workspace summary
+      source: workspace.summary
+    table:
+      title: Workspace summary
+      source: workspace.summary
+    insight:
+      title: Workspace summary
+      source: workspace.summary
+---
+
+# Executive Summary
+
+## Purpose
+
+- Give a management-level reading of the whole workspace in one answer.
+- Draw every figure from the source that owns it, so the summary cannot drift
+  from the pages it summarizes.
+
+## Capabilities
+
+- Report open roles, candidates, hires, talent pool size, attendance and logged events.
+
+## Data
+
+Reads `workspace.summary`, which counts `JobPosting`, `JobApplication`, `Staff`,
+`WorkerProfile`, `UserActivity` and `ShiftRecord`.
+
+## Analysis
+
+Each figure is read from the domain that owns it rather than recomputed here. A
+domain with no records contributes a zero and says so in its detail line — the
+summary reports what is there, including an absence.
+
+## Output
+
+Six headline figures: open roles, candidates, hires, talent pool, attendance
+rate and events logged, each with a supporting detail.
+
+## Limitations
+
+- This is a count, not a diagnosis. Which figures are a problem is what Staffing
+  Risk, Operational Risk and Anomaly Detection answer.
+- Attendance is 0 where no shifts have been recorded, and the detail line says
+  so rather than implying nobody turned up.
+- No trend or comparison to a previous period is included.