Files
skillkit/schemas/skill.schema.json
Rohit Ghumare 088b9bad4e Initial release v1.0.0 - Universal skills loader for AI agents
Features:
- Multi-agent support: Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Antigravity
- Multi-platform Git: GitHub, GitLab, Bitbucket, local paths
- Agent Skills spec compliance (agentskills.io)
- Skill toggle, validation, and CI/CD support
- Programmatic API for library usage
2026-01-20 15:42:51 +00:00

63 lines
2.0 KiB
JSON

{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://skillkit.dev/schemas/skill.schema.json",
"title": "Skill Frontmatter",
"description": "Schema for SKILL.md frontmatter validation (follows Agent Skills spec: https://agentskills.io/specification)",
"type": "object",
"required": ["name", "description"],
"properties": {
"name": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"minLength": 1,
"maxLength": 64,
"description": "Unique skill identifier. Lowercase alphanumeric with hyphens, no leading/trailing/consecutive hyphens."
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 1024,
"description": "What the skill does and when to use it."
},
"license": {
"type": "string",
"description": "License name or reference to bundled license file."
},
"compatibility": {
"type": "string",
"maxLength": 500,
"description": "Environment requirements (intended product, system packages, network access, etc.)."
},
"metadata": {
"type": "object",
"additionalProperties": { "type": "string" },
"description": "Arbitrary key-value mapping for additional metadata."
},
"allowed-tools": {
"type": "string",
"description": "Space-delimited list of pre-approved tools the skill may use (experimental)."
},
"version": {
"type": "string",
"description": "Semantic version (e.g., 1.0.0)"
},
"author": {
"type": "string",
"description": "Skill author name or organization"
},
"tags": {
"type": "array",
"items": { "type": "string" },
"description": "Categorization tags"
},
"agents": {
"type": "array",
"items": {
"type": "string",
"enum": ["claude-code", "codex", "cursor", "antigravity", "opencode", "gemini-cli", "universal"]
},
"description": "Compatible AI agents (empty = all agents)"
}
}
}