How to write a Skill: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
When to write skills: | When to write skills: | ||
* Repeated task that need to be done the same every time. | * Repeated task that need to be done the same every time. | ||
* Domain specific information, such as terminology, runbooks and style guides. | |||
* Specifications, schemas and configurations | |||
* Failure cases and their resolutions. | |||
When not to write skills: | When not to write skills: | ||
* One-off tasks: Use [[Chat | * One-off tasks: Use [[Chat Message]]s and describe to an [[AI Agent]] what you want instead. | ||
* Instructions for every conversation: Use [[How to set the instructions of a Chat Channel|channel instructions instead]]. | * Instructions for every conversation: Use [[How to set the instructions of a Chat Channel|channel instructions instead]]. | ||
{{howto|title= | {{howto|title= | ||
|Choose a unique name | |Choose a unique name | ||
|Write a short description (one or two sentences) of what this skill does and when it should be used | |Write a short description (one or two sentences) of what this skill does and when it should be used | ||
|Write the skill content using short sentences and a limited amount of lines | |Write the skill content using short sentences and a limited amount of lines | ||
| | |Test your skill repeatedly | ||
|Move what should be put in a separate skill | |||
|Remove what can be cut | |||
}} | }} | ||
==Tips== | |||
* Moderate detail: Not too comprehensive, but also not too exhaustive. Border cases can be put in separate skills. | |||
* Stepwise guidance, preferable with working example. | |||
* Keep description under 1024 characters. | |||
* Keep instructions under 500 lines or 5000 tokens. | |||
* Tell Agents when to perform an action | |||
{{article end | {{article end | ||
|notes* | |||
|seealso=*[[Skill]] | |seealso=*[[Skill]] | ||
*[[Chat Channel]] | *[[Chat Channel]] | ||
Latest revision as of 12:06, 15 October 2026
When to write skills:
- Repeated task that need to be done the same every time.
- Domain specific information, such as terminology, runbooks and style guides.
- Specifications, schemas and configurations
- Failure cases and their resolutions.
When not to write skills:
- One-off tasks: Use Chat Messages and describe to an AI Agent what you want instead.
- Instructions for every conversation: Use channel instructions instead.
How to write a Skill:
- Choose a unique name
- Write a short description (one or two sentences) of what this skill does and when it should be used
- Write the skill content using short sentences and a limited amount of lines
- Test your skill repeatedly
- Move what should be put in a separate skill
- Remove what can be cut
Tips
- Moderate detail: Not too comprehensive, but also not too exhaustive. Border cases can be put in separate skills.
- Stepwise guidance, preferable with working example.
- Keep description under 1024 characters.
- Keep instructions under 500 lines or 5000 tokens.
- Tell Agents when to perform an action