SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone
1What it is and why
What it is
A report that compares, for one job, the skill levels the job requires with the actual levels of the people of the chosen person type, as of a date.
What you do here
Use this page to print the gap per person against one job, for succession planning or before a promotion round.
Example
For example, for the succession of BEAT's plant manager HR prints the report for the Plant manager job with Person type workers and Group by skill type, and finds 2 of the 5 shift managers short only in the Finance skill type.
The page in Dynamics 365. page title tab to open what to set or check
About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.
When to run it
When to run it
When you compare people's skills with the skills a job requires, for example for succession planning or before a promotion.
How often
On demand, when a job or candidate is reviewed.
What the output shows
For each person, the required skill levels of the job against the person's actual levels, with the gap. A person who is missing usually has Include in skill mapping set to No.
The job whose required skills people are compared with.Checked in Dynamics 365
Plant manager
Actual date
The date people's skill levels are read as of.Checked in Dynamics 365
2026-11-30
Group by skill type
Groups the skills on the report by skill type.Checked in Dynamics 365
Yes
Common errors and fixes
Message
What to do
A worker who holds the skill is missing from the result
Only workers, applicants and contacts with Include in skill mapping set to Yes are searched and profiled. Set it to Yes on the Worker (or Employee, Applicant, Contacts) page and run again. Microsoft Learn
A recently rated skill is missing or shows the old level
Skills are read by their Level date. Set the analysis date on or after the Level date of the new rating, or correct the Level date on the worker's Skills page. Microsoft Learn
Run it per key job with Person type workers, Group by skill type and Show importance on, once a year in the succession review.Skill gap analysis compares people's skills with the skills a job requires, and succession planning looks for people with a similar skill set.
HR and training staff run it when they plan development, training and succession for current workers. No Feature management feature is needed for this page.
Shared data: jobs, their required skills (Job - skills) and people's skills (Skill competency) are shared in Data management, so the comparison is the same from any legal entity. Checked in Dynamics 365
Can it be undone
Nothing to undo: The report only compares records.
If you change it later
The report reads the job's required skills and people's ratings at run time; only people with Include in skill mapping set to Yes are compared. Microsoft Learn
Technical architect
6Technical
Menu item
HcmSkillGapJobChecked in Dynamics 365
Form
SysOperationTemplateFormChecked in Dynamics 365
Roles to set it up and use it
To use itHuman resource manager HcmHumanResourceManagerHuman resource assistant HcmHumanResourceAssistantCompensation and benefits manager HcmCompensationAndBenefitsManagerRecruiter HcmRecruiterPayroll administrator HcmPayrollAdministratorGive people one of these roles. On this system, 9 roles can run this page.Checked in Dynamics 365
Developer
7Developer
Open it by URL
https://<your-environment>/?mi=HcmSkillGapJob
Data migration
Load order: Skills gap: job has no data entity in Data management, so it can't be loaded from a file or a configuration template. It compares a job's required skills with people's skills; load Job - skills with the Jobs and positions template and Skill competency with the Employee development template.Microsoft Learn