Adding Skills

Skills are slash commands defined as SKILL.md files inside skills/<skill-name>/ directories.

File Format

Create skills/my-skill/SKILL.md:

---
name: my-skill
description: >
  What this skill does and when to use it.
disable-model-invocation: true
allowed-tools: Bash(dotnet *), Read, Glob, Grep
---

# My Skill

Instructions for the skill in markdown...

Frontmatter Fields

Field Required Description
name No Defaults to directory name
description Recommended Drives auto-invocation
disable-model-invocation No Set true for manual-only skills
allowed-tools No Tool restrictions for this skill
context No fork to run in a forked subagent
agent No Subagent type when context: fork

Best Practices

  • Use disable-model-invocation: true for workflows that should only run when explicitly requested
  • Use context: fork with agent: reviewer for read-only analysis skills
  • Include step-by-step instructions with pass/fail criteria
  • Use $ARGUMENTS to accept user input

This site uses Just the Docs, a documentation theme for Jekyll.