Skills

A Skill is a named, reusable set of instructions written in Markdown. Attach a skill to an AI agent block and it steers that agent's behavior — a repeatable way to encode tone, procedure, or domain knowledge once and reuse it across workflows.

Creating a skill

Skills are authored in a SKILL.md-style Markdown document with lightweight frontmatter:

---
name: Support triage
description: Classify and route inbound support messages
---

You are a support triage assistant. Read the message, classify its urgency,
and choose the correct team...

The frontmatter name and description are parsed out, and the Markdown body becomes the skill's instructions. If no name is given, the first heading is used, and the name is slugified. You can also upload a ZIP containing a SKILL.md (or any .md) to import a skill.

Create and manage skills in the Skills view, or via GET/POST /api/v1/skills and PATCH/DELETE /api/v1/skills/{id}. Each skill stores its name, description, instructions, an enabled flag, and usage stats.

Using skills

An AI agent block references a single skill through its skillId / skillName configuration. When the block runs, the skill's instructions are applied to that agent. Skills are also offered in the Command Center and as chat attachments.

Managing skills

The Skills view supports search across name, description, and instructions, plus enabling and disabling. Confluye tracks a usageCount and lastUsedAt for each skill: after a run completes, any skill referenced by a succeeded step has its usage incremented, so you can see which skills are actually in use.

Next steps