skill-master/schemas/recommend.v1.schema.json at main · BenedictKing/skill-master · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://github.com/BenedictKing/skill-master/schemas/recommend.v1.schema.json",
  "title": "skill-master recommend --json v1",
  "type": "object",
  "additionalProperties": false,
  "required": ["task", "preferences", "recommendations"],
  "properties": {
    "task": { "$ref": "#/$defs/taskRequirement" },
    "preferences": { "$ref": "#/$defs/recommendationPreferences" },
    "recommendations": {
      "type": "array",
      "items": { "$ref": "#/$defs/recommendation" }
    }
  },
  "$defs": {
    "capability": {
      "type": "string",
      "enum": [
        "shell",
        "read_file",
        "write_file",
        "edit_file",
        "find_file",
        "search_content",
        "sub_task",
        "web_fetch",
        "web_search"
      ]
    },
    "candidateProvider": {
      "type": "string",
      "enum": ["skills.sh", "github", "local", "node_modules", "plugin-manifest", "registry", "gh-skill", "vercel", "well-known"]
    },
    "candidateRiskLevel": {
      "type": "string",
      "enum": ["low", "medium", "high"]
    },
    "installComplexity": {
      "type": "string",
      "enum": ["low", "medium", "high"]
    },
    "recommendationTier": {
      "type": "string",
      "enum": ["best", "conservative", "aggressive"]
    },
    "parsedSource": {
      "type": "object",
      "additionalProperties": false,
      "required": ["type"],
      "properties": {
        "type": { "type": "string", "enum": ["git", "local"] },
        "url": { "type": "string" },
        "path": { "type": "string" },
        "ref": { "type": "string" },
        "subpath": { "type": "string" },
        "skillFilter": { "type": "string" }
      }
    },
    "skillFrontmatter": {
      "type": "object",
      "additionalProperties": true,
      "required": ["name"],
      "properties": {
        "name": { "type": "string" },
        "version": { "type": "string" },
        "author": { "type": "string" },
        "description": { "type": "string" },
        "allowed-tools": {
          "type": "array",
          "items": { "type": "string" }
        },
        "user-invocable": { "type": "boolean" },
        "context": { "type": "string", "enum": ["fork"] },
        "capabilities": {
          "type": "array",
          "items": { "$ref": "#/$defs/capability" }
        },
        "disable-model-invocation": { "type": "boolean" },
        "argument-hint": { "type": "string" },
        "model": { "type": "string" },
        "agent": { "type": "string" },
        "hooks": { "type": "object" }
      }
    },
    "taskRequirement": {
      "type": "object",
      "additionalProperties": false,
      "required": ["raw", "normalized", "keywords", "capabilities", "riskTolerance", "installPreference"],
      "properties": {
        "raw": { "type": "string" },
        "normalized": { "type": "string" },
        "keywords": { "type": "array", "items": { "type": "string" } },
        "capabilities": { "type": "array", "items": { "$ref": "#/$defs/capability" } },
        "preferredAgent": { "type": "string" },
        "riskTolerance": { "$ref": "#/$defs/candidateRiskLevel" },
        "installPreference": { "type": "string", "enum": ["existing-only", "adapt", "compose"] }
      }
    },
    "recommendationPreferences": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "safe": { "type": "boolean" },
        "localFirst": { "type": "boolean" },
        "noRemote": { "type": "boolean" },
        "preferInstalled": { "type": "boolean" }
      }
    },
    "skillCandidate": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "provider", "name", "source", "installHint", "capabilities", "allowedTools", "envKeys", "issues", "warnings"],
      "properties": {
        "id": { "type": "string" },
        "provider": { "$ref": "#/$defs/candidateProvider" },
        "name": { "type": "string" },
        "source": { "type": "string" },
        "installHint": { "type": "string" },
        "description": { "type": "string" },
        "version": { "type": "string" },
        "author": { "type": "string" },
        "path": { "type": "string" },
        "providerMeta": {
          "type": "object",
          "additionalProperties": {
            "type": ["string", "number", "boolean", "null"]
          }
        },
        "pluginName": { "type": "string" },
        "parsedSource": { "$ref": "#/$defs/parsedSource" },
        "frontmatter": { "$ref": "#/$defs/skillFrontmatter" },
        "capabilities": { "type": "array", "items": { "$ref": "#/$defs/capability" } },
        "allowedTools": { "type": "array", "items": { "type": "string" } },
        "envKeys": { "type": "array", "items": { "type": "string" } },
        "issues": { "type": "array", "items": { "type": "string" } },
        "warnings": { "type": "array", "items": { "type": "string" } },
        "updatedAt": { "type": "string" },
        "installs": { "type": "number" },
        "installed": { "type": "boolean" }
      }
    },
    "evaluationReport": {
      "type": "object",
      "additionalProperties": false,
      "required": ["candidateId", "matchScore", "qualityScore", "maintenanceScore", "safetyScore", "overallScore", "installComplexity", "riskLevel", "strengths", "risks", "missingCapabilities", "matchedCapabilities", "notes"],
      "properties": {
        "candidateId": { "type": "string" },
        "matchScore": { "type": "number" },
        "qualityScore": { "type": "number" },
        "maintenanceScore": { "type": "number" },
        "safetyScore": { "type": "number" },
        "overallScore": { "type": "number" },
        "installComplexity": { "$ref": "#/$defs/installComplexity" },
        "riskLevel": { "$ref": "#/$defs/candidateRiskLevel" },
        "strengths": { "type": "array", "items": { "type": "string" } },
        "risks": { "type": "array", "items": { "type": "string" } },
        "missingCapabilities": { "type": "array", "items": { "$ref": "#/$defs/capability" } },
        "matchedCapabilities": { "type": "array", "items": { "$ref": "#/$defs/capability" } },
        "notes": { "type": "array", "items": { "type": "string" } }
      }
    },
    "recommendation": {
      "type": "object",
      "additionalProperties": false,
      "required": ["tier", "candidate", "evaluation", "rationale"],
      "properties": {
        "tier": { "$ref": "#/$defs/recommendationTier" },
        "candidate": { "$ref": "#/$defs/skillCandidate" },
        "evaluation": { "$ref": "#/$defs/evaluationReport" },
        "rationale": { "type": "array", "items": { "type": "string" } }
      }
    }
  }
}