Company-wide skills
Write skills that any Coworker can be given, see which Coworkers use them, copy a Coworker's skill company-wide, and what deleting one does.
A skill is a short piece of written guidance for a kind of task, such as how your finance team formats a month-end summary. A Coworker reads a skill when it is about to do work the skill covers. A company-wide skill is written once by an administrator and can then be given to any Coworker by that Coworker's Supervisor.
Skills are part of the Coworkers product area. When Coworkers is switched off in Settings, then Features, skills are unavailable.
Who can do what#
| Action | Who |
|---|---|
| Create, change, delete or share a company-wide skill | People with the admin ability |
| See the company-wide skills, to give one to a Coworker | People with the admin or manage_coworkers ability |
| Write, change or delete a skill on one Coworker | That Coworker's Supervisor |
| Give a company-wide skill to a Coworker, or take it away | That Coworker's Supervisor |
| Read a Coworker's own skills | Its Supervisor, and administrators |
A Coworker in the Sunset phase cannot have skills added, changed or deleted; its Supervisor can still use Remove on a company-wide skill attached to it.
Write a company-wide skill#
- Select Settings, then Company skills under Coworkers & Apps. The page appears while the Coworkers product area is on.
- Select Add a skill. Fill in Name, Description, optional Keywords and Guidance.
- Select Add skill.
The description and keywords are what help a Coworker find the skill, so say plainly when it applies. Separate keywords with commas. Guidance is the skill itself, with a counter showing how much of the 8 KB limit you have used.
The page lists each skill with its description, how many Coworkers it is attached to, who wrote it and when it was last updated. Use Search skills to filter the list, and Edit or Delete on a skill.
Limits:
- The guidance is at most 8 KB.
- The name is at most 80 characters, the description at most 500, with up to 32 keywords of up to 64 characters each.
- A name must be unique among company-wide skills, and cannot be the name of one of the skills
that ship with the product (such as
docx-reportorbrowser-use). Names can use any language and must include at least one letter or number. Capitalization, punctuation and accents on Latin letters are ignored when comparing names, so "Política" and "politica" are the same name.
A Coworker can also have its own skill with the same name as a company-wide skill it has been given. Its own skill is the one it uses.
Share a Coworker's skill with the company#
On a Coworker's details page, in Skills, an administrator sees Share with the company on each skill marked This Coworker. A dialog asks you to confirm, then makes a copy as a company-wide skill under your name. The original stays with the Coworker and is not changed, and later edits to either do not change the other. You can give the copy a different name. Copying a skill does not give it to any other Coworker; Supervisors do that.
Where a skill reaches Coworkers#
A Supervisor gives a company-wide skill to a Coworker from that Coworker's details page, in Skills, with Attach a company-wide skill. Remove on an attached skill takes it away from that Coworker only. The Company skills page shows how many Coworkers each skill is attached to.
When a Coworker starts a turn, it sees a short list of the skills available to it: its own, then the company-wide ones it has been given. The list shows up to ten, each with a trimmed description. When there are more, the Coworker searches for the rest. It loads a skill's full content only when it decides it needs it.
A skill with the same name as a skill that ships with the product is not allowed. Where a Coworker has an own skill and a company-wide skill with the same name, it uses its own.
Because the Coworker reads the current version each time, an edit to a skill applies on the Coworker's next turn, and so does taking a skill away.
Delete a company-wide skill#
Deleting a company-wide skill takes it from every Coworker it was given to. The confirmation shows how many Coworkers that is before you confirm. Their next turn no longer lists it. Deleting cannot be undone.
Treat skills as instructions#
A skill is text that Coworkers follow. A company-wide skill reaches every Coworker it is given to, so write only what you want all of them to do and review changes with that in mind. Skills are shown with their author, and the audit log records who made each change.
Audit#
Every skill action is recorded in the Audit tab under the Skills area, with the target type Skill. See The Audit log.
| Event | When |
|---|---|
| Created a skill | A company-wide or Coworker skill was written |
| Changed a skill | Name, description, keywords or content were edited; the entry lists which fields changed |
| Deleted a skill | A skill was deleted; for a company-wide skill it records how many Coworkers lost it |
| Copied a Coworker's skill to the whole company | Share with the company was used |
| Gave a Coworker a company-wide skill | A Supervisor attached one |
| Took a company-wide skill from a Coworker | A Supervisor used Remove on one |
Entries carry the skill's name and scope and ids, never the skill's content.