Skip to content

What is a skill

A skill is not code. It is an instruction for the AI agent: a Markdown file that teaches the agent a new workflow, your way.

Plugins extend the app with code; skills extend the agent’s thinking with text. A skill describes when it applies, which tools may be called, and which steps to take. The agent follows it like a playbook.

A skill is a folder with a SKILL.md file: a YAML header with metadata plus Markdown instructions. User skills live in the user’s data under knowledge/skills/<slug>/.

  • By trigger phrases: the skill activates when the user’s request matches phrases from the frontmatter. Per-language sets are supported.
  • apply: always keeps the skill in the agent’s context; on_demand loads it when needed.

Yttri ships with a set of core skills. For example, meeting-followup parses meeting notes into decisions, open questions, and tasks with owners, while create-skill helps the agent create new skills on request.