Custom Skills

A skill is a Markdown instruction file stored under ~/.agents/skills/<skill-id>/SKILL.md. The file contains a name, a description, and the instructions themselves.

Skills are plaintext files. They are not stored in Sythoria's encrypted application data.

How the model uses a skill#

Sythoria adds the available skill names and descriptions to the tool-loop prompt. The model can call read_skill when a skill looks relevant. The full skill is added to that run only after the tool call.

There is no control for attaching a skill to one conversation or project in v0.4.4. Skills are available from the shared catalog whenever the tool loop is active.

Create or edit a skill#

Open Settings > Custom Skills. Give the skill a short name, explain when it should be used, and write instructions that can be followed without guessing.

# Review a TypeScript change
 
- Read the changed files and nearby tests.
- Stay inside the named package.
- Report problems with file and line references.
- Run the package's existing test command after approved edits.

Keep one job per skill. State required inputs, allowed tools, expected output, and when the model should stop.

Privacy and backup#

Do not put API keys, tokens, certificates, or private customer data in a skill. Once the model reads a skill, its contents can be sent to the selected hosted provider as part of the request context.

Sythoria does not provide skill import or export controls in v0.4.4. Back up the ~/.agents/skills directory yourself if the files matter to you.