@momentiq/dark-factory-cli 1.1.0 → 2.0.0

package/skills/skill-schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "DfSkillManifest",
+  "description": "Schema for a `skill.json` manifest in `packages/cli/skills/<name>/`. Each manifest declares the skill's metadata, the templated files that compose it, and the install-time variables those templates substitute.",
+  "type": "object",
+  "required": ["name", "version", "summary", "files", "variables"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Slug-form skill name. Must match the directory name and the `name:` field in the rendered SKILL.md frontmatter."
+    },
+    "version": {
+      "type": "string",
+      "description": "Skill source-of-truth version (independent of the CLI semver). Bumped when the template body changes meaningfully."
+    },
+    "summary": {
+      "type": "string",
+      "description": "One-line description of what the skill does. Surfaced by `df skills list`."
+    },
+    "originatingRepo": {
+      "type": "string",
+      "description": "Optional — `<owner>/<repo>` of the repo the skill was originally authored in. Provenance only; does not affect rendering."
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["template", "target"],
+        "additionalProperties": false,
+        "properties": {
+          "template": {
+            "type": "string",
+            "description": "Path of the `.tmpl` file relative to the skill source dir."
+          },
+          "target": {
+            "type": "string",
+            "description": "Path of the rendered file relative to the consumer's `.claude/skills/<name>/` install dir."
+          }
+        }
+      },
+      "minItems": 1,
+      "description": "Mapping of template-source files to install-target paths. The first entry conventionally renders SKILL.md."
+    },
+    "variables": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["description", "default"],
+        "additionalProperties": false,
+        "properties": {
+          "description": { "type": "string" },
+          "source": {
+            "type": "string",
+            "description": "Human-readable description of where the value is sourced from (e.g. 'darkfactory.yaml: repo.displayName')."
+          },
+          "default": {
+            "type": "string",
+            "description": "Default literal substituted when the consumer config does not provide a value. May be the empty string."
+          },
+          "kind": {
+            "type": "string",
+            "enum": ["scalar", "list"],
+            "description": "`scalar` (default) substitutes the value as-is. `list` accepts a YAML array from the consumer config and renders one element per line (used for QUALITY_GATE_TARGETS)."
+          }
+        }
+      },
+      "description": "Variable definitions. Each `{{VAR}}` reference in any template file MUST appear here, and the consumer config may override the default for any of them."
+    }
+  }
+}