A Project is an overall container that represents the skills ruleset for a single application with gamified training. Project's administrator(s) manage skill definitions, subjects, levels, dependencies and other attributes that make up an application's training profile.
Creating a project is simple, all you need is a name. While the project id is required, it will be automatically generated (you can optionally override the generated id).
As of 2.1.0 there is now a description field available for projects. Where the project description is displayed is controlled by the new Project Description setting in Project Settings
To create a project click the
Project + button.
A Project is composed of Subjects which are made up of Skills and a single skill defines a training unit within the gamification framework. Once the project is created you have an empty canvas on which to compose and manage your application's training profile. Generally the next step is to create a number of Subjects and then start constructing Skill definitions within those Subjects.
The Dashboard user that creates a project is automatically granted the role of administrator of that project. Project administrators enjoy the following benefits:
|Subjects||Add, edit or remove Subjects|
|Skills||Add, edit or remove Skill definitions|
|Self Reporting||Self Report is a feature that empowers users to mark skills as completed directly in the SkillTree dashboard OR through the embedded Skills Display component.|
|Access Management||Manage Project's Admin/Approver roles and Private Invite Only access|
|Badges||Add, edit or remove Project's Badges|
|Levels||Customize number of Levels and their attributes|
|Dependencies||Specify the order of Skills completion. For example Skill A must be completed before Skill B can be attempted|
|Cross-project Dependencies||Create and manage Skill dependencies across multiple Projects which practically equates to cross-application Skills|
|Contact Users||Communicate with users of your Project|
|Metrics||Charts and graph. These are page specific - Project, Subject, Badge, and User will have stats specifically for those pages|
|Issues||Errors related to the Project such as non-existant Skills that have been reported|
|Settings||Project level settings|
To manage and view project-wide settings navigate to
Project -> Settings.
The following project-level settings are available:
# Setting: Visibility Since skills-service:2.0.0
There are three possible values for the Project Visibility setting:
- Public Not Discoverable (default value)
- Private Invite Only
- Discoverable on Progress And Ranking
Public Not Discoverable projects can be accessed by users who have a direct link to the project's client display or by applications that have integrated the SkillTree client libraries. The project will not be available in
Manage My Projects if the Progress and Ranking views have been enabled.
Private Invite Only projects can only be accessed by users who have been invited to join the project and who have accepted the invite, any other user attempting to access the project will receive an Access Denied error. Users who have been
designated as Project Administrators will continue to have access to the project. Users can be invited to join the project using the Project Access page.
Discoverable on Progress And Ranking projects can be discoverd by users in the Manage My Projects view. This option will only be displayed if the instance
of SkillTree has been configured to enable the Progress and Ranking views.
Prior to 2.0.0 this setting was called Discoverable and applied only to a project's discoverability in the Progress and Ranking view.
There may be a delay of up to several minutes after changing a project's visibility from or to
Private Invite Only before the change is reflected for all users.
# Setting: Project Description Since skills-service:2.1.0
There are two possible values for the Project Description setting:
- Only show Project Description in Manager My Projects (default value)
- Show Project Description everywhere
Only show Project Description in Manager My Projects is the default value for a Project. With this setting, any project description that has been configured will only be displayed in the Manage My Projects view - in the future the description may be visible to other Project Administrators in the Import Skills From the Catalog dialog.
Show Project Description everywhere will cause any configured project description to be displayed anywhere that the training profile is displayed, including in the Manage My Proejcts view. This setting may be most applicable for SkillTree users whose training profile is viewed primarily through the Progress and Ranking view in the SkillTree dashboard.
# Setting: Use Points For Levels
Use Points For Levels - switch between two level management strategies:
- Percentage based - levels are calculated based on configured percentages of total available points (ex. Level 1 = 10% of total points)
- Point based - project admins specify start and end point values for each level
By default the Percentage based strategy is configured, changing the
Use Points For Levels setting to
true enables Point Based explicit level point management. To learn more please see the Levels section.
You must define at least 100 points for a project before switching to point-based levels management
# Setting: Root Help Url
Help Url/Path will be treated relative to this
Root Help Url. For example, if
Root Help Url=
- and a Skill definition's
then the client display will concatenate
Root Help Url and
Help Url to produce
If a Skill's
Help Url starts with
Root Help Url will NOT be utilized.
If a Skill's
Help Url is blank then no url will be displayed even if
Root Help Url is configured.
In other words
Root Help Url only works in conjunction with a Skill's
# Setting: Self Report Default
By default, Self Reporting is disabled when creating or modifying a skill. If your project primarily consists of Self Reported skills, enabling Self Report Default will result in the selected Self Report Approval type being the default for any skills created after this point
Please visit Self Report section to learn further.
# Setting: Rank Opt-Out for ALL Admins
When enabled, all project admins will be excluded from the Leaderboard and will not be assigned a rank within the embedded Skills Display component
# Setting: Custom Labels
Certain terminology in SkillTree may be overloaded to some organizations and could be confusing to end users. If this is the case, admins can customize the following labels displayed to users in the embedded Skills Display component and Progress and Ranking pages:
# Setting: Always Show Group Descriptions
Toggle this setting to always show the group's descriptions in this project embedded Skills Display component and Progress and Ranking pages.
The Project Access page supports adding or removing Project Administrators, Project Approvers, and inviting users to join a project if the project has been configured as an Invite Only project as well as revoking a user's access.
To add and remove project Administrators and Approvers navigate to
Project -> Access page.
You must have an Admin role in order to manage other Admin and/or Approver users for a project. There supported project roles are:
- Admin: enables management of the training profile for that project such as creating and modifying subjects, skills, badges, etc.
- Approver: allowed to approve and deny Self Reporting approval requests while only getting a read-only view of the project.
# Invite Only
If the project has been configured with a visibility of
Private Invite Only, invite and access revocation are controlled here.
Project User: Invite and
Project User: Revoke user interface controls are only displayed if the project has been configured with a Visibility of Invite Only
# Invite Users
Users are invited to join a project that has been configured as
Private Invite Only via email. Invite recipients are added via the
Email Addresses input field and can be added one at a time or by using a comma or semicolon separated list
or by entering one email address per line in the
Email Addresses input field (email addresses in the form of
<firstname.lastname@example.org> Firstname Lastname are also supported). Once email addresses have been entered into the
Email Addresses input field,
they must be added as recipients using the
Add Recipients button. These steps may be performed several times before the
Send Invites button is pressed at which point all accumulated email addresses will be sent an email with a unique, one-time use invite to join the project.
Project invites may be configured to expire if not accepted within a certain time frame. Please note that the expiration configuration is only applicable to how long the invite code itself is valid. Once a user has accepted a valid invite code and joined the project, the invite expiration configuration is no longer relevant for that user.
Each email recipient receives a unique project invite code, therefore distribution lists or group email accounts should not be added as recipients as only the first person to claim the invite will be able to use it.
To invite users to join a
Private Invite Only project, the SkillTree instance MUST be configured to support email. Please see Email Server Settings for more information.
# Manage Invites Pending Acceptance Since skills-service:2.2.0
Once Project Invites have been sent to users, any invites that have not yet been accepted or invites that have recently expired can be managed through the
Invites Pending Acceptance table below the
Invite Users form.
Once an invite has been accepted by a user, it will no longer be displayed in the
Invites Pending Acceptance table, in that case the user will appear in the Revoke Access table.
The actions that can be performed on each invite are: expiration time extension, remind user of invite, and delete invite.
Expiration Time Extension can be performed for any invite listed in the
Invites Pending Acceptance table. For invites that are not yet expired, the selected extension time will be added to the invite's current expiration time. For invites that have expired,
the selected extension time will be added to the time at which the extension is performed. For example, if an invite expires in 15 minutes and it is extended by 30 minutes, it will expire in 45 minutes. If an invite is currently expired and is extended by 30 minutes, it will expire in 30 minutes.
Remind User of Invite will send a reminder email to the user, encouraging the user to accept the project invite. It is important to note that a reminder cannot be sent for an invite that has expired. If an invite has expired, it must first be given an extension at which point
the notification button will become enabled and a reminder may be sent to the user.
Delete invite will cause the selected project invite to be deleted, any future attempts to use that invite code will fail. Note that a new invite can be generated for the user whose invite was deleted if desired. Expired invites may be deleted to remove them from the view prior to removal by automated cleanup processes.
Expired invites are, by default, visible for 30 days after they have expired; however, this is a configurable, system level, property that may be configured differently depending on the environment
# Revoke Access
Once a user has accepted an invitation to join a project configured for Invite Only visibility, that user will show up under the Revoke Access table at which point their access can be revoked and they will no longer have access to the project.
When a user's access to an Invite Only project has been revoked, only that user's access is removed. Their achievement history is retained in case they are granted access in the future or the project's visibility is changed.
# Copy Project
To use an existing Project as a template you can easily copy its training profile (subjects, skills, badges, etc..) into a brand-new project.
To copy a project please use the button available on a project card on the Project page. The system will prompt you to enter a new project name and optionally modify the project id.
The following training profile elements are copied into the new project:
- Subjects and their attributes (description, help url, etc..)
- Skills definitions and their attributes (description, points, self-reporting, etc...)
- Skill Groups
- Configured display order subjects and skills is preserved in the copied project
- Project-Based Dependencies
- Re-used Skills
- Project's Settings are copied with the exception of the exclusions specified below
The following training profile elements are NOT copied into a new project:
- Catalog imported skills are not copied
- Cross-Project Dependencies are not copied
- If the original project Visibility setting was changed to be
Discoverable on Progress And Rankingthe copied project will instead use the default value of
Public Not Discoverable
Once a project has been copied, the new project is disconnected from the original such that changes to the original project will not be reflected in the copy
# Share Project
Public projects that are configured to be discoverable can be easily shared with users so they can begin consuming the micro-learning gamified training!
To share a project click on the
Share button on the project admin page:
Share button is clicked the share information modal is displayed:
Copy the url and share it with your trainees. When the link is visited, two things happen:
- The Progress and Ranking page for that project is displayed AND
- the project is automatically added to My Projects.
Share button is only displayed if the Project Visibility is configured to the
Discoverable on Progress and Ranking option.