empirical skill.

Publish authored SKILL.md files into a Kit, inspect their version history, and roll back to a known-good version.

SKILL.md format

Every Skill must start with YAML frontmatter containing both name and description. The frontmatter is required for agent loaders and is validated before upload.

---
name: my-skill
description: Explain when this skill should be used.
---

# My Skill

Instructions for the agent go here.

Push a Skill

List the Skills visible through your Kits, or push a local authored Skill into the Default Kit or a named Kit. After pushing, activate or sync that Kit on each device that should receive it.

empirical skill push path/to/SKILL.md
empirical skill push path/to/SKILL.md --kit "My Team Kit"
empirical skill list
empirical kit sync

History and rollback

Use the authored Skill identifier returned by push to inspect versions or restore a previous version.

empirical skill history <authored-skill-id>
empirical skill rollback <authored-skill-id> --to-version 2

Boundary: A Skill must meet the loader's frontmatter requirements. Rollback affects the Kit version; it does not rewrite a local file automatically.

Last updated: July 24, 2026