@saulwade/swl-ses 1.6.0 → 1.6.3

package/schemas/skill-frontmatter.schema.json

@@ -1,170 +1,245 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://swl-ses.dev/schemas/skill-frontmatter.json",
-  "title": "SWL Skill Frontmatter",
-  "description": "Schema de validacion para el frontmatter YAML de skills del sistema SWL",
-  "type": "object",
-  "required": ["name", "description"],
-  "properties": {
-    "name": {
-      "type": "string",
-      "pattern": "^[a-z][a-z0-9-]+$",
-      "maxLength": 64,
-      "description": "Nombre en kebab-case que coincide con el directorio"
-    },
-    "description": {
-      "type": "string",
-      "minLength": 20,
-      "maxLength": 1024,
-      "description": "Descripcion que incluye QUE hace y CUANDO cargarla"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$"
-    },
-    "provenance": {
-      "type": "object",
-      "description": "Campo legacy. Equivalente espanol: 'procedencia'. Si ambos presentes deben coincidir (W010).",
-      "properties": {
-        "origin": {
-          "type": "string",
-          "enum": ["manual", "auto-evolution", "imported", "community"]
-        },
-        "created_at": {
-          "type": "string",
-          "format": "date"
-        },
-        "confidence": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1
-        },
-        "author": {
-          "type": "string"
-        }
-      }
-    },
-    "procedencia": {
-      "type": "object",
-      "description": "Alias en espanol de 'provenance'. Campo propio de swl-ses. Si ambos presentes, deben coincidir (W010).",
-      "properties": {
-        "origin": {
-          "type": "string",
-          "enum": ["manual", "auto-evolution", "imported", "community"]
-        },
-        "created_at": {
-          "type": "string",
-          "format": "date"
-        },
-        "confidence": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1
-        },
-        "author": {
-          "type": "string"
-        }
-      }
-    },
-    "targets": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["claude", "openclaude", "copilot", "opencode", "codex", "gemini"]
-      },
-      "description": "Campo legacy. Equivalente espanol: 'destinos'. Runtimes a los que se sincroniza este skill. Patron adoptado de skillshare (targets.yaml). Si ambos presentes deben coincidir (W010)."
-    },
-    "destinos": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["claude", "openclaude", "copilot", "opencode", "codex", "gemini"]
-      },
-      "description": "Alias en espanol de 'targets'. Campo propio de swl-ses. Runtimes a los que se sincroniza este skill."
-    },
-    "user-invocable": {
-      "type": "boolean",
-      "description": "Si el usuario puede invocar este skill directamente con Skill(nombre)"
-    },
-    "license": {
-      "type": "string",
-      "description": "Licencia del skill si es externo o adaptado"
-    },
-    "evolvable": {
-      "type": "boolean",
-      "description": "Campo legacy. Equivalente espanol: 'evolucionable'. Marca AGP learnability. Si false, el loop de auto-evolucion NO debe proponer cambios a este skill. Recomendado: false para skills criticos. Si ambos presentes deben coincidir (W010)."
-    },
-    "evolucionable": {
-      "type": "boolean",
-      "description": "Alias en espanol de 'evolvable'. Campo propio de swl-ses. Marca AGP learnability. Si false, el loop de auto-evolucion NO propone cambios a este skill."
-    },
-    "evolvable_scope": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["description", "content", "examples", "references", "anti-patterns"]
-      },
-      "description": "Campo legacy. Equivalente espanol: 'evolucionable_alcance'. Si evolvable=true, limita las secciones del SKILL.md que pueden modificarse. Ausente implica 'content' y 'examples' unicamente. Si ambos presentes deben coincidir (W010)."
-    },
-    "evolucionable_alcance": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["description", "content", "examples", "references", "anti-patterns"]
-      },
-      "description": "Alias en espanol de 'evolvable_scope'. Campo propio de swl-ses. Si evolucionable=true, limita las secciones modificables."
-    },
-    "when_to_use": {
-      "type": "string",
-      "maxLength": 512,
-      "description": "Campo del protocolo Anthropic. Contexto adicional sobre cuando activar la skill, leido por Claude Code como bloque combinado con description (total max 1536 chars). Usar cuando description ocupa mas de 900 chars y aun hay triggers que no caben."
-    },
-    "exclusiones": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Situaciones donde esta skill NO debe activarse aunque parezca relevante superficialmente. Campo propio de swl-ses; previene skill hijacking por similitud de terminos. Equivalente estructural de la seccion 'Cuando NO cargar' en el cuerpo de SKILL.md, legible por herramientas de analisis sin parsear markdown."
-    },
-    "allowed-tools": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["Read", "Write", "Edit", "Bash", "Glob", "Grep", "WebSearch", "WebFetch"]
-      },
-      "description": "Campo del protocolo Anthropic. Pre-aprobacion de UX leida por Claude Code. NO es restriccion de seguridad real. Las restricciones reales provienen de permission rules en .claude/settings.json o del matcher en hooks."
-    },
-    "herramientasPermitidas": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["Read", "Write", "Edit", "Bash", "Glob", "Grep", "WebSearch", "WebFetch"]
-      },
-      "description": "Campo propio de swl-ses. Alias semantico de allowed-tools, usado por las herramientas internas (evaluar-skill, validadores). Debe coincidir con allowed-tools cuando ambos estan presentes. Si divergen, el validador emite W011. Para skills nuevos en swl-ses, declarar solo este campo; una herramienta de sincronizacion propagara el valor a allowed-tools al construir artefactos para Claude Code."
-    },
-    "nist_csf": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^(GV|ID|PR|DE|RS|RC)\\.[A-Z]{2}(-[0-9]{2})?$" },
-      "description": "Campo propio de swl-ses. Mapeo a NIST Cybersecurity Framework 2.0. Cada entrada es un ID de subcategoria tipo 'GV.SC-07', 'PR.PS-01', 'DE.CM-01'. Opcional. Usado para reportes de cobertura en /swl:salud y /swl:dashboard. Referencia: https://www.nist.gov/cyberframework"
-    },
-    "nist_ai_rmf": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^(GOVERN|MAP|MEASURE|MANAGE)(-[0-9]+(\\.[0-9]+)?)?$" },
-      "description": "Campo propio de swl-ses. Mapeo a NIST AI Risk Management Framework 1.0. Cada entrada es un ID de subcategoria tipo 'GOVERN-1.1', 'MAP-5.1', 'MEASURE-2.7'. Opcional. Particularmente relevante para skills de seguridad de sistemas agenticos. Referencia: https://airc.nist.gov/AI_RMF"
-    },
-    "atlas_techniques": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^AML\\.T[0-9]{4}(\\.[0-9]{3})?$" },
-      "description": "Campo propio de swl-ses. Mapeo a MITRE ATLAS v5.4 (Adversarial Threat Landscape for AI Systems). Cada entrada es una tecnica tipo 'AML.T0051' (LLM Prompt Injection), 'AML.T0080' (AI Agent Context Poisoning). Opcional. Critico para skills que protegen el sistema agentico mismo. Referencia: https://atlas.mitre.org"
-    },
-    "attack_techniques": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^T[0-9]{4}(\\.[0-9]{3})?$" },
-      "description": "Campo propio de swl-ses. Mapeo a MITRE ATT&CK v18. Cada entrada es una tecnica tipo 'T1071' (Application Layer Protocol), 'T1190' (Exploit Public-Facing Application). Opcional. Mas aplicable a skills de defensa de infraestructura o deteccion de amenazas en el sistema desplegado. Referencia: https://attack.mitre.org"
-    },
-    "d3fend_techniques": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^D3-[A-Z]+$" },
-      "description": "Campo propio de swl-ses. Mapeo a MITRE D3FEND v1.3 (Defensive countermeasures). Cada entrada es una tecnica tipo 'D3-NTA' (Network Traffic Analysis), 'D3-PSA' (Process Spawn Analysis). Opcional. Referencia: https://d3fend.mitre.org"
-    }
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/skill-frontmatter.json",
+  "$schemaVersion": "1.0.0",
+  "title": "SWL Skill Frontmatter",
+  "description": "Schema de validacion para el frontmatter YAML de skills del sistema SWL",
+  "type": "object",
+  "required": [
+    "name",
+    "description"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]+$",
+      "maxLength": 64,
+      "description": "Nombre en kebab-case que coincide con el directorio"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 20,
+      "maxLength": 1024,
+      "description": "Descripcion que incluye QUE hace y CUANDO cargarla"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "provenance": {
+      "type": "object",
+      "description": "Campo legacy. Equivalente espanol: 'procedencia'. Si ambos presentes deben coincidir (W010).",
+      "properties": {
+        "origin": {
+          "type": "string",
+          "enum": [
+            "manual",
+            "auto-evolution",
+            "imported",
+            "community"
+          ]
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "author": {
+          "type": "string"
+        }
+      }
+    },
+    "procedencia": {
+      "type": "object",
+      "description": "Alias en espanol de 'provenance'. Campo propio de swl-ses. Si ambos presentes, deben coincidir (W010).",
+      "properties": {
+        "origin": {
+          "type": "string",
+          "enum": [
+            "manual",
+            "auto-evolution",
+            "imported",
+            "community"
+          ]
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "author": {
+          "type": "string"
+        }
+      }
+    },
+    "targets": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "claude",
+          "openclaude",
+          "copilot",
+          "opencode",
+          "codex",
+          "gemini"
+        ]
+      },
+      "description": "Campo legacy. Equivalente espanol: 'destinos'. Runtimes a los que se sincroniza este skill. Patron adoptado de skillshare (targets.yaml). Si ambos presentes deben coincidir (W010)."
+    },
+    "destinos": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "claude",
+          "openclaude",
+          "copilot",
+          "opencode",
+          "codex",
+          "gemini"
+        ]
+      },
+      "description": "Alias en espanol de 'targets'. Campo propio de swl-ses. Runtimes a los que se sincroniza este skill."
+    },
+    "user-invocable": {
+      "type": "boolean",
+      "description": "Si el usuario puede invocar este skill directamente con Skill(nombre)"
+    },
+    "license": {
+      "type": "string",
+      "description": "Licencia del skill si es externo o adaptado"
+    },
+    "evolvable": {
+      "type": "boolean",
+      "description": "Campo legacy. Equivalente espanol: 'evolucionable'. Marca AGP learnability. Si false, el loop de auto-evolucion NO debe proponer cambios a este skill. Recomendado: false para skills criticos. Si ambos presentes deben coincidir (W010)."
+    },
+    "evolucionable": {
+      "type": "boolean",
+      "description": "Alias en espanol de 'evolvable'. Campo propio de swl-ses. Marca AGP learnability. Si false, el loop de auto-evolucion NO propone cambios a este skill."
+    },
+    "evolvable_scope": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "description",
+          "content",
+          "examples",
+          "references",
+          "anti-patterns"
+        ]
+      },
+      "description": "Campo legacy. Equivalente espanol: 'evolucionable_alcance'. Si evolvable=true, limita las secciones del SKILL.md que pueden modificarse. Ausente implica 'content' y 'examples' unicamente. Si ambos presentes deben coincidir (W010)."
+    },
+    "evolucionable_alcance": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "description",
+          "content",
+          "examples",
+          "references",
+          "anti-patterns"
+        ]
+      },
+      "description": "Alias en espanol de 'evolvable_scope'. Campo propio de swl-ses. Si evolucionable=true, limita las secciones modificables."
+    },
+    "when_to_use": {
+      "type": "string",
+      "maxLength": 512,
+      "description": "Campo del protocolo Anthropic. Contexto adicional sobre cuando activar la skill, leido por Claude Code como bloque combinado con description (total max 1536 chars). Usar cuando description ocupa mas de 900 chars y aun hay triggers que no caben."
+    },
+    "exclusiones": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Situaciones donde esta skill NO debe activarse aunque parezca relevante superficialmente. Campo propio de swl-ses; previene skill hijacking por similitud de terminos. Equivalente estructural de la seccion 'Cuando NO cargar' en el cuerpo de SKILL.md, legible por herramientas de analisis sin parsear markdown."
+    },
+    "allowed-tools": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "Read",
+          "Write",
+          "Edit",
+          "Bash",
+          "Glob",
+          "Grep",
+          "WebSearch",
+          "WebFetch"
+        ]
+      },
+      "description": "Campo del protocolo Anthropic. Pre-aprobacion de UX leida por Claude Code. NO es restriccion de seguridad real. Las restricciones reales provienen de permission rules en .claude/settings.json o del matcher en hooks."
+    },
+    "herramientasPermitidas": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "Read",
+          "Write",
+          "Edit",
+          "Bash",
+          "Glob",
+          "Grep",
+          "WebSearch",
+          "WebFetch"
+        ]
+      },
+      "description": "Campo propio de swl-ses. Alias semantico de allowed-tools, usado por las herramientas internas (evaluar-skill, validadores). Debe coincidir con allowed-tools cuando ambos estan presentes. Si divergen, el validador emite W011. Para skills nuevos en swl-ses, declarar solo este campo; una herramienta de sincronizacion propagara el valor a allowed-tools al construir artefactos para Claude Code."
+    },
+    "nist_csf": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^(GV|ID|PR|DE|RS|RC)\\.[A-Z]{2}(-[0-9]{2})?$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a NIST Cybersecurity Framework 2.0. Cada entrada es un ID de subcategoria tipo 'GV.SC-07', 'PR.PS-01', 'DE.CM-01'. Opcional. Usado para reportes de cobertura en /swl:salud y /swl:dashboard. Referencia: https://www.nist.gov/cyberframework"
+    },
+    "nist_ai_rmf": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^(GOVERN|MAP|MEASURE|MANAGE)(-[0-9]+(\\.[0-9]+)?)?$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a NIST AI Risk Management Framework 1.0. Cada entrada es un ID de subcategoria tipo 'GOVERN-1.1', 'MAP-5.1', 'MEASURE-2.7'. Opcional. Particularmente relevante para skills de seguridad de sistemas agenticos. Referencia: https://airc.nist.gov/AI_RMF"
+    },
+    "atlas_techniques": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^AML\\.T[0-9]{4}(\\.[0-9]{3})?$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a MITRE ATLAS v5.4 (Adversarial Threat Landscape for AI Systems). Cada entrada es una tecnica tipo 'AML.T0051' (LLM Prompt Injection), 'AML.T0080' (AI Agent Context Poisoning). Opcional. Critico para skills que protegen el sistema agentico mismo. Referencia: https://atlas.mitre.org"
+    },
+    "attack_techniques": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^T[0-9]{4}(\\.[0-9]{3})?$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a MITRE ATT&CK v18. Cada entrada es una tecnica tipo 'T1071' (Application Layer Protocol), 'T1190' (Exploit Public-Facing Application). Opcional. Mas aplicable a skills de defensa de infraestructura o deteccion de amenazas en el sistema desplegado. Referencia: https://attack.mitre.org"
+    },
+    "d3fend_techniques": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^D3-[A-Z]+$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a MITRE D3FEND v1.3 (Defensive countermeasures). Cada entrada es una tecnica tipo 'D3-NTA' (Network Traffic Analysis), 'D3-PSA' (Process Spawn Analysis). Opcional. Referencia: https://d3fend.mitre.org"
+    }
+  },
+  "additionalProperties": true
+}