Skill Creator

Guidance for authoring effective DeepTutor skills.

What a skill is

A skill is a self-contained capability package: a SKILL.md playbook plus optional references/ files. The system prompt only carries each skill's name + description; the model fetches the full body with the read_skill tool when a task matches. Skills teach procedural knowledge — workflows, domain expertise, format conventions — that no model fully possesses.

Behaviour/voice presets (tone, teaching style) are NOT skills — those are personas, managed separately.

Anatomy

my-skill/
├── SKILL.md          (required: frontmatter + instructions)
└── references/       (optional: docs loaded on demand via read_skill)

Frontmatter schema:

---
name: my-skill            # lowercase, digits, hyphens; max 64 chars
description: One line stating WHAT it does and WHEN to use it.
tags: [tool]              # optional, user-facing organisation
always: false             # optional: eager-inject into every turn
requires:                 # optional availability gates
  bins: [git]             # host CLI binaries
  env: [GITHUB_TOKEN]     # environment variables
  sandbox: shell          # n…