Skip to main content
Quick Summary: Competency frameworks in SkillsDB let admins define job roles with required skills, proficiency benchmarks, and career progression levels. Once built, people are assigned to roles so skill gaps and training needs can be tracked automatically.

Overview

A competency framework defines what skills, knowledge, and proficiency levels are expected for a given job role within your organization. In SkillsDB, competency frameworks are built around Careers — structured job roles that combine required skills, proficiency benchmarks, and optional career progression levels. When a person is assigned to a Career, SkillsDB automatically compares their current skill grades against the role’s benchmarks. This produces a real-time view of skill gaps, training completion status, and overall readiness — without any manual calculation. Competency frameworks in SkillsDB serve as the foundation for skills assessments, training tracking, and workforce analytics. They connect your organization’s role definitions directly to individual skill profiles, creating a single source of truth for workforce competency data. Only Company Administrators can create and manage competency frameworks. Once built, the framework drives visibility for managers and employees — surfacing relevant skill gaps, training assignments, and career dashboards within each person’s profile.

Prerequisites

Before you build a competency framework, you need:
  • Permission level: Company Administrator role
  • Feature availability: The Competency Framework module must be enabled for your organization. Contact your account manager if the Careers option is not visible in the sidebar.
  • Access path: Navigate to Library > Careers from the left sidebar

Understanding Competency Frameworks in SkillsDB

Competency frameworks in SkillsDB are built from four core components that work together: You can build a framework incrementally — create the Career first, then add skills, organize them into sections, and define levels at your own pace. Each component is optional except for the Career itself.
Note: The proficiency benchmarks (e.g., grades like 1–5 or letter grades) are determined by your organization’s grading scale, which is configured separately by your account admin. Benchmarks you set in a Career reference that grading scale.

Creating a Career

Creating a Career is the first step in building a competency framework. Each Career represents one job role or position type in your organization.
  1. Navigate to Library > Careers from the left sidebar
  2. Open the Actions menu at the top right of the page and select Career under Add New (or press ⌘K / Ctrl+K and search for “Add career”)
  3. In the Create career dialog, enter a career name — this is required and must be unique (e.g., Software Engineer, Field Technician)
  4. Optionally add a Description and Labels
  5. Select Continue
  6. Choose a career type to categorize this role, or type a new name and select Create career type. Career types help group and filter careers across your organization
The new Career appears in the Careers table and is immediately available for skills, levels, and people assignments. Select the Career name to open its detail page and begin building the framework.
Tip: Use Career Types consistently to categorize your roles (e.g., “Job Role”, “Functional Area”, “Department”). You can manage available types from the Actions menu in the Careers library by selecting Types under Manage.

Adding Skills to a Career

Skills are the core of a competency framework. Each skill attached to a Career includes an optional proficiency benchmark — the expected grade an employee should reach for that role.

Adding an existing skill

  1. Navigate to Library > Careers and select the Career you want to edit
  2. Open the Actions menu and select Skill under Search to Add (⌘K search: “Search for skill”)
  3. In the Search Skills dialog, use Search skills to find skills from your organization’s skill library, and select one or more of them. Skills already on the Career are shown as added and cannot be selected again
  4. Select Add Skills
  5. If Training Dates is enabled for the Career, the Set Requirement step asks whether the skills should be required: Not required, Required for all (all currently assigned people must complete the skills), or Only going forward (only people assigned from this point on must complete them)
The skills are added to the Career. Set each skill’s Benchmark — the proficiency level expected for this role (e.g., “Proficient”, “Expert”) — on the Career page. If no benchmark is set, the skill is tracked but not compared against a target.

Creating a new skill directly

If the skill you need does not yet exist in your library, you can create it directly on the Career.
  1. Open the Actions menu and select Skill under Add New (⌘K search: “Create skill”)
  2. Enter the skill name and, optionally, a description
  3. Optionally set a Benchmark, turn on Training required, add an Expiration, and require Text evidence or Attachment evidence for training approval
  4. Create the skill
The new skill is created in your organization’s library and immediately added to the Career.

Organizing Skills into Sections

Sections let you group skills within a Career into logical categories. This makes large competency frameworks easier to read and navigate — both for admins and employees.

Adding a section

  1. On the Career detail page, open the Actions menu and select Section under Add New (⌘K search: “Add section”)
  2. In the Create section dialog, enter a section name (required) — for example, Technical Skills or Core Competencies
  3. Optionally enter a description
  4. Select Create section
The section appears in the Career’s skill list. Existing skills not yet in a section can be moved into it, and new skills can be added directly to the section.

Editing or removing a section

To edit a section’s name or description, open the section’s menu and choose to edit it. The Edit section dialog opens; update the details and select Save changes. To remove a section, open the section’s menu and choose to delete it, then confirm in the Delete Section dialog.
Important: Deleting a section removes all of its skills and training resources from the Career. The skills and training resources remain in their libraries, but grades recorded against those skills on this Career are no longer shown. Move skills you want to keep out of the section before you delete it.

Managing Career Levels

Career levels define progression tiers within a job role — for example, Junior, Mid-Level, and Senior. When levels are defined, each skill in the Career can have a different proficiency benchmark per level, allowing SkillsDB to track progression requirements precisely.

Adding levels

  1. On the Career detail page, open the view menu next to the career name in the breadcrumb and select Settings
  2. Under Manage Levels, select Manage Levels
  3. In the Manage Levels dialog, select Add Level
  4. Enter a title for the level — for example, Junior, Senior, or Lead
  5. Repeat for each level in the progression
  6. Drag levels to reorder them; levels are arranged in descending order with L1 at the top
  7. Select Save
Levels appear as columns in the Skills view. For each skill and level combination, you can set an independent benchmark.

Level-specific benchmarks

Once levels are defined, open any skill card in the Career to set level-specific expectations. A skill can be enabled or disabled for each level, and each enabled level can have its own benchmark. This allows you to specify, for example, that a Junior needs “Awareness” of a skill while a Senior needs “Proficient.”
Tip: Define levels before assigning people. When you assign someone to a Career, you can also specify their current level, which determines which benchmarks apply to that person.

Configuring Career Settings

Each Career has a Career Settings page that controls which SkillsDB features are active for that role. Settings are configured per Career, allowing different roles to have different tracking behavior. Only administrators can open it.
  1. On the Career detail page, open the view menu next to the career name in the breadcrumb and select Settings
  2. The Career Settings page opens. The Measurement Model section contains the following options

Proficiency Grading

Toggle: Proficiency Grading When enabled, skill proficiency grades are tracked and grade columns appear throughout SkillsDB for this career’s skills. When disabled, grade columns are hidden and grading data is excluded from search and analytics. Assessments require Proficiency Grading to be enabled. If you disable Proficiency Grading, assessments for this Career’s skills will also be unavailable.

Training Dates

Toggle: Training Dates When enabled, users can request training approval for skills in this Career, and the skills appear in Team > Training > Training Matrix. When disabled, training approval tracking is turned off for this Career. If Training Dates is enabled, a Training Timeline section appears. Use this field to set the expected total time for employees to complete training approval for all skills in the Career. Enter values in days, months, and/or years. Training Dates also unlocks Bulk Update Skill Training Settings, Hide Non-required Skills, Section Training Requirements (a minimum number of approved skills per section), and Overview Progress Breakdowns. See Careers for details.

Assessments

Toggle: Assessments When enabled, skills from this Career are included in manager and self-assessments. When disabled, skills from this Career are excluded from all assessments. Assessments require Proficiency Grading to be active. If Proficiency Grading is disabled, the Assessments toggle has no effect.

User Dashboard

Toggle: Dashboard Enabled (in the User Dashboard section) When enabled, employees assigned to this Career see a career-specific dashboard at Profile > Skills > [Career Name] > Overview. When disabled, no career dashboard is shown. When the User Dashboard is enabled, the following dashboard components can be individually toggled:
  • Career Description — displays the career’s description text
  • Training Dates Summary — shows training approval status and completion
  • Proficiency Summary — shows skill gap analysis vs. benchmarks
  • Pinned Pages — displays pinned resources and links
  1. Select Save Changes at the bottom of the section you changed to apply your changes
Important: Disabling Proficiency Grading on an active Career will hide all grade data from search, analytics, and skills matrices for that Career’s skills. Existing grade data is preserved and reappears if you re-enable Proficiency Grading later.

Assigning People to a Career

Assigning people to a Career establishes their competency expectations. Once assigned, SkillsDB compares each person’s current skill grades to the Career’s benchmarks and surfaces gaps in their profile, their manager’s view, and organization-wide analytics. Administrators and people with Full Access can assign people to a Career.
  1. On the Career detail page, open the Actions menu and select Assign under People (⌘K search: “Assign people”)
  2. The Assign People dialog opens, showing a list of people in your organization
  3. Find the people you want to assign using Search people or the filters, and select the checkbox next to each person
  4. If the Career has more than one level, choose a level in Assign to level
  5. Select Assign People
The people are immediately assigned to the Career. Their Skills Profiles now reflect the Career’s skill requirements and benchmarks, and skill gaps become visible to both the employee and their manager. To remove an assignment, open the Actions menu, select Unassign under People, select the people, and select Unassign People.
Note: A person can be assigned to multiple Careers simultaneously. Each Career’s benchmarks are tracked independently, and the Skills Profile shows gaps for all assigned Careers.

Deleting a Career

Deleting a Career removes the framework entirely, including its section groupings and level definitions. People assigned to the Career are unassigned automatically.
  1. Navigate to Library > Careers and select the Career’s name
  2. Open the Actions menu (or press ⌘K / Ctrl+K) and select Remove career
  3. The Delete this career? dialog lists the sections, levels, skills, and training resources affected and how many assigned people will be unassigned
  4. Select Unassign and delete
Important: You cannot restore a deleted Career from SkillsDB. Deleting a Career does not delete the underlying skills or training resources — they are detached and remain available in their libraries for other Careers.

Common Questions

Yes. Skills in SkillsDB are shared across the organization’s skill library. The same skill can appear in multiple Careers with different benchmarks in each. For example, “Communication” might have a benchmark of “Proficient” in a Junior Engineer career and “Expert” in a Senior Manager career.
When you assign someone to a Career, SkillsDB immediately calculates skill gaps by comparing the Career’s benchmarks to the person’s current grades. Gaps appear on the employee’s Skills Profile, the manager’s team view, and in organization-wide analytics. The person also gains access to the Career dashboard (if enabled in Career Settings).
Yes. When you have defined Levels for a Career, each skill can have a level-specific benchmark. This allows you to define distinct proficiency expectations for Junior, Mid-Level, and Senior employees within the same Career.
A Career is an individual job role (e.g., “Software Engineer”). A Career Type is a classification category that groups related Careers together (e.g., “Engineering”, “Clinical”, “Operations”). Career Types are used for filtering and reporting purposes but do not affect competency tracking. You can manage Career Types from the Actions menu in Library > Careers by selecting Types under Manage.
Yes. Career Settings are configured per Career. Open the specific Career, select Settings from the view menu next to the career name, toggle Assessments or Training Dates off, and select Save Changes. This disables those features only for skills belonging to that Career, without affecting other Careers.
No. Only Company Administrators can create, edit, and delete Careers or modify the skills, sections, and levels within a framework. Managers can view the Careers assigned to their team members and see skill gaps, but cannot modify the framework itself. Standard users can view their own Career assignments and skill gaps in their profile.
When you delete a Career, the Delete this career? dialog lists the sections, levels, skills, and training resources affected and the number of people who will be unassigned. If you confirm with Unassign and delete, all people are automatically unassigned from the Career. Previously submitted grades are retained in SkillsDB’s records but are no longer shown under the deleted Career, and the Career cannot be restored from SkillsDB.

Related Articles

Skills Matrix

View a visual matrix of skill grades across your workforce, filtered by Career

Training Matrix

Track training approval status for all skills in a Career across your team

Career Pathways

Define progression paths between Careers

Promotion Workflows

Automate role transitions based on Career performance

Need Help?

If you run into any issues or have questions, reach out to your organization’s SkillsDB administrator or contact SkillsDB Support.