> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# HR Gap Analysis

> Identify and prioritize skill gaps across the organization by department, with search and severity filtering.

The Gap Analysis page (`/hr/skills/gap-analysis`) shows skill gaps across the organization, with filtering by department, skill name search, and severity, linking to individual skill detail pages.

## Overview

The page displays a header with the title "Gap Analysis" and a description. A filter row provides a skill name search input, a department selector, and a severity filter (All / Critical only — where critical is defined in code as more than 50% of the group lacking the skill). The `useTeamSkillGaps` hook is called with the selected department filter; the resulting `teamGaps.skillsWithGaps` array is further filtered client-side by search term and severity.

For each skill gap, a card shows the skill name, `percentLacking` as a progress bar, and a link to navigate to the skill detail page at `/hr/skills/:id`.

## Who it's for

Access follows your organization's role and module configuration. ## Before you start

* Skill proficiency data must be captured against employees in your organization for gaps to appear.
* Department filter options come from `useDepartmentList`.

## Steps

1. Navigate to **HR → Skills → Gap Analysis** or go to `/hr/skills/gap-analysis`.
2. Optionally select a department to scope the analysis.
3. Use the search box to filter by skill name.
4. Toggle the severity filter to focus on critical gaps only.
5. Click a skill card to view the full skill detail.

## Key concepts

| Concept           | Meaning                                                          |
| ----------------- | ---------------------------------------------------------------- |
| Percent lacking   | Percentage of employees in the filtered group who lack the skill |
| Critical severity | Gap where more than 50% of the group lack the skill              |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/hr.tsx
  * src/cores/hr/pages/GapAnalysisPage.tsx
  * src/cores/hr/hooks/skills/useTeamSkillGaps.ts
</Accordion>