Skills for a Coworker
Write a skill that teaches your Coworker how you want a kind of task done, and give it the company-wide skills your administrators have written.
A skill is a short piece of guidance for a kind of task: how you want a weekly report laid out, the steps for handling a refund request, the house style for a client email. Your Coworker looks at its skills before work they cover and follows them.
Skills are on the Coworker's details page, in the Skills section. The section shows only to the Coworker's Supervisor and to administrators. Only the Supervisor can add, edit, delete, attach or remove skills; an administrator who is not the Supervisor can read the list and share a skill with the company.
Each skill in the list carries a badge: This Coworker for a skill written on this Coworker, or Company-wide for one an administrator wrote and you attached.
Write a skill#
- Open the Coworker's details page and find Skills.
- Select Add a skill.
- Fill in Name, Description (one line on when to use it), optional Keywords separated by commas, and Guidance: the skill itself, written as you would explain it to a new colleague.
- Select Add skill.
To change one later, select Edit on it, then Save. Delete removes it after you confirm.
Keep to what a person would need to do the task well: the steps, the format, examples of good output. Guidance can be up to 8 KB, about two to three pages of text, and a counter under the field shows how much you have used. The description can be up to 500 characters and the name up to 80.
A skill's name must be different from your Coworker's other skills and from the skills that come
with the product, such as docx-report. Names can be written in any language, but must include at least one letter or number. Capitalization, accents on Latin letters and punctuation do not make a name different: "Política" and "politica" count as the same name. The page tells you when a name is taken.
Give your Coworker a company-wide skill#
Your administrators can write skills for the whole organization. You can see them on the Coworker's Skills section. Select Attach a company-wide skill, choose one, and select Attach. Select Remove on an attached skill to take it away again. Remove takes it only from this Coworker.
If your Coworker has its own skill with the same name as a company-wide skill you attached, the Coworker uses its own.
You need to be the Coworker's Supervisor and to hold the manage_coworkers ability to see the
company-wide list. Administrators write and manage those skills; see
Company-wide skills.
When a change takes effect#
The Coworker reads its skills fresh each time it starts working on a message. A change you save, a skill you delete, or a company-wide skill you attach or remove applies from the Coworker's next turn. A conversation in progress needs no restart.
The Coworker is shown a short list of its skills, up to ten, each with its description. When it has more, it searches the rest by name, description and keywords, which is why a clear description and good keywords matter. It opens a skill's full text only when the work calls for it.
Sharing a skill company-wide#
If a skill you wrote works well, ask an administrator to use Share with the company on it from the Coworker's details page. The administrator confirms in a dialog, and a company-wide copy is made that other Supervisors can attach to their Coworkers. Your own skill stays as it is.
Things to keep in mind#
- A skill is guidance, not a permission. It does not give the Coworker access to anything it could not already reach.
- Do not put passwords or private personal data in a skill. Anyone who can open the Coworker's details page as its Supervisor or an administrator can read it. Use Secrets for credentials.
- On a Coworker in the Sunset phase you cannot add, edit or delete skills. Remove stays available on its attached company-wide skills.
- Skill changes appear in the organization's audit log without the skill's text.