Skill Spec

The skill spec defines how AI agent skills are structured, discovered, and installed. Every skill has a SKILL.md entry point.

SKILL.md format

A skill is defined by a SKILL.md file with YAML frontmatter and markdown content:

SKILL.md

---
name: deploy-checker
description: Validates deployment configurations
version: 2.1.0
author: acme
license: MIT
compatibility:
  - claude-code
  - cursor
  - windsurf
---

# Deploy Checker

You are a deployment validation specialist.

## Instructions

When asked to review a deployment configuration...

Frontmatter fields

nameUnique skill identifier (kebab-case)(required)

descriptionShort description of what the skill does(required)

versionSemantic version (e.g. 2.1.0)

authorSkill author or organisation

licenseSPDX license identifier

compatibilityList of compatible agent IDs

Directory structure

Skills are installed to a canonical directory and automatically connected to each detected agent:

.agentver/
  manifest.json        # Installed packages
  lockfile.json        # Integrity hashes
  skills/
    deploy-checker/    # Canonical location
      SKILL.md
      ...