agent build

skills/learning-analysis.md

@@ -0,0 +1,80 @@
+---
+id: learning-analysis
+name: Learning Analysis
+description: Report what the training library holds and how far the workforce has progressed through it.
+category: workforce
+pages:
+  - krow-forge
+status: active
+version: 1
+triggers:
+  - learning analysis
+  - training progress
+  - course progress
+  - training library
+  - what training
+owliver:
+  enabled: true
+  suggestions:
+    - label: How is training progressing?
+      capability: progress
+    - label: What does the library hold?
+      capability: list
+  capabilities:
+    - summary
+    - progress
+    - list
+    - table
+    - stats
+  responses:
+    summary:
+      title: Training progress
+      source: workforce.training
+    progress:
+      title: Training progress
+      source: workforce.training
+    list:
+      title: Training paths
+      source: workforce.training
+    table:
+      title: Training paths
+      source: workforce.training
+    stats:
+      title: Training progress
+      source: workforce.training
+---
+
+# Learning Analysis
+
+## Purpose
+
+- Report what the training library holds.
+- Report how far the workforce has progressed against it.
+
+## Capabilities
+
+- Summarize training paths and progress against them.
+- List or tabulate the paths in the library.
+
+## Data
+
+Reads `workforce.training`, the existing source behind the Forge progression
+views.
+
+## Analysis
+
+Progress is counted against the paths the library actually defines, so adding a
+path changes the denominator rather than being reported as a sudden fall in
+completion.
+
+## Output
+
+Training paths with progress against each.
+
+## Limitations
+
+- A skill in Forge is something a person learns and is verified in. It is not an
+  Owliver capability, and the two must not be described as the same thing.
+- Progress is personal to the signed-in worker where their record is loaded, and
+  library-level otherwise.
+- This reports progression, not whether the training is any good.