Skills
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...descriptionis required. The model reads it to decide when to load the skill. Past 1024 characters it is cut, with a warning.nameis the folder's name when left out:a-z,0-9and-, at most 64 characters.disable-model-invocation: truekeeps 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_skilltool when it fits the task. - You type
/namein 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.