Training Completion Tracking
Overview
Training completion is the leading indicator for the human-layer side of
security posture: an org whose users are behind on required training is an
org whose users are more likely to fall for the next real phishing attempt.
This skill covers how to pull training-campaign completion state across
whatever security-awareness platform is connected, turn it into a per-org
completion rate, and flag clients falling behind their contracted cadence —
without assuming a specific vendor's data model.
Anti-triggers
- Running a KnowBe4 campaign — creating campaigns, enrolling users,
browsing the content library, or buying store modules is the vendor's API
surface; use
knowbe4-training.
- KnowBe4's own completion reports and benchmarks — the platform
computes those natively per account; use
knowbe4-reporting. This skill
exists for the portfolio rollup and the cadence judgment across whatever
platform is connected.
Step Zero: Confirm What's Connected
Call conduit__search_tools with a query like "training campaign" or
"training completion" before assuming a specific vendor is available.
KnowBe4 is the primary training/phishing-simulation platform in this
marketplace and, where connected, is the strongest source for this skill —
it exposes campaign-level enrollment and completion data directly (e.g.
knowbe4__list_users, knowbe4__list_campaigns). Proofpoint and Checkpoint
Avanan both carry secondary awareness/phishing-simulation features alongside
their core email-security function; where connected, treat them as
additional or corroborating sources, not a replacement for a dedicated
training platform. If no training/awareness connector is found for a
client, say so explicitly rather than reporting a completion rate of 0% —
"unmeasured" and "0% complete" are very different findings and must not be
conflated.
Key Concepts
What "overdue" means
A user or org is overdue when a training assignment has passed its due date
without a completion recorded, or when the org has no active/recent campaign
covering a training requirement that a defined cadence calls for. Distinguish
between:
- Assignment overdue — a specific training module or campaign was
assigned to a user with a due date, and that date has passed with no
completion recorded. This is the clearest, most defensible overdue signal
when the platform exposes due dates.
- Cadence overdue — no assignment exists at all, but the org's
contracted or expected cadence (e.g. "quarterly phishing simulation,
annual awareness module") implies one should have run by now. This
requires knowing the cadence — pull it from documentation (IT Glue/Hudu),
the PSA contract, or ask, rather than inventing a default cadence and
presenting it as fact. If no cadence is known, report completion status
without an overdue judgment and say why.
Per-org completion rate
Completion rate = completed assignments / total assignments for the
relevant campaign or requirement, per org. Report this per campaign as well
as an org-level rollup across all active campaigns — a single blended
percentage can hide the difference between "everyone did the quarterly
phishing sim" and "nobody did the annual compliance module."
Flagging clients falling behind cadence
- Establish the expected cadence per client, where known (contract terms,
documentation, or explicit user input). If unknown, do not assume a
default — flag cadence as unconfirmed for that client.
- Compare the most recent completed campaign date (or, for a
currently-running campaign, its due date) against the expected cadence
interval.
- Flag any client whose most recent relevant campaign is older than the
cadence interval, or who has no campaign of that type at all in the
connected platform's history.
- Rank flagged clients by how far past cadence they are, not just a binary
flag — a client 400 days overdue on annual training is a different
priority than one 20 days overdue.
Common Workflows
Portfolio-wide overdue sweep
- Discover the connected training platform(s) via
conduit__search_tools.
- For each client (or org/group, depending on the platform's tenancy
model), pull active and recent campaigns and per-user completion status.
- Compute per-org completion rate per campaign, and flag any user with an
assignment past its due date.
- Where cadence is known, flag clients whose most recent relevant campaign
predates the expected interval.
- Present clients with zero connected training tooling as unmeasured,
separate from — not blended into — the ranked overdue list.
Single-client training snapshot
- Resolve the client against the connected platform's org/group model.
- Pull all campaigns scoped to that client and completion status per user.
- Report completion rate per campaign, list of overdue users by name (or
ID if names aren't exposed), and cadence status if known.
Error Handling
No training/awareness connector found
State plainly that no training-completion data is available — do not report
a 0% completion rate, which implies data was checked and everyone failed.
"No security-awareness training platform connected for this client" is the
correct output.
Connector present but campaign has no due dates
Report completion rate without an "overdue" classification for that
campaign, and note that overdue detection requires due-date data the
platform didn't return for this campaign.
Cadence unknown
Report completion status without a cadence-compliance verdict, and note
explicitly that cadence wasn't available (documentation, contract, or user
input) rather than assuming a default like "quarterly."
Best Practices
- Tool names follow
<vendor-slug>__<tool_name> (e.g.
knowbe4__list_campaigns) — discover them via conduit__search_tools
rather than guessing.
- Where Proofpoint or Avanan phishing-simulation data is available
alongside KnowBe4, note it as corroborating context in this skill, but
hand off correlation with real-world click data to the
phishing-simulation-analysis skill rather than duplicating that logic
here.
Related Skills
- Phishing Simulation Analysis —
click-rate trends and repeat-clicker identification, the companion metric
to training completion.
- Risk Scoring — combines this skill's
completion data with phishing-simulation performance into a single
explainable per-user/per-org risk score.
1---2name: training-completion-tracking3description: Security-awareness training completion across whatever training/awareness platform is connected: assignment-overdue versus cadence-overdue detection, per-campaign and per-org completion-rate calculation, ranking clients that have fallen behind a contracted cadence, and the unmeasured-versus-0% distinction.4---56# Training Completion Tracking78## Overview910Training completion is the leading indicator for the human-layer side of11security posture: an org whose users are behind on required training is an12org whose users are more likely to fall for the next real phishing attempt.13This skill covers how to pull training-campaign completion state across14whatever security-awareness platform is connected, turn it into a per-org15completion rate, and flag clients falling behind their contracted cadence —16without assuming a specific vendor's data model.1718## Anti-triggers1920- **Running a KnowBe4 campaign** — creating campaigns, enrolling users,21 browsing the content library, or buying store modules is the vendor's API22 surface; use `knowbe4-training`.23- **KnowBe4's own completion reports and benchmarks** — the platform24 computes those natively per account; use `knowbe4-reporting`. This skill25 exists for the portfolio rollup and the cadence judgment across whatever26 platform is connected.2728## Step Zero: Confirm What's Connected2930Call `conduit__search_tools` with a query like `"training campaign"` or31`"training completion"` before assuming a specific vendor is available.32KnowBe4 is the primary training/phishing-simulation platform in this33marketplace and, where connected, is the strongest source for this skill —34it exposes campaign-level enrollment and completion data directly (e.g.35`knowbe4__list_users`, `knowbe4__list_campaigns`). Proofpoint and Checkpoint36Avanan both carry secondary awareness/phishing-simulation features alongside37their core email-security function; where connected, treat them as38additional or corroborating sources, not a replacement for a dedicated39training platform. If no training/awareness connector is found for a40client, say so explicitly rather than reporting a completion rate of 0% —41"unmeasured" and "0% complete" are very different findings and must not be42conflated.4344## Key Concepts4546### What "overdue" means4748A user or org is overdue when a training assignment has passed its due date49without a completion recorded, or when the org has no active/recent campaign50covering a training requirement that a defined cadence calls for. Distinguish51between:5253- **Assignment overdue** — a specific training module or campaign was54 assigned to a user with a due date, and that date has passed with no55 completion recorded. This is the clearest, most defensible overdue signal56 when the platform exposes due dates.57- **Cadence overdue** — no assignment exists at all, but the org's58 contracted or expected cadence (e.g. "quarterly phishing simulation,59 annual awareness module") implies one should have run by now. This60 requires knowing the cadence — pull it from documentation (IT Glue/Hudu),61 the PSA contract, or ask, rather than inventing a default cadence and62 presenting it as fact. If no cadence is known, report completion status63 without an overdue judgment and say why.6465### Per-org completion rate6667Completion rate = completed assignments / total assignments for the68relevant campaign or requirement, per org. Report this per campaign as well69as an org-level rollup across all active campaigns — a single blended70percentage can hide the difference between "everyone did the quarterly71phishing sim" and "nobody did the annual compliance module."7273### Flagging clients falling behind cadence74751. Establish the expected cadence per client, where known (contract terms,76 documentation, or explicit user input). If unknown, do not assume a77 default — flag cadence as unconfirmed for that client.782. Compare the most recent completed campaign date (or, for a79 currently-running campaign, its due date) against the expected cadence80 interval.813. Flag any client whose most recent relevant campaign is older than the82 cadence interval, or who has no campaign of that type at all in the83 connected platform's history.844. Rank flagged clients by how far past cadence they are, not just a binary85 flag — a client 400 days overdue on annual training is a different86 priority than one 20 days overdue.8788## Common Workflows8990### Portfolio-wide overdue sweep91921. Discover the connected training platform(s) via `conduit__search_tools`.932. For each client (or org/group, depending on the platform's tenancy94 model), pull active and recent campaigns and per-user completion status.953. Compute per-org completion rate per campaign, and flag any user with an96 assignment past its due date.974. Where cadence is known, flag clients whose most recent relevant campaign98 predates the expected interval.995. Present clients with zero connected training tooling as unmeasured,100 separate from — not blended into — the ranked overdue list.101102### Single-client training snapshot1031041. Resolve the client against the connected platform's org/group model.1052. Pull all campaigns scoped to that client and completion status per user.1063. Report completion rate per campaign, list of overdue users by name (or107 ID if names aren't exposed), and cadence status if known.108109## Error Handling110111### No training/awareness connector found112113State plainly that no training-completion data is available — do not report114a 0% completion rate, which implies data was checked and everyone failed.115"No security-awareness training platform connected for this client" is the116correct output.117118### Connector present but campaign has no due dates119120Report completion rate without an "overdue" classification for that121campaign, and note that overdue detection requires due-date data the122platform didn't return for this campaign.123124### Cadence unknown125126Report completion status without a cadence-compliance verdict, and note127explicitly that cadence wasn't available (documentation, contract, or user128input) rather than assuming a default like "quarterly."129130## Best Practices131132- Tool names follow `<vendor-slug>__<tool_name>` (e.g.133 `knowbe4__list_campaigns`) — discover them via `conduit__search_tools`134 rather than guessing.135- Where Proofpoint or Avanan phishing-simulation data is available136 alongside KnowBe4, note it as corroborating context in this skill, but137 hand off correlation with real-world click data to the138 `phishing-simulation-analysis` skill rather than duplicating that logic139 here.140141## Related Skills142143- [Phishing Simulation Analysis](../phishing-simulation-analysis/SKILL.md) —144 click-rate trends and repeat-clicker identification, the companion metric145 to training completion.146- [Risk Scoring](../risk-scoring/SKILL.md) — combines this skill's147 completion data with phishing-simulation performance into a single148 explainable per-user/per-org risk score.