@skill-graph/cli 0.5.7 → 0.5.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/CHANGELOG.md +27 -3
  2. package/README.md +40 -14
  3. package/SKILL_GRAPH.md +2 -2
  4. package/bin/skill-graph.js +118 -2
  5. package/docs/ADOPTION.md +1 -1
  6. package/docs/PRIMER.md +6 -5
  7. package/docs/QUICKSTART-30MIN.md +2 -2
  8. package/docs/SKILL_AUDIT_CHECKLIST.md +1 -1
  9. package/docs/SKILL_METADATA_PROTOCOL.md +2 -2
  10. package/docs/_archived/marketplace-publication-priority-2026-05-18.md +1 -1
  11. package/docs/_drafts/0.5.8-release-prep.md +164 -0
  12. package/docs/field-reference.generated.md +1 -1
  13. package/docs/field-reference.md +2 -2
  14. package/docs/manifest-field-mapping.md +3 -3
  15. package/docs/marketplace-publication-queue.generated.md +2 -2
  16. package/docs/plans/scripts-roadmap.md +2 -2
  17. package/docs/positioning.md +88 -0
  18. package/docs/research/skill-comprehension-eval-research.md +5 -5
  19. package/docs/research/skill-demand-gap-roadmap-2026-05-16.md +215 -0
  20. package/docs/status.generated.md +48 -0
  21. package/examples/audits/context-graph/findings.md +59 -0
  22. package/examples/audits/context-graph/scorecard.md +22 -0
  23. package/examples/audits/context-graph/verdict.md +33 -0
  24. package/examples/evals/a11y.json +45 -13
  25. package/examples/evals/api-design.json +18 -5
  26. package/examples/evals/code-review.json +18 -5
  27. package/examples/evals/data-modeling.json +18 -5
  28. package/examples/evals/database-migration.json +18 -5
  29. package/examples/evals/debugging.json +37 -11
  30. package/examples/evals/dependency-architecture.json +18 -5
  31. package/examples/evals/design-system-architecture.json +18 -5
  32. package/examples/evals/error-tracking.json +18 -5
  33. package/examples/evals/event-contract-design.json +18 -5
  34. package/examples/evals/form-ux-architecture.json +18 -5
  35. package/examples/evals/framework-fit-analysis.json +18 -5
  36. package/examples/evals/graph-audit.json +55 -13
  37. package/examples/evals/information-architecture.json +18 -5
  38. package/examples/evals/interaction-feedback.json +18 -5
  39. package/examples/evals/interaction-patterns.json +18 -5
  40. package/examples/evals/layout-composition.json +18 -5
  41. package/examples/evals/lint-overlay.json +38 -11
  42. package/examples/evals/microcopy.json +18 -5
  43. package/examples/evals/observability-modeling.json +18 -5
  44. package/examples/evals/pattern-recognition.json +32 -9
  45. package/examples/evals/performance-engineering.json +18 -5
  46. package/examples/evals/refactor.json +41 -12
  47. package/examples/evals/semiotics.json +18 -5
  48. package/examples/evals/skill-infrastructure.json +32 -9
  49. package/examples/evals/skill-router.json +42 -13
  50. package/examples/evals/system-interface-contracts.json +18 -5
  51. package/examples/evals/task-analysis.json +18 -5
  52. package/examples/evals/testing-strategy.json +36 -11
  53. package/examples/evals/type-safety.json +251 -66
  54. package/examples/evals/visual-design-foundations.json +18 -5
  55. package/examples/evals/webhook-integration.json +18 -5
  56. package/examples/fixture-skills/README.md +47 -0
  57. package/examples/fixture-skills/comprehension-full/SKILL.md +79 -0
  58. package/examples/fixture-skills/minimal-capability/SKILL.md +51 -0
  59. package/examples/fixture-skills/with-grounding/SKILL.md +78 -0
  60. package/examples/fixture-skills/with-relations/SKILL.md +87 -0
  61. package/examples/skills.manifest.sample.json +1722 -446
  62. package/marketplace/README.md +1 -1
  63. package/marketplace/skills/a11y/SKILL.md +1 -1
  64. package/marketplace/skills/best-practice/SKILL.md +211 -0
  65. package/marketplace/skills/context-graph/SKILL.md +1 -1
  66. package/marketplace/skills/debugging/SKILL.md +1 -1
  67. package/marketplace/skills/graph-audit/SKILL.md +3 -1
  68. package/marketplace/skills/postgres-rls/SKILL.md +284 -0
  69. package/marketplace/skills/refactor/SKILL.md +1 -1
  70. package/marketplace/skills/skill-infrastructure/SKILL.md +2 -0
  71. package/marketplace/skills/skill-router/SKILL.md +3 -1
  72. package/marketplace/skills/testing-strategy/SKILL.md +1 -1
  73. package/package.json +3 -1
  74. package/scripts/__tests__/test-marketplace-export.js +6 -2
  75. package/scripts/__tests__/test-v3-1-alias-contract.js +3 -3
  76. package/scripts/build-status-doc.js +177 -0
  77. package/scripts/check-doc-drift.js +224 -0
  78. package/scripts/check-markdown-links.js +34 -4
  79. package/scripts/check-mirror-freeze.js +270 -0
  80. package/scripts/export-marketplace-skills.js +35 -6
  81. package/scripts/lib/audit-prompt-builder.js +3 -3
  82. package/scripts/lib/parse-frontmatter.js +2 -2
  83. package/scripts/skill-audit.js +7 -9
@@ -1,7 +1,12 @@
1
1
  {
2
2
  "skill_name": "pattern-recognition",
3
3
  "subject": "Recurring-structure recognition across code, errors, board state, conventions, and domain encodings",
4
- "adjacent_concepts": ["debugging", "code-review", "diagnosis", "lint-overlay"],
4
+ "adjacent_concepts": [
5
+ "debugging",
6
+ "code-review",
7
+ "diagnosis",
8
+ "lint-overlay"
9
+ ],
5
10
  "grounding_note": "This portable skill is grounded in its own method description and cited public pattern-recognition sources rather than repo-local implementation files. These evals exercise the recurring-instance threshold, clustering discipline, prevention loop, lifecycle states, and negative-routing boundaries.",
6
11
  "evals": [
7
12
  {
@@ -13,7 +18,9 @@
13
18
  "truth_mode": "conceptual_correctness_plus_repo_application",
14
19
  "skill_type": "concept",
15
20
  "criticality": "high",
16
- "truth_sources": ["skills/pattern-recognition/SKILL.md:61-80"]
21
+ "truth_sources": [
22
+ "skills/foundations/pattern-recognition/SKILL.md:61-80"
23
+ ]
17
24
  },
18
25
  {
19
26
  "id": 2,
@@ -24,7 +31,10 @@
24
31
  "truth_mode": "conceptual_correctness_plus_repo_application",
25
32
  "skill_type": "concept",
26
33
  "criticality": "normal",
27
- "truth_sources": ["skills/pattern-recognition/SKILL.md:72-80", "skills/pattern-recognition/SKILL.md:462-481"]
34
+ "truth_sources": [
35
+ "skills/foundations/pattern-recognition/SKILL.md:72-80",
36
+ "skills/foundations/pattern-recognition/SKILL.md:462-481"
37
+ ]
28
38
  },
29
39
  {
30
40
  "id": 3,
@@ -35,7 +45,9 @@
35
45
  "truth_mode": "conceptual_correctness_plus_repo_application",
36
46
  "skill_type": "concept",
37
47
  "criticality": "high",
38
- "truth_sources": ["skills/pattern-recognition/SKILL.md:233-279"]
48
+ "truth_sources": [
49
+ "skills/foundations/pattern-recognition/SKILL.md:233-279"
50
+ ]
39
51
  },
40
52
  {
41
53
  "id": 4,
@@ -46,7 +58,9 @@
46
58
  "truth_mode": "conceptual_correctness_plus_repo_application",
47
59
  "skill_type": "concept",
48
60
  "criticality": "normal",
49
- "truth_sources": ["skills/pattern-recognition/SKILL.md:155-187"]
61
+ "truth_sources": [
62
+ "skills/foundations/pattern-recognition/SKILL.md:155-187"
63
+ ]
50
64
  },
51
65
  {
52
66
  "id": 5,
@@ -57,7 +71,9 @@
57
71
  "truth_mode": "conceptual_correctness_plus_repo_application",
58
72
  "skill_type": "concept",
59
73
  "criticality": "normal",
60
- "truth_sources": ["skills/pattern-recognition/SKILL.md:197-231"]
74
+ "truth_sources": [
75
+ "skills/foundations/pattern-recognition/SKILL.md:197-231"
76
+ ]
61
77
  },
62
78
  {
63
79
  "id": 6,
@@ -68,7 +84,10 @@
68
84
  "truth_mode": "conceptual_correctness_plus_repo_application",
69
85
  "skill_type": "concept",
70
86
  "criticality": "critical",
71
- "truth_sources": ["skills/pattern-recognition/SKILL.md:281-329", "skills/pattern-recognition/SKILL.md:366-395"]
87
+ "truth_sources": [
88
+ "skills/foundations/pattern-recognition/SKILL.md:281-329",
89
+ "skills/foundations/pattern-recognition/SKILL.md:366-395"
90
+ ]
72
91
  },
73
92
  {
74
93
  "id": 7,
@@ -79,7 +98,9 @@
79
98
  "truth_mode": "conceptual_correctness_plus_repo_application",
80
99
  "skill_type": "concept",
81
100
  "criticality": "normal",
82
- "truth_sources": ["skills/pattern-recognition/SKILL.md:397-429"]
101
+ "truth_sources": [
102
+ "skills/foundations/pattern-recognition/SKILL.md:397-429"
103
+ ]
83
104
  },
84
105
  {
85
106
  "id": 8,
@@ -90,7 +111,9 @@
90
111
  "truth_mode": "conceptual_correctness_plus_repo_application",
91
112
  "skill_type": "concept",
92
113
  "criticality": "normal",
93
- "truth_sources": ["skills/pattern-recognition/SKILL.md:483-494"]
114
+ "truth_sources": [
115
+ "skills/foundations/pattern-recognition/SKILL.md:483-494"
116
+ ]
94
117
  }
95
118
  ]
96
119
  }
@@ -1,7 +1,12 @@
1
1
  {
2
2
  "skill_name": "performance-engineering",
3
3
  "subject": "Performance measurement and improvement for latency, throughput, Core Web Vitals, database queries, caching, bundle size, concurrency, resource use, and regressions",
4
- "adjacent_concepts": ["observability-modeling", "testing-strategy", "api-design", "data-modeling"],
4
+ "adjacent_concepts": [
5
+ "observability-modeling",
6
+ "testing-strategy",
7
+ "api-design",
8
+ "data-modeling"
9
+ ],
5
10
  "grounding_note": "Truth sources cite the whole SKILL.md file to keep the initial eval surface stable while routing boundaries are tightened.",
6
11
  "evals": [
7
12
  {
@@ -13,7 +18,9 @@
13
18
  "truth_mode": "process_correctness",
14
19
  "skill_type": "concept",
15
20
  "criticality": "high",
16
- "truth_sources": ["skills/performance-engineering/SKILL.md"]
21
+ "truth_sources": [
22
+ "skills/quality/performance-engineering/SKILL.md"
23
+ ]
17
24
  },
18
25
  {
19
26
  "id": 2,
@@ -24,7 +31,9 @@
24
31
  "truth_mode": "conceptual_correctness_plus_repo_application",
25
32
  "skill_type": "concept",
26
33
  "criticality": "high",
27
- "truth_sources": ["skills/performance-engineering/SKILL.md"]
34
+ "truth_sources": [
35
+ "skills/quality/performance-engineering/SKILL.md"
36
+ ]
28
37
  },
29
38
  {
30
39
  "id": 3,
@@ -35,7 +44,9 @@
35
44
  "truth_mode": "code_verification",
36
45
  "skill_type": "concept",
37
46
  "criticality": "normal",
38
- "truth_sources": ["skills/performance-engineering/SKILL.md"]
47
+ "truth_sources": [
48
+ "skills/quality/performance-engineering/SKILL.md"
49
+ ]
39
50
  },
40
51
  {
41
52
  "id": 4,
@@ -46,7 +57,9 @@
46
57
  "truth_mode": "code_verification",
47
58
  "skill_type": "concept",
48
59
  "criticality": "normal",
49
- "truth_sources": ["skills/performance-engineering/SKILL.md"]
60
+ "truth_sources": [
61
+ "skills/quality/performance-engineering/SKILL.md"
62
+ ]
50
63
  }
51
64
  ]
52
65
  }
@@ -1,7 +1,11 @@
1
1
  {
2
2
  "skill_name": "refactor",
3
3
  "subject": "Behavior-preserving code reorganization: contract identification, next-change justification, smallest useful cut, behavior re-verification, and explicit stop condition",
4
- "adjacent_concepts": ["debugging", "testing-strategy", "documentation"],
4
+ "adjacent_concepts": [
5
+ "debugging",
6
+ "testing-strategy",
7
+ "documentation"
8
+ ],
5
9
  "evals": [
6
10
  {
7
11
  "id": 1,
@@ -12,7 +16,9 @@
12
16
  "truth_mode": "code_verification",
13
17
  "skill_type": "workflow",
14
18
  "criticality": "critical",
15
- "truth_sources": ["skills/refactor/SKILL.md:82-89"]
19
+ "truth_sources": [
20
+ "skills/engineering/refactor/SKILL.md:82-89"
21
+ ]
16
22
  },
17
23
  {
18
24
  "id": 2,
@@ -23,7 +29,9 @@
23
29
  "truth_mode": "conceptual_correctness_plus_repo_application",
24
30
  "skill_type": "concept",
25
31
  "criticality": "high",
26
- "truth_sources": ["skills/refactor/SKILL.md:74-76"]
32
+ "truth_sources": [
33
+ "skills/engineering/refactor/SKILL.md:74-76"
34
+ ]
27
35
  },
28
36
  {
29
37
  "id": 3,
@@ -34,7 +42,9 @@
34
42
  "truth_mode": "code_verification",
35
43
  "skill_type": "concept",
36
44
  "criticality": "high",
37
- "truth_sources": ["skills/refactor/SKILL.md:107-113"]
45
+ "truth_sources": [
46
+ "skills/engineering/refactor/SKILL.md:107-113"
47
+ ]
38
48
  },
39
49
  {
40
50
  "id": 4,
@@ -45,7 +55,9 @@
45
55
  "truth_mode": "process_correctness",
46
56
  "skill_type": "workflow",
47
57
  "criticality": "high",
48
- "truth_sources": ["skills/refactor/SKILL.md:90-94"]
58
+ "truth_sources": [
59
+ "skills/engineering/refactor/SKILL.md:90-94"
60
+ ]
49
61
  },
50
62
  {
51
63
  "id": 5,
@@ -56,7 +68,10 @@
56
68
  "truth_mode": "conceptual_correctness_plus_repo_application",
57
69
  "skill_type": "concept",
58
70
  "criticality": "high",
59
- "truth_sources": ["skills/refactor/SKILL.md:45-56", "skills/refactor/SKILL.md:82-89"]
71
+ "truth_sources": [
72
+ "skills/engineering/refactor/SKILL.md:45-56",
73
+ "skills/engineering/refactor/SKILL.md:82-89"
74
+ ]
60
75
  },
61
76
  {
62
77
  "id": 6,
@@ -67,7 +82,10 @@
67
82
  "truth_mode": "conceptual_correctness_plus_repo_application",
68
83
  "skill_type": "concept",
69
84
  "criticality": "critical",
70
- "truth_sources": ["skills/refactor/SKILL.md:82-89", "skills/refactor/SKILL.md:100-105"]
85
+ "truth_sources": [
86
+ "skills/engineering/refactor/SKILL.md:82-89",
87
+ "skills/engineering/refactor/SKILL.md:100-105"
88
+ ]
71
89
  },
72
90
  {
73
91
  "id": 7,
@@ -78,7 +96,9 @@
78
96
  "truth_mode": "code_verification",
79
97
  "skill_type": "concept",
80
98
  "criticality": "normal",
81
- "truth_sources": ["skills/refactor/SKILL.md:107-113"]
99
+ "truth_sources": [
100
+ "skills/engineering/refactor/SKILL.md:107-113"
101
+ ]
82
102
  },
83
103
  {
84
104
  "id": 8,
@@ -89,7 +109,9 @@
89
109
  "truth_mode": "process_correctness",
90
110
  "skill_type": "workflow",
91
111
  "criticality": "high",
92
- "truth_sources": ["skills/refactor/SKILL.md:90-94"]
112
+ "truth_sources": [
113
+ "skills/engineering/refactor/SKILL.md:90-94"
114
+ ]
93
115
  },
94
116
  {
95
117
  "id": 9,
@@ -100,7 +122,9 @@
100
122
  "truth_mode": "process_correctness",
101
123
  "skill_type": "workflow",
102
124
  "criticality": "normal",
103
- "truth_sources": ["skills/refactor/SKILL.md:82-89"]
125
+ "truth_sources": [
126
+ "skills/engineering/refactor/SKILL.md:82-89"
127
+ ]
104
128
  },
105
129
  {
106
130
  "id": 10,
@@ -111,7 +135,10 @@
111
135
  "truth_mode": "code_verification",
112
136
  "skill_type": "concept",
113
137
  "criticality": "high",
114
- "truth_sources": ["skills/refactor/SKILL.md:45-55", "skills/refactor/SKILL.md:107-113"]
138
+ "truth_sources": [
139
+ "skills/engineering/refactor/SKILL.md:45-55",
140
+ "skills/engineering/refactor/SKILL.md:107-113"
141
+ ]
115
142
  },
116
143
  {
117
144
  "id": 11,
@@ -122,7 +149,9 @@
122
149
  "truth_mode": "conceptual_correctness_plus_repo_application",
123
150
  "skill_type": "concept",
124
151
  "criticality": "normal",
125
- "truth_sources": ["skills/refactor/SKILL.md:96-105"]
152
+ "truth_sources": [
153
+ "skills/engineering/refactor/SKILL.md:96-105"
154
+ ]
126
155
  }
127
156
  ]
128
157
  }
@@ -1,7 +1,12 @@
1
1
  {
2
2
  "skill_name": "semiotics",
3
3
  "subject": "Interface sign-system analysis for icons, colors, badges, shapes, visual metaphors, affordances, signifier/signified mapping, and sign drift",
4
- "adjacent_concepts": ["microcopy", "visual-design-foundations", "a11y", "semantic-relations"],
4
+ "adjacent_concepts": [
5
+ "microcopy",
6
+ "visual-design-foundations",
7
+ "a11y",
8
+ "semantic-relations"
9
+ ],
5
10
  "grounding_note": "Truth sources cite the whole SKILL.md file to keep the initial eval surface stable while routing boundaries are tightened.",
6
11
  "evals": [
7
12
  {
@@ -13,7 +18,9 @@
13
18
  "truth_mode": "process_correctness",
14
19
  "skill_type": "concept",
15
20
  "criticality": "high",
16
- "truth_sources": ["skills/semiotics/SKILL.md"]
21
+ "truth_sources": [
22
+ "skills/design/semiotics/SKILL.md"
23
+ ]
17
24
  },
18
25
  {
19
26
  "id": 2,
@@ -24,7 +31,9 @@
24
31
  "truth_mode": "conceptual_correctness_plus_repo_application",
25
32
  "skill_type": "concept",
26
33
  "criticality": "high",
27
- "truth_sources": ["skills/semiotics/SKILL.md"]
34
+ "truth_sources": [
35
+ "skills/design/semiotics/SKILL.md"
36
+ ]
28
37
  },
29
38
  {
30
39
  "id": 3,
@@ -35,7 +44,9 @@
35
44
  "truth_mode": "code_verification",
36
45
  "skill_type": "concept",
37
46
  "criticality": "normal",
38
- "truth_sources": ["skills/semiotics/SKILL.md"]
47
+ "truth_sources": [
48
+ "skills/design/semiotics/SKILL.md"
49
+ ]
39
50
  },
40
51
  {
41
52
  "id": 4,
@@ -46,7 +57,9 @@
46
57
  "truth_mode": "code_verification",
47
58
  "skill_type": "concept",
48
59
  "criticality": "normal",
49
- "truth_sources": ["skills/semiotics/SKILL.md"]
60
+ "truth_sources": [
61
+ "skills/design/semiotics/SKILL.md"
62
+ ]
50
63
  }
51
64
  ]
52
65
  }
@@ -1,7 +1,12 @@
1
1
  {
2
2
  "skill_name": "skill-infrastructure",
3
3
  "subject": "Deterministic health tooling for SKILL.md libraries: inventory, protocol consistency, conflict detection, routing health, and drift detection",
4
- "adjacent_concepts": ["skill-scaffold", "graph-audit", "testing-strategy", "lint-overlay"],
4
+ "adjacent_concepts": [
5
+ "skill-scaffold",
6
+ "graph-audit",
7
+ "testing-strategy",
8
+ "lint-overlay"
9
+ ],
5
10
  "grounding_note": "This portable skill is grounded in Skill Graph's health-tooling categories and uses whole-file truth sources to avoid brittle line drift while the skill itself continues to evolve.",
6
11
  "evals": [
7
12
  {
@@ -13,7 +18,9 @@
13
18
  "truth_mode": "conceptual_correctness_plus_repo_application",
14
19
  "skill_type": "concept",
15
20
  "criticality": "high",
16
- "truth_sources": ["skills/skill-infrastructure/SKILL.md"]
21
+ "truth_sources": [
22
+ "skills/agent/skill-system/skill-infrastructure/SKILL.md"
23
+ ]
17
24
  },
18
25
  {
19
26
  "id": 2,
@@ -24,7 +31,10 @@
24
31
  "truth_mode": "process_correctness",
25
32
  "skill_type": "workflow",
26
33
  "criticality": "high",
27
- "truth_sources": ["skills/skill-infrastructure/SKILL.md", "scripts/generate-manifest.js"]
34
+ "truth_sources": [
35
+ "skills/agent/skill-system/skill-infrastructure/SKILL.md",
36
+ "scripts/generate-manifest.js"
37
+ ]
28
38
  },
29
39
  {
30
40
  "id": 3,
@@ -35,7 +45,9 @@
35
45
  "truth_mode": "conceptual_correctness_plus_repo_application",
36
46
  "skill_type": "concept",
37
47
  "criticality": "high",
38
- "truth_sources": ["skills/skill-infrastructure/SKILL.md"]
48
+ "truth_sources": [
49
+ "skills/agent/skill-system/skill-infrastructure/SKILL.md"
50
+ ]
39
51
  },
40
52
  {
41
53
  "id": 4,
@@ -46,7 +58,9 @@
46
58
  "truth_mode": "process_correctness",
47
59
  "skill_type": "workflow",
48
60
  "criticality": "normal",
49
- "truth_sources": ["skills/skill-infrastructure/SKILL.md"]
61
+ "truth_sources": [
62
+ "skills/agent/skill-system/skill-infrastructure/SKILL.md"
63
+ ]
50
64
  },
51
65
  {
52
66
  "id": 5,
@@ -57,7 +71,10 @@
57
71
  "truth_mode": "conceptual_correctness_plus_repo_application",
58
72
  "skill_type": "concept",
59
73
  "criticality": "high",
60
- "truth_sources": ["skills/skill-infrastructure/SKILL.md", "scripts/skill-graph-drift.js"]
74
+ "truth_sources": [
75
+ "skills/agent/skill-system/skill-infrastructure/SKILL.md",
76
+ "scripts/skill-graph-drift.js"
77
+ ]
61
78
  },
62
79
  {
63
80
  "id": 6,
@@ -68,7 +85,9 @@
68
85
  "truth_mode": "conceptual_correctness_plus_repo_application",
69
86
  "skill_type": "concept",
70
87
  "criticality": "normal",
71
- "truth_sources": ["skills/skill-infrastructure/SKILL.md"]
88
+ "truth_sources": [
89
+ "skills/agent/skill-system/skill-infrastructure/SKILL.md"
90
+ ]
72
91
  },
73
92
  {
74
93
  "id": 7,
@@ -79,7 +98,9 @@
79
98
  "truth_mode": "process_correctness",
80
99
  "skill_type": "workflow",
81
100
  "criticality": "high",
82
- "truth_sources": ["skills/skill-infrastructure/SKILL.md"]
101
+ "truth_sources": [
102
+ "skills/agent/skill-system/skill-infrastructure/SKILL.md"
103
+ ]
83
104
  },
84
105
  {
85
106
  "id": 8,
@@ -90,7 +111,9 @@
90
111
  "truth_mode": "conceptual_correctness_plus_repo_application",
91
112
  "skill_type": "concept",
92
113
  "criticality": "normal",
93
- "truth_sources": ["skills/skill-infrastructure/SKILL.md"]
114
+ "truth_sources": [
115
+ "skills/agent/skill-system/skill-infrastructure/SKILL.md"
116
+ ]
94
117
  }
95
118
  ]
96
119
  }
@@ -1,7 +1,10 @@
1
1
  {
2
2
  "skill_name": "skill-router",
3
3
  "subject": "Skill-dispatch mechanics for multi-skill agent runtimes: trigger-label matching, file-path matching, keyword matching, scope/type tiebreakers, and coverage-gap detection",
4
- "adjacent_concepts": ["documentation", "graph-audit"],
4
+ "adjacent_concepts": [
5
+ "documentation",
6
+ "graph-audit"
7
+ ],
5
8
  "grounding_note": "Truth_sources cite skills/skill-router/SKILL.md line ranges. Drift is caught by scripts/skill-lint.js's `checkEvalTruthSourceRanges` check (D2) — any edit that moves a cited range out of file bounds fails lint before commit. Section-anchor citations (`## Routing Rules`) were considered but rejected: the Skill Graph schema does not define a stable anchor format across Markdown renderers, and line ranges plus the lint check give the grader an exact substring to ground against without renderer ambiguity.",
6
9
  "evals": [
7
10
  {
@@ -13,7 +16,9 @@
13
16
  "truth_mode": "code_verification",
14
17
  "skill_type": "concept",
15
18
  "criticality": "high",
16
- "truth_sources": ["skills/skill-router/SKILL.md:82-90"]
19
+ "truth_sources": [
20
+ "skills/agent/skill-system/skill-router/SKILL.md:82-90"
21
+ ]
17
22
  },
18
23
  {
19
24
  "id": 2,
@@ -24,7 +29,9 @@
24
29
  "truth_mode": "conceptual_correctness_plus_repo_application",
25
30
  "skill_type": "concept",
26
31
  "criticality": "high",
27
- "truth_sources": ["skills/skill-router/SKILL.md:102-104"]
32
+ "truth_sources": [
33
+ "skills/agent/skill-system/skill-router/SKILL.md:102-104"
34
+ ]
28
35
  },
29
36
  {
30
37
  "id": 3,
@@ -35,7 +42,9 @@
35
42
  "truth_mode": "code_verification",
36
43
  "skill_type": "concept",
37
44
  "criticality": "high",
38
- "truth_sources": ["skills/skill-router/SKILL.md:110-117"]
45
+ "truth_sources": [
46
+ "skills/agent/skill-system/skill-router/SKILL.md:110-117"
47
+ ]
39
48
  },
40
49
  {
41
50
  "id": 4,
@@ -46,7 +55,9 @@
46
55
  "truth_mode": "process_correctness",
47
56
  "skill_type": "workflow",
48
57
  "criticality": "high",
49
- "truth_sources": ["skills/skill-router/SKILL.md:92-96"]
58
+ "truth_sources": [
59
+ "skills/agent/skill-system/skill-router/SKILL.md:92-96"
60
+ ]
50
61
  },
51
62
  {
52
63
  "id": 5,
@@ -57,7 +68,9 @@
57
68
  "truth_mode": "code_verification",
58
69
  "skill_type": "concept",
59
70
  "criticality": "normal",
60
- "truth_sources": ["skills/skill-router/SKILL.md:92-96"]
71
+ "truth_sources": [
72
+ "skills/agent/skill-system/skill-router/SKILL.md:92-96"
73
+ ]
61
74
  },
62
75
  {
63
76
  "id": 6,
@@ -68,7 +81,9 @@
68
81
  "truth_mode": "conceptual_correctness_plus_repo_application",
69
82
  "skill_type": "concept",
70
83
  "criticality": "critical",
71
- "truth_sources": ["skills/skill-router/SKILL.md:102-104"]
84
+ "truth_sources": [
85
+ "skills/agent/skill-system/skill-router/SKILL.md:102-104"
86
+ ]
72
87
  },
73
88
  {
74
89
  "id": 7,
@@ -79,7 +94,9 @@
79
94
  "truth_mode": "code_verification",
80
95
  "skill_type": "concept",
81
96
  "criticality": "high",
82
- "truth_sources": ["skills/skill-router/SKILL.md:110-117"]
97
+ "truth_sources": [
98
+ "skills/agent/skill-system/skill-router/SKILL.md:110-117"
99
+ ]
83
100
  },
84
101
  {
85
102
  "id": 8,
@@ -90,7 +107,9 @@
90
107
  "truth_mode": "process_correctness",
91
108
  "skill_type": "workflow",
92
109
  "criticality": "high",
93
- "truth_sources": ["skills/skill-router/SKILL.md:98-100"]
110
+ "truth_sources": [
111
+ "skills/agent/skill-system/skill-router/SKILL.md:98-100"
112
+ ]
94
113
  },
95
114
  {
96
115
  "id": 9,
@@ -101,7 +120,9 @@
101
120
  "truth_mode": "process_correctness",
102
121
  "skill_type": "workflow",
103
122
  "criticality": "high",
104
- "truth_sources": ["skills/skill-router/SKILL.md:82-90"]
123
+ "truth_sources": [
124
+ "skills/agent/skill-system/skill-router/SKILL.md:82-90"
125
+ ]
105
126
  },
106
127
  {
107
128
  "id": 10,
@@ -112,7 +133,9 @@
112
133
  "truth_mode": "process_correctness",
113
134
  "skill_type": "workflow",
114
135
  "criticality": "normal",
115
- "truth_sources": ["skills/skill-router/SKILL.md:82-90"]
136
+ "truth_sources": [
137
+ "skills/agent/skill-system/skill-router/SKILL.md:82-90"
138
+ ]
116
139
  },
117
140
  {
118
141
  "id": 11,
@@ -123,7 +146,10 @@
123
146
  "truth_mode": "process_correctness",
124
147
  "skill_type": "workflow",
125
148
  "criticality": "critical",
126
- "truth_sources": ["skills/skill-router/SKILL.md:82-90", "skills/skill-router/SKILL.md:71-80"]
149
+ "truth_sources": [
150
+ "skills/agent/skill-system/skill-router/SKILL.md:82-90",
151
+ "skills/agent/skill-system/skill-router/SKILL.md:71-80"
152
+ ]
127
153
  },
128
154
  {
129
155
  "id": 12,
@@ -134,7 +160,10 @@
134
160
  "truth_mode": "process_correctness",
135
161
  "skill_type": "workflow",
136
162
  "criticality": "high",
137
- "truth_sources": ["skills/skill-router/SKILL.md:102-104", "skills/skill-router/SKILL.md:71-80"]
163
+ "truth_sources": [
164
+ "skills/agent/skill-system/skill-router/SKILL.md:102-104",
165
+ "skills/agent/skill-system/skill-router/SKILL.md:71-80"
166
+ ]
138
167
  }
139
168
  ]
140
169
  }
@@ -1,7 +1,12 @@
1
1
  {
2
2
  "skill_name": "system-interface-contracts",
3
3
  "subject": "System boundary contracts across modules, services, jobs, agents, APIs, events, dashboards, invariants, ownership, failure modes, and verification",
4
- "adjacent_concepts": ["api-design", "event-contract-design", "data-modeling", "observability-modeling"],
4
+ "adjacent_concepts": [
5
+ "api-design",
6
+ "event-contract-design",
7
+ "data-modeling",
8
+ "observability-modeling"
9
+ ],
5
10
  "grounding_note": "Truth sources cite the whole SKILL.md file to keep the initial eval surface stable while routing boundaries are tightened.",
6
11
  "evals": [
7
12
  {
@@ -13,7 +18,9 @@
13
18
  "truth_mode": "process_correctness",
14
19
  "skill_type": "concept",
15
20
  "criticality": "high",
16
- "truth_sources": ["skills/system-interface-contracts/SKILL.md"]
21
+ "truth_sources": [
22
+ "skills/engineering/system-interface-contracts/SKILL.md"
23
+ ]
17
24
  },
18
25
  {
19
26
  "id": 2,
@@ -24,7 +31,9 @@
24
31
  "truth_mode": "conceptual_correctness_plus_repo_application",
25
32
  "skill_type": "concept",
26
33
  "criticality": "high",
27
- "truth_sources": ["skills/system-interface-contracts/SKILL.md"]
34
+ "truth_sources": [
35
+ "skills/engineering/system-interface-contracts/SKILL.md"
36
+ ]
28
37
  },
29
38
  {
30
39
  "id": 3,
@@ -35,7 +44,9 @@
35
44
  "truth_mode": "code_verification",
36
45
  "skill_type": "concept",
37
46
  "criticality": "normal",
38
- "truth_sources": ["skills/system-interface-contracts/SKILL.md"]
47
+ "truth_sources": [
48
+ "skills/engineering/system-interface-contracts/SKILL.md"
49
+ ]
39
50
  },
40
51
  {
41
52
  "id": 4,
@@ -46,7 +57,9 @@
46
57
  "truth_mode": "code_verification",
47
58
  "skill_type": "concept",
48
59
  "criticality": "normal",
49
- "truth_sources": ["skills/system-interface-contracts/SKILL.md"]
60
+ "truth_sources": [
61
+ "skills/engineering/system-interface-contracts/SKILL.md"
62
+ ]
50
63
  }
51
64
  ]
52
65
  }