> ## 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.

# Competencies

> View and manage identified competency gaps across the organization, surfaced from performance reviews.

The Competencies page displays competency gaps flagged during performance reviews, grouped by employee and category. It is available at route `/hr/performance/competencies`.

## Overview

The page queries `hr_performance_competencies` filtered to rows where `has_gap = true` and joins each record to its source review and employee. Four stat cards summarize: Total Gaps Identified, With Training Plans, Pending Action, and Total Assessed. Each gap card (`CompetencyGapCard`) shows the competency name, category, rating, any gap description, and whether a training recommendation is linked.

## Who it's for

Access follows your organization's role and module configuration. Any authenticated user who can reach `/hr/performance/competencies` will see the page; data is scoped to the current organization via `organization_id`.

## Before you start

* Performance reviews must exist with competency assessments recorded.
* At least one competency must have `has_gap = true` for gap cards to render.
* Training recommendations are optional; gaps without one are counted under "Pending Action."

## Steps

<Steps>
  <Step title="Navigate to Competencies">
    Go to **HR → Performance → Competencies** or navigate directly to `/hr/performance/competencies`.
  </Step>

  <Step title="Review the summary stats">
    The four stat cards at the top show Total Gaps Identified, With Training Plans, Pending Action, and Total Assessed for the organization.
  </Step>

  <Step title="Browse individual gap cards">
    Each card in the grid shows the employee name, job title, competency name, category, rating, and any gap description. Cards without a training recommendation contribute to the Pending Action count.
  </Step>

  <Step title="Follow up on pending gaps">
    Use the information to navigate to the relevant performance review and assign a training recommendation, which will move the gap from Pending Action to With Training Plans.
  </Step>
</Steps>

## Key concepts

* **has\_gap** — Boolean flag on `hr_performance_competencies`; only rows where this is `true` appear on this page.
* **training\_recommendation\_id** — When present, the gap is considered to have a plan; gaps missing this field count as Pending Action.

## 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/performance-routes.tsx
  * src/cores/hr/pages/performance/CompetencyLibraryPage.tsx
</Accordion>