Accessible via: Main Menu -> Skills

A skill is a packaged capability: instructions, the tools it needs, and worked examples, bundled under one name. You teach it once and any agent or workflow in your organisation can use it.

Skills are how a general assistant becomes reliable at a specific job. Rather than repeating the same briefing in every prompt, you write it down once as a skill — and Sammy picks it up when the work calls for it.

Tools live here now

The old Tools surface has been folded into Skills — /tools redirects here. A skill bundles the relevant tools together with the instructions and examples for using them, which is the level agents actually work at. Where an agent’s attachments used to list individual tools, they now list skills.

Browsing skills

Open Skills in the left rail. The column lists every skill available to your organisation — both the ones Hutly ships and the ones you’ve written. Search by name to narrow it down.

Each skill records what it does, when to use it, and which tools it needs.

Creating a skill

1. Open Skills and click New skill.
2. Give it a name and a description.
3. Write the instructions — what to do, when, and what “done” looks like.
4. Attach the tools the skill needs.
5. Choose its visibility: private to your organisation, or public.

The description matters more than it looks. Sammy chooses which skill to load based on it, so it should say plainly when the skill applies — not just what it contains.

How skills get used

• Agents are attached to skills; the agent loads a skill when the conversation calls for it.
• Workflows can call a skill as a step.
• Sammy finds the right skill by matching the work in front of her against every skill description, so a well-described skill needs no explicit invocation.

From the CLI

Skills can be authored as files and deployed, which is how you version them alongside your other work and promote them between environments. See CLI › Skills.