Skills and skill packs
A skill is a set of written instructions a Bot follows when you type its command. This guide covers writing one, giving it to a Bot, and moving skills between workspaces as packs.
3 min read
What a skill looks likeCopy link to this section
A skill is one text file: a short header between --- lines, then the instructions in Markdown. A plain SKILL.md with only a name and a description imports as it is.
---
name: team-update
title: Team update
description: Turns this week's notes into a one-page report for the team.
---
1. Read the notes and files I attach.
2. Group what happened under Done, In progress and Blocked.
3. Keep it to one page. Name anything you could not confirm.| Field | Rule |
|---|---|
name | The command, typed as /team-update: 2 to 40 lowercase letters, digits and hyphens, starting and ending with a letter or digit. It cannot be changed later. |
title | Optional, up to 120 characters; the name is used without it. |
description | The one-liner shown in lists, up to 200 characters. |
| Instructions | Required. The whole file can be up to 64 KB. |
Write and use a skillCopy link to this section
- Open Skills and choose New skill. Fill in the command, title, one-liner and instructions, and list any tools it needs (listing a tool does not give the Bot access to it). Save.
- In any chat, type
/and the command. Your skills are private to you until you share them. - Edit changes a skill from its next use, and its History restores an earlier version. Export downloads it as one file, and Share with everyone makes it a workspace skill, at once or after an administrator approves, depending on your workspace's setting.
A Bot can also propose a skill in a conversation; nothing is saved until you choose to save it.
Give a skill to a BotCopy link to this section
Open the skill with Edit and switch it on for each Bot under Agents; it saves at once, and that Bot then offers the command in its message box. You can give your own skills to Bots you own. Administrators give workspace skills to Bots under Admin › Skills.
Skill packsCopy link to this section
A pack is one text file holding several skills, with a name, an optional summary and a version such as 1.0.0. It holds at most 25 skills and 512 KB.
- Export: tick the skills on the Skills page, choose Export as pack, give it a name and version, and Download pack. Which Bots have the skills is not included.
- Import: Import pack shows each skill as new, already here, or not importable, and lets you import, skip, import under a new name or replace the one here. All choices are saved together or not at all. A skill that needs a tool not yet connected can still be imported, with a warning. Afterwards Give all hands every imported skill to a Bot.
Starter packsCopy link to this section
Starter packs, beside Import pack, offers twelve ready-made packs in English and Japanese. Each opens in the import preview first, and none needs a tool.
| Pack | Commands |
|---|---|
| Meeting notes | /meeting-notes, /meeting-action-items |
| Research brief | /research-brief, /source-summary |
| Inbox triage | /inbox-triage, /reply-draft |
| Weekly report | /weekly-report, /weekly-highlights |
| Proposal writing | /proposal-outline, /proposal-price-table, /executive-summary |
| Spreadsheet cleanup | /sheet-cleanup, /sheet-outliers |
| Web table extraction | /web-table-to-csv, /web-table-check |
| PDF form filling | /pdf-form-fill, /pdf-form-checklist |
| Slide outline | /slide-outline, /speaker-notes |
| SEO article brief | /seo-article-brief, /seo-draft-review |
| Job description | /job-description, /inclusive-language-check |
| Client replies | /client-reply-draft, /reply-tone-check |
Last updated