A skill is a folder with a SKILL.md: instructions, and any files they need, for one kind of task. Finn follows the Agent Skills format, so skills written for other agents work too.

Where Finn finds them #

In these folders, of your home folder and of the session folder:

  • .finn/skills/
  • .agents/skills/
  • .claude/skills/

The skills of the session folder count only when it is under a trusted folder. A project skill hides a home skill of the same name. Finn uses 100 skills at most.

Write one #

.finn/skills/release-notes/
  SKILL.md
  template.md
---
name: release-notes
description: Write the release notes of a version from CHANGELOG.md. Use when asked for release notes.
---

Read CHANGELOG.md, take the section of the version, and fill template.md...
  • description is required. The model reads it to decide when to load the skill. Past 1024 characters it is cut, with a warning.
  • name is the folder's name when left out: a-z, 0-9 and -, at most 64 characters.
  • disable-model-invocation: true keeps the skill from the model: only you load it.

A skill that has a problem is skipped. The server's log (finn server logs) says why, and has the warnings.

Load one #

  • The model sees the name and description of each skill in its system prompt, and loads one with the activate_skill tool when it fits the task.
  • You type /name in a message: /release-notes 1.2.0. The skill's content goes before your message.

A skill loads once per session. Its other files are listed for the model, which reads them with read_file. When a compaction folds the message that loaded a skill, the skill comes back after the summary.