Skills
Skills are reusable workflow packages that extend what the agent can do. They live under /skills as a persistent volume.
What a skill is
Section titled “What a skill is”A skill is a directory containing:
- A
SKILL.mdfile with metadata (name, description, when to use it) - Supporting scripts, references, and assets
Skills are markdown-defined and portable across stacks. They are not code that runs automatically — they are instructions and context that the agent reads and follows.
How they work
Section titled “How they work”When a skill is relevant to the current task, the agent reads the SKILL.md and follows its instructions. This might mean:
- Running a script from the skill directory
- Following a step-by-step procedure defined in markdown
- Referencing documentation bundled with the skill
Persistence
Section titled “Persistence”/skills is a persistent volume. Skills survive restarts and upgrades. In local development, skills may be reset, but persistence avoids repeated skill bootstrap.
Built-in skills
Section titled “Built-in skills”Some skills are built into the runtime and available read-only. These are typically foundational workflows that ship with q15 itself.
Installing skills
Section titled “Installing skills”Skills can be installed through normal agent work (the agent fetches and places them) or manually by the operator. The directory structure under /skills is the source of truth — there is no separate skill registry to maintain.