---
title: Competency Framework
description: "The competency framework serves as a structured guide for competency-based learning (also known as skill-based, proficiency-based or mastery-based learning) by defining the [competencies](/docs/competencies/) that need to be mastered. The framework plays a crucial role in supporting a competency-based learning (CBL)…"
url: "https://www.scholarlms.com/docs/competency-framework/"
updated: "2024-04-20"
category: Learning Management System
---

# Competency Framework

The competency framework serves as a structured guide for competency-based learning (also known as skill-based, proficiency-based or mastery-based learning) by defining the [competencies](/docs/competencies/) that need to be mastered. The framework plays a crucial role in supporting a competency-based learning (CBL) environment by guiding learners through the learning process and helping them master the essential [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) needed for their career or academic goals.

### Overview

Let's understand what steps are needed to make your eLearning site become a competency-based learning (CBL).

1. **Plan and Structure a Competency Framework:** Before you begin setting up a competency framework on your site, it's crucial to carefully plan and structure the framework. This process ensures that the required skills and [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) for each role within your organization are clearly defined and easily identifiable.
2. **Create a Competency Framework on Your Site:** This guide will show you how to create and manage a competency framework on your eLearning site.
3. **Add [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) to Courses and Link to Activities:** Once the framework is created, next step is to integrate [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) into your courses and connect them to those activities that makes student competent for a particular skill.
4. **Create Personalized Learning Plan Templates:** Creating custom learning plan templates that can be assigned to individual students or groups of students to support personalized learning paths.

---

## Adding competency frameworks

To add a new competency framework:

1. Navigate to **Settings->Advanced Settings**, on **General tab** Scroll to the **[Competencies](https://www.scholarlms.com/encyclopedia/competencies/)** section and click **Competency frameworks**.
    ![Competency Framework](https://s3media.scholarlms.com/wp-content/uploads/2024/04/15123559/doc-competency-site-admin.jpg)
2. The **Competency frameworks** page shows any existing frameworks in your system. To create a new framework click on **Add new competency framework** button.
    ![competency framework add button](https://s3media.scholarlms.com/wp-content/uploads/2024/04/15123558/doc-competency-framework-add-button.jpg)
3. Fill details for the new framework on **Add new competency framework** page.
    ![competency framework add new general tab](https://s3media.scholarlms.com/wp-content/uploads/2024/04/15123557/doc-competency-framework-add-new-general-tab.jpg)
   - **Name** — Name the competency which is short and meaningful for your organization.
   - **Description** — Description is optional but it's recommended to add description about the competency.
   - **ID Number** — The ID number should be very specific, especially if it is likely that you will have multiple versions of a competency framework on the site at the same time (e.g. when revising the framework each year).
   - **Scale** — A scale determines how proficiency is measured in a competency. After selecting a scale, it needs to be configured.
      ![Competency scale](https://s3media.scholarlms.com/wp-content/uploads/2024/04/15123557/doc-competency-framework-scale.jpg)
     - The item selected as 'Default' is the rating given when a competency is automatically completed.
     - The item(s) selected as 'Proficient' indicate(s) which value(s) will mark the [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) as proficient when they are rated.
   - **Taxonomies** — From the Taxonomies drop downs, you can define the words used to describe [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) in the framework, depending on their depth in the tree.
      ![Competency Framework Taxonomies](https://s3media.scholarlms.com/wp-content/uploads/2024/04/15123556/doc-competency-framework-add-tanonomies-tab.jpg)
4. Once done, save changes and you just have created a competency framework, it will appear in the list of frameworks and you can add [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) to it.

## Adding [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) in a framework

To add a competency in competency framework:

1. Select the **competency framework**.
    ![competency framework list](https://s3media.scholarlms.com/wp-content/uploads/2024/04/15123553/doc-competency-framework-list.jpg)
2. Click on **Add Competency** button which opens a new form.
    ![competency framework add competency button](https://s3media.scholarlms.com/wp-content/uploads/2024/04/15123555/doc-competency-framework-add-competencies-button.jpg)
3. **Add details** about the competency.
    ![competency details form](https://s3media.scholarlms.com/wp-content/uploads/2024/04/15123552/doc-competency-framework-add-competencies-form.jpg)
4. Once done **Save changes**.
5. **Repeat** to add all [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) in the framework.

## Competency actions

To take an action on a competency, click on Edit link on the selected competency, it opens a window for more actions.

![Competency actions](https://s3media.scholarlms.com/wp-content/uploads/2024/04/15123551/doc-competency-actions.jpg)

- **Edit** — Takes you the competency edit page.
- **Relocate** — Allows you to relocate competency.
- **Delete** — Deleted the competency.
- **Move up and down** — Allows you to move or down competency from it's current position.
- **Linked courses** — Opens a popup to show what all courses this competency has been linked.
- **Add cross-referenced competency** — Allows you to cross-reference one competency with another.
- **Competency rule** — If you have a multi-layer taxonomy then you can have a competency automatically marked as complete if all of its children are complete. Competency rules can be added to any competency in a framework, **as long as it has children**. A competency rule can be used to automatically mark as complete a parent competency when all children of it are complete. Linking the child [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) to course activities combined with the competency rule '*Mark as complete when all children are complete*' will award the parent competency to a student when he has successfully completed the course activities.

## Competency applications

- **Associate [Competencies](https://www.scholarlms.com/encyclopedia/competencies/) into Courses and Activities**: Learn how to [associate competencies into your courses](/docs/competencies/) and activities to ensure a structured and goal-oriented learning experience.
- **[Learning Plans](https://www.scholarlms.com/encyclopedia/learning-plans/)**: Learn how to create learning plan templates, how to assign [learning plans](/docs/learning-plans/) to individual students or to entire [Cohorts](https://www.scholarlms.com/encyclopedia/cohorts/) (site-wide groups) for streamlined and cohesive learning paths.

 
