files/create-skill.skill.json

{
  "id": "create-skill",
  "name": "Create Skill",
  "version": "0.1.0",
  "purpose": "Meta-skill used by Luuna Skill Forge to draft any new capability package as a valid Universal Capability Object (UCA), then generate its provider and runtime adapters.",
  "category": "developer tools",
  "origin": "internal",
  "status": "active",
  "triggers": [
    "I need a skill that ...",
    "create a new capability for ...",
    "there's no existing package for ..."
  ],
  "inputs": [
    { "name": "user_goal", "type": "string", "required": true, "description": "Plain-language description of the missing capability." },
    { "name": "target_formats", "type": "string[]", "required": false, "description": "Requested provider/runtime targets. Defaults to all supported targets if omitted." }
  ],
  "outputs": [
    { "name": "uca_instance", "type": "json", "description": "New capability object validated against schemas/universal-skill.schema.json." },
    { "name": "provider_adapters", "type": "file[]", "description": "One artifact per requested provider (see adapters/provider-adapter-map.md)." },
    { "name": "runtime_adapters", "type": "file[]", "description": "One artifact per requested runtime (see adapters/runtime-adapter-map.md)." },
    { "name": "registry_entry", "type": "json", "description": "Entry appended to registry/skills.index.json." }
  ],
  "context_needed": [
    "registry/skills.index.json (avoid duplicating an existing skill)",
    "schemas/universal-skill.schema.json (structure to fill)",
    "adapters/provider-adapter-map.md",
    "adapters/runtime-adapter-map.md"
  ],
  "steps": [
    "Restate the user's goal as a single capability intent sentence.",
    "Check registry/skills.index.json and external catalogs for an existing or near match.",
    "If a close match exists, propose adapting it instead of creating a duplicate.",
    "If no match exists, draft a new UCA instance covering all required schema fields.",
    "Run trust and validation checks (dry_run_test, schema_test, real_usage_example).",
    "Generate adapters only for the requested target_formats (or all, if unspecified).",
    "Append the new skill to registry/skills.index.json at status 'proposed'.",
    "Return the full response in the 8-part format: Capability intent, Existing match, External candidates, Best route, Target formats, Adapter notes, Validation notes, Registry entry."
  ],
  "validation": {
    "dry_run_test": "Instantiate the UCA fields against schemas/universal-skill.schema.json and confirm all required properties are present.",
    "schema_test": "Validate JSON against the schema with a standard validator (e.g. ajv, jsonschema).",
    "real_usage_example": "Walk through one realistic user request end-to-end and confirm each step in `steps` produces the declared output."
  },
  "permissions": ["filesystem_write"],
  "adapters": {
    "providers": ["OpenAI", "Claude", "Gemini", "LM Studio", "Ollama", "OpenRouter", "Hugging Face"],
    "runtimes": ["Python", "Node.js", "MCP"]
  },
  "trust_level": "official",
  "notes": "This is the meta-skill: it never gets 'used' directly by an end user, only invoked internally by Luuna Skill Forge when a Capability Detector step reports no existing match."
}