Documentation

Skills

Inject reusable domain expertise into your agents with SKILL.md instruction packs.

← All guides

Skills are reusable SKILL.md instruction packs that give your agents domain expertise on demand. Sypha ships built-in skills, and you can add your own.

Where skills live

Project skills

.sypha/skills/<name>/SKILL.md — checked into your repo, shared with the team.

(.claude/skills/… is also picked up automatically.)

Global skills

~/.config/sypha/skills/<name>/SKILL.md — available across all your projects.

(~/.claude/skills/… is also picked up automatically.)

Adding a skill

  1. Create the folder and a SKILL.md file.
  2. Put the name and description in the front-matter, and the instructions in the body.
  3. Run /reload-skills — no restart needed.
---
name: pdf-forms
description: Fill and validate PDF form fields.
---

When asked to work with PDF forms, use the pdftk conventions below…
Skills are hot-reloaded — run /reload-skills and the new skill is available immediately.