Dark mode
Skills and the skill catalog

Skills and the skill catalog

A skill is a reusable set of instructions that an agent can find and read during a run. Use skills to teach agents how your team does something, such as how to write release notes or how to triage a bug, without repeating those instructions in every agent.

When you attach a skill to an agent, the agent sees the skill's title and description. It reads the full instructions only when the skill is relevant to the work in front of it.

Open the skill catalog

  1. In the sidebar, open Automation.

  2. Under Catalog, select Skills.

Skills are grouped by where they come from:

Group

What it contains

What you can do

Your skills

Skills created in this workspace

View, edit and delete

Built-in

Skills that come with Helpin

View only

Imported

Skills uploaded as a skill archive

View and delete

Each card shows the skill's title and description, and which agents use it. Select View details to read the full instructions. Use Search skills... to filter the list.

Create a skill

  1. Select New skill.

  2. Enter a Title. Helpin generates the skill's key from the title.

  3. Enter a Description. Agents use it to decide when the skill is relevant, so say clearly what the skill is for.

  4. Enter the Instructions the agent should follow when it uses the skill.

  5. Select Create.

All three fields are required.

Edit or delete a skill

Hover over a card to show its actions.

  • Select the edit icon to change a skill in Your skills. Leave Instructions empty to keep the current instructions.

  • Select the delete icon to remove a skill from Your skills or Imported, then confirm.

Built-in skills can't be edited or deleted.

Import a skill

You can import a skill package as a .zip archive of up to 10 MB.

  1. Select Import.

  2. Select the archive, then select Import.

The archive must contain exactly one SKILL.md file. That file must start with a YAML front-matter block that includes a name and a description, followed by the instructions.

Who can manage skills

Anyone who can view Automation can browse skills. To create, edit, import or delete skills, you need edit access to at least one module: Projects, Docs, CRM or Support.

Use skills with agents

You choose skills for a custom agent in its Skills field. If a skill needs certain tools, Helpin adds those tools to the agent automatically. See Give agents tools and skills.

Was this article helpful?