Courses
Agent Harness with Spring AI
Part 4: Skills and Agents
14. Skills as files

Chapter 14: Skills as files

A skill is a folder with a SKILL.md file. The file has a name and a one-line description in front matter, then the full instructions. The harness loads only names and descriptions at the start. A useSkill tool loads the full text when the model asks for it.

---
name: triage-error-group
description: Judge the severity of one error group from its rate, the services it affects, and whether a runbook exists.
---

# Steps
1. Read the error rate for the last 15 minutes.
2. List the affected services.
3. Search runbooks for the error fingerprint.
4. Return one severity: low, medium, or critical.
Figure 14.1. A skill costs one line of the prompt until the model asks for it. The figure leaves out the tool calls the model makes while following the steps.
docs