Editing a Skill

Edited

Skills are edited directly in the skill window. Changes apply everywhere the skill is used.

Open the skill

  1. In the left-hand menu, under your organisation's name, click Position Skills.

  2. Find the skill in the list. You can search and filter.

  3. Click the skill to open it. Or open its ... menu, choose View and edit, then click View Skill.

You can also click a skill on a team's Skills or Framework tab.

What you can change

  • Skill name and description

  • The skill's image (upload or delete it)

  • Levels: use Add level, or a level's ... menu and Delete

  • Level descriptions

  • Examples for each level: use Add example

  • Editable by (admins only): Admins and Editors or Admins only

Changes save as you go. The AI Assistant can also help. See Draft a skill with AI.

Watch out

If the skill is used in more than one team, you'll see a banner saying which positions your edit will affect. If one team needs different wording, choose Create a variant instead (Organisation plan, or Business with the skill variants add-on). See Skill variants.

Format the text

Formatting makes descriptions, levels and examples easier to scan than long paragraphs.

  1. Click into the text you want to format and select some text. A small toolbar appears.

  2. Choose Bold, Italic, Code, Link, Blockquote, Bullet list, Ordered list or Task list.

You don't need to type HTML in the skill window. If you're importing skills from a CSV, see Formatting with HTML.

Who can edit

Admins can edit any skill in your organisation. Editors can edit skills unless the skill is set to Admins only.

View the history of a skill

Every skill keeps a history of changes, so you can see who changed what and when. You can see the history of any skill you're allowed to edit.

  1. Open the skill as above.

  2. In the panel on the right of the skill, click the History tab (next to Comments).

  3. Scroll through the changes. Click Load more to see older ones.

If you can't see the right-hand panel, click the sidebar icon at the top right of the skill. If a skill has variants, each variant has its own history, so switch to the variant first.

Make a copy of a skill

Copying is a quick way to start a new skill from an existing one. The copy is completely separate, so you can edit all of it without changing the original.

  1. On the Position Skills page, open the skill's ... menu (or the ... menu at the top of an open skill).

  2. Choose Make a copy.

  3. If you're asked to choose between Create a variant and Make a copy, click Make a copy.

The copy opens straight away. It has the same name with " copy" on the end (for example "Communication copy"), so rename it to something clear.

Copy or variant? A variant stays linked to the original skill and can be compared with it when comparing positions, but only its levels and examples can be edited. A copy isn't linked, shows as a separate skill when comparing, and can be edited in full. See Skill variants.