files/universal-skill.schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://huggingface.co/datasets/techprotrade/luuna-provider-skill-kit/schemas/universal-skill.schema.json",
  "title": "Universal Capability Object (UCA)",
  "description": "Neutral, provider-agnostic definition of a single Luuna capability/skill. Every adapter (provider or runtime) is generated FROM this object, never authored independently.",
  "type": "object",
  "required": ["id", "name", "purpose", "category", "status", "triggers", "inputs", "outputs", "steps"],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
      "description": "Stable kebab-case identifier, e.g. 'luuna-capability-radar'."
    },
    "name": { "type": "string" },
    "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$", "default": "0.1.0" },
    "purpose": { "type": "string", "description": "One or two sentences: what this skill accomplishes and why it exists." },
    "category": {
      "type": "string",
      "enum": [
        "browser", "files", "terminal", "code", "media", "voice", "memory",
        "search", "business", "finance", "automation", "messaging",
        "calendar", "local device control", "developer tools",
        "AI model routing", "MCP connector"
      ]
    },
    "origin": {
      "type": "string",
      "enum": ["internal", "AgentSkills", "OpenClaw", "Hermes", "MCP marketplace", "NVIDIA Skills", "ModelScope", "MiniMax", "GitHub", "Hugging Face", "other"]
    },
    "status": {
      "type": "string",
      "enum": ["draft", "validated", "installed", "active", "deprecated", "replaced"]
    },
    "triggers": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Trigger phrases or intent patterns that should activate this skill."
    },
    "inputs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["name", "type"],
        "properties": {
          "name": { "type": "string" },
          "type": { "type": "string" },
          "required": { "type": "boolean", "default": true },
          "description": { "type": "string" }
        }
      }
    },
    "outputs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["name", "type"],
        "properties": {
          "name": { "type": "string" },
          "type": { "type": "string" },
          "description": { "type": "string" }
        }
      }
    },
    "context_needed": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Information/state that must be available before execution (files, credentials, prior steps)."
    },
    "steps": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Ordered execution steps in plain language."
    },
    "validation": {
      "type": "object",
      "properties": {
        "dry_run_test": { "type": "string" },
        "schema_test": { "type": "string" },
        "real_usage_example": { "type": "string" }
      }
    },
    "permissions": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": ["filesystem_read", "filesystem_write", "network", "command_execution", "credentials", "none"]
      }
    },
    "dependencies": {
      "type": "array",
      "items": { "type": "string" }
    },
    "adapters": {
      "type": "object",
      "properties": {
        "providers": {
          "type": "array",
          "items": { "type": "string", "enum": ["OpenAI", "Claude", "Gemini", "LM Studio", "Ollama", "OpenRouter", "Hugging Face"] }
        },
        "runtimes": {
          "type": "array",
          "items": { "type": "string", "enum": ["Python", "Node.js", "FastAPI", "Tauri", "React", "PowerShell", "Bash", "Docker", "n8n", "CrewAI", "LangGraph", "MCP"] }
        }
      }
    },
    "formats": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": ["Markdown", "JSON", "YAML", "OpenAI tool schema", "Claude instruction", "Gemini instruction", "LM Studio prompt", "Ollama Modelfile", "MCP tool note", "n8n note", "CrewAI task", "LangGraph node"]
      }
    },
    "trust_level": {
      "type": "string",
      "enum": ["official", "verified", "community", "unverified"]
    },
    "install_notes": { "type": "string" },
    "notes": { "type": "string" },
    "tests": {
      "type": "array",
      "items": { "type": "string" }
    },
    "source_registry": { "type": "string" }
  }
}