@skill-graph/cli 0.5.6

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 (330) hide show
  1. package/CHANGELOG.md +247 -0
  2. package/LICENSE +200 -0
  3. package/NOTICE +62 -0
  4. package/README.md +398 -0
  5. package/SKILL_GRAPH.md +443 -0
  6. package/bin/skill-graph.js +374 -0
  7. package/docs/ADOPTION.md +117 -0
  8. package/docs/CONFORMANCE.md +66 -0
  9. package/docs/PRIMER.md +384 -0
  10. package/docs/QUICKSTART-30MIN.md +333 -0
  11. package/docs/ROUTING-METRICS.md +120 -0
  12. package/docs/SKILL-MD-FORMAT-COMPATIBILITY.md +127 -0
  13. package/docs/SKILL_AUDIT_CHECKLIST.md +199 -0
  14. package/docs/SKILL_AUDIT_LOOP.md +195 -0
  15. package/docs/SKILL_METADATA_PROTOCOL.md +609 -0
  16. package/docs/_archived/marketplace-publication-priority-2026-05-18.md +239 -0
  17. package/docs/adr/0001-predicate-set.md +69 -0
  18. package/docs/adr/0002-json-ld-context.md +82 -0
  19. package/docs/adr/0003-ontoclean-rigidity-tags.md +65 -0
  20. package/docs/adr/0004-persistent-identifiers.md +74 -0
  21. package/docs/adr/0005-freshness-consolidation.md +70 -0
  22. package/docs/adr/0006-revise-predicate-rename.md +105 -0
  23. package/docs/adr/0007-audit-loop-cadence.md +99 -0
  24. package/docs/adr/0008-skill-surface-split-and-curation-policy.md +93 -0
  25. package/docs/category-consumers.md +168 -0
  26. package/docs/concept-map.md +194 -0
  27. package/docs/diagrams/drift-states.mmd +21 -0
  28. package/docs/diagrams/manifest-pipeline.mmd +25 -0
  29. package/docs/diagrams/routing-harness.mmd +41 -0
  30. package/docs/diagrams/starter-graph.mmd +53 -0
  31. package/docs/field-decision-guide.md +315 -0
  32. package/docs/field-rationale.md +211 -0
  33. package/docs/field-reference.generated.md +624 -0
  34. package/docs/field-reference.md +1426 -0
  35. package/docs/glossary.md +190 -0
  36. package/docs/head-noun-glossary.md +63 -0
  37. package/docs/images/audit-phases.png +0 -0
  38. package/docs/images/drift-states.png +0 -0
  39. package/docs/images/graded-mode.png +0 -0
  40. package/docs/images/manifest-pipeline.png +0 -0
  41. package/docs/images/routing-harness.png +0 -0
  42. package/docs/images/skill-anatomy.png +0 -0
  43. package/docs/images/starter-graph.png +0 -0
  44. package/docs/images/system-model.png +0 -0
  45. package/docs/integrations/github-actions.md +155 -0
  46. package/docs/manifest-field-mapping.md +443 -0
  47. package/docs/marketplace-publication-queue.generated.md +240 -0
  48. package/docs/marketplace-release-agent-prompt.md +82 -0
  49. package/docs/marketplace-skill-candidate-list.md +272 -0
  50. package/docs/marketplace-syndication.md +222 -0
  51. package/docs/migration-sample-review.md +155 -0
  52. package/docs/migrations/v4-to-v5.md +168 -0
  53. package/docs/migrations/v5-to-v6.md +221 -0
  54. package/docs/name-exceptions.yaml +37 -0
  55. package/docs/plans/marketplace-p1-public-migration-plan.md +41 -0
  56. package/docs/plans/multi-root-workspace.md +148 -0
  57. package/docs/plans/scripts-roadmap.md +107 -0
  58. package/docs/plans/v4-schema-bump.md +160 -0
  59. package/docs/plans/wave-2-extraction.md +122 -0
  60. package/docs/positioning-vs-marketplaces.md +175 -0
  61. package/docs/proposals/skill-audit-loop-positioning.md +160 -0
  62. package/docs/quality-doctrine.md +138 -0
  63. package/docs/recommended-skills.md +150 -0
  64. package/docs/research/skill-comprehension-eval-research.md +1830 -0
  65. package/docs/research/skill-retrieval-evidence.md +66 -0
  66. package/docs/skill-metadata-protocol.md +471 -0
  67. package/docs/skills-sh-maintainer-cleanup-request.md +80 -0
  68. package/examples/audits/a11y/findings.md +52 -0
  69. package/examples/audits/a11y/scorecard.md +21 -0
  70. package/examples/audits/a11y/verdict.md +44 -0
  71. package/examples/audits/debugging/findings.md +59 -0
  72. package/examples/audits/debugging/scorecard.md +22 -0
  73. package/examples/audits/debugging/verdict.md +33 -0
  74. package/examples/audits/documentation/findings.md +59 -0
  75. package/examples/audits/documentation/scorecard.md +22 -0
  76. package/examples/audits/documentation/verdict.md +33 -0
  77. package/examples/evals/a11y.json +140 -0
  78. package/examples/evals/api-design.json +52 -0
  79. package/examples/evals/code-review.json +52 -0
  80. package/examples/evals/data-modeling.json +52 -0
  81. package/examples/evals/database-migration.json +52 -0
  82. package/examples/evals/debugging.json +118 -0
  83. package/examples/evals/dependency-architecture.json +52 -0
  84. package/examples/evals/design-system-architecture.json +52 -0
  85. package/examples/evals/error-tracking.json +52 -0
  86. package/examples/evals/event-contract-design.json +52 -0
  87. package/examples/evals/form-ux-architecture.json +52 -0
  88. package/examples/evals/framework-fit-analysis.json +52 -0
  89. package/examples/evals/graph-audit.json +139 -0
  90. package/examples/evals/information-architecture.json +52 -0
  91. package/examples/evals/interaction-feedback.json +52 -0
  92. package/examples/evals/interaction-patterns.json +52 -0
  93. package/examples/evals/layout-composition.json +52 -0
  94. package/examples/evals/lint-overlay.json +117 -0
  95. package/examples/evals/microcopy.json +52 -0
  96. package/examples/evals/observability-modeling.json +52 -0
  97. package/examples/evals/pattern-recognition.json +96 -0
  98. package/examples/evals/performance-engineering.json +52 -0
  99. package/examples/evals/refactor.json +128 -0
  100. package/examples/evals/semiotics.json +52 -0
  101. package/examples/evals/skill-infrastructure.json +96 -0
  102. package/examples/evals/skill-router.json +140 -0
  103. package/examples/evals/skill-router.routing.json +113 -0
  104. package/examples/evals/system-interface-contracts.json +52 -0
  105. package/examples/evals/task-analysis.json +52 -0
  106. package/examples/evals/testing-strategy.json +118 -0
  107. package/examples/evals/type-safety.json +249 -0
  108. package/examples/evals/visual-design-foundations.json +52 -0
  109. package/examples/evals/webhook-integration.json +52 -0
  110. package/examples/exports/a11y.skill-md.md +80 -0
  111. package/examples/exports/debugging.skill-md.md +80 -0
  112. package/examples/exports/refactor.skill-md.md +78 -0
  113. package/examples/exports/testing-strategy.skill-md.md +81 -0
  114. package/examples/projects/markdown-static-site/README.md +115 -0
  115. package/examples/projects/markdown-static-site/skills/content-source-router/SKILL.md +131 -0
  116. package/examples/projects/markdown-static-site/skills/image-optimization-pipeline-config/SKILL.md +132 -0
  117. package/examples/projects/markdown-static-site/skills/link-rot-detection/SKILL.md +103 -0
  118. package/examples/projects/markdown-static-site/skills/markdown-post-frontmatter-validation/SKILL.md +133 -0
  119. package/examples/projects/markdown-static-site/skills/migrate-posts-to-v2-frontmatter/SKILL.md +140 -0
  120. package/examples/projects/saas-stripe-postgres/README.md +208 -0
  121. package/examples/projects/saas-stripe-postgres/db/migrations/0004_canonicalize_orders.sql +37 -0
  122. package/examples/projects/saas-stripe-postgres/db/schema.sql +112 -0
  123. package/examples/projects/saas-stripe-postgres/skills/migrate-orders-to-canonical-schema/SKILL.md +149 -0
  124. package/examples/projects/saas-stripe-postgres/skills/nextjs-server-action-validation/SKILL.md +154 -0
  125. package/examples/projects/saas-stripe-postgres/skills/payment-provider-router/SKILL.md +153 -0
  126. package/examples/projects/saas-stripe-postgres/skills/postgres-rls-pattern/SKILL.md +163 -0
  127. package/examples/projects/saas-stripe-postgres/skills/stripe-webhook-signature-verification/SKILL.md +137 -0
  128. package/examples/protocol/skill-metadata-template.md +301 -0
  129. package/examples/protocol/skills.manifest.sample.json +13245 -0
  130. package/examples/skill-metadata-template.md +317 -0
  131. package/examples/skills.manifest.sample.json +13519 -0
  132. package/examples/tests/v3-1-skos-fixture/SKILL.md +93 -0
  133. package/marketplace/README.md +17 -0
  134. package/marketplace/skills/a11y/SKILL.md +66 -0
  135. package/marketplace/skills/acid-fundamentals/SKILL.md +106 -0
  136. package/marketplace/skills/agent-engineering/SKILL.md +386 -0
  137. package/marketplace/skills/agent-eval-design/SKILL.md +55 -0
  138. package/marketplace/skills/ai-native-development/SKILL.md +294 -0
  139. package/marketplace/skills/api-design/SKILL.md +60 -0
  140. package/marketplace/skills/architecture-decision-records/SKILL.md +55 -0
  141. package/marketplace/skills/background-jobs/SKILL.md +265 -0
  142. package/marketplace/skills/bounded-context-mapping/SKILL.md +55 -0
  143. package/marketplace/skills/cap-theorem-tradeoffs/SKILL.md +127 -0
  144. package/marketplace/skills/client-server-boundary/SKILL.md +187 -0
  145. package/marketplace/skills/code-review/SKILL.md +120 -0
  146. package/marketplace/skills/color-system-design/SKILL.md +43 -0
  147. package/marketplace/skills/component-architecture/SKILL.md +126 -0
  148. package/marketplace/skills/compression/SKILL.md +112 -0
  149. package/marketplace/skills/conceptual-modeling/SKILL.md +181 -0
  150. package/marketplace/skills/connection-pooling/SKILL.md +105 -0
  151. package/marketplace/skills/constraint-awareness/SKILL.md +287 -0
  152. package/marketplace/skills/content-monitor/SKILL.md +209 -0
  153. package/marketplace/skills/context-engineering/SKILL.md +320 -0
  154. package/marketplace/skills/context-graph/SKILL.md +174 -0
  155. package/marketplace/skills/context-management/SKILL.md +174 -0
  156. package/marketplace/skills/context-window/SKILL.md +239 -0
  157. package/marketplace/skills/contract-testing/SKILL.md +120 -0
  158. package/marketplace/skills/cron-scheduling/SKILL.md +223 -0
  159. package/marketplace/skills/dark-mode-implementation/SKILL.md +47 -0
  160. package/marketplace/skills/data-modeling/SKILL.md +59 -0
  161. package/marketplace/skills/data-modeling-fundamentals/SKILL.md +117 -0
  162. package/marketplace/skills/database-migration/SKILL.md +429 -0
  163. package/marketplace/skills/debugging/SKILL.md +67 -0
  164. package/marketplace/skills/dependency-architecture/SKILL.md +58 -0
  165. package/marketplace/skills/design-module-composition/SKILL.md +43 -0
  166. package/marketplace/skills/design-system-architecture/SKILL.md +61 -0
  167. package/marketplace/skills/design-thinking/SKILL.md +44 -0
  168. package/marketplace/skills/diagnosis/SKILL.md +296 -0
  169. package/marketplace/skills/diff-analysis/SKILL.md +188 -0
  170. package/marketplace/skills/e2e-test-design/SKILL.md +113 -0
  171. package/marketplace/skills/entity-relationship-modeling/SKILL.md +218 -0
  172. package/marketplace/skills/epistemic-grounding/SKILL.md +112 -0
  173. package/marketplace/skills/error-boundary/SKILL.md +235 -0
  174. package/marketplace/skills/error-tracking/SKILL.md +261 -0
  175. package/marketplace/skills/eval-driven-development/SKILL.md +147 -0
  176. package/marketplace/skills/evaluation/SKILL.md +113 -0
  177. package/marketplace/skills/event-contract-design/SKILL.md +60 -0
  178. package/marketplace/skills/event-storming/SKILL.md +56 -0
  179. package/marketplace/skills/form-ux-architecture/SKILL.md +60 -0
  180. package/marketplace/skills/framework-fit-analysis/SKILL.md +59 -0
  181. package/marketplace/skills/frontend-architecture/SKILL.md +43 -0
  182. package/marketplace/skills/generative-ui/SKILL.md +118 -0
  183. package/marketplace/skills/graph-audit/SKILL.md +81 -0
  184. package/marketplace/skills/guardrails/SKILL.md +118 -0
  185. package/marketplace/skills/hooks-patterns/SKILL.md +185 -0
  186. package/marketplace/skills/http-semantics/SKILL.md +136 -0
  187. package/marketplace/skills/ideation/SKILL.md +41 -0
  188. package/marketplace/skills/indexing-strategy/SKILL.md +108 -0
  189. package/marketplace/skills/information-architecture/SKILL.md +59 -0
  190. package/marketplace/skills/integration-test-design/SKILL.md +111 -0
  191. package/marketplace/skills/intent-recognition/SKILL.md +136 -0
  192. package/marketplace/skills/interaction-feedback/SKILL.md +59 -0
  193. package/marketplace/skills/interaction-patterns/SKILL.md +59 -0
  194. package/marketplace/skills/journey-mapping/SKILL.md +41 -0
  195. package/marketplace/skills/keywords/SKILL.md +213 -0
  196. package/marketplace/skills/knowledge-modeling/SKILL.md +232 -0
  197. package/marketplace/skills/layout-composition/SKILL.md +59 -0
  198. package/marketplace/skills/linguistics/SKILL.md +429 -0
  199. package/marketplace/skills/lint-overlay/SKILL.md +76 -0
  200. package/marketplace/skills/mental-models/SKILL.md +126 -0
  201. package/marketplace/skills/merge-queue/SKILL.md +94 -0
  202. package/marketplace/skills/methodology/SKILL.md +317 -0
  203. package/marketplace/skills/microcopy/SKILL.md +232 -0
  204. package/marketplace/skills/middleware-patterns/SKILL.md +363 -0
  205. package/marketplace/skills/mobile-responsive-ux/SKILL.md +287 -0
  206. package/marketplace/skills/mutation-testing/SKILL.md +112 -0
  207. package/marketplace/skills/naming-conventions/SKILL.md +112 -0
  208. package/marketplace/skills/observability-modeling/SKILL.md +59 -0
  209. package/marketplace/skills/ontology-modeling/SKILL.md +67 -0
  210. package/marketplace/skills/owasp-security/SKILL.md +153 -0
  211. package/marketplace/skills/pattern-recognition/SKILL.md +472 -0
  212. package/marketplace/skills/performance-budgets/SKILL.md +185 -0
  213. package/marketplace/skills/performance-engineering/SKILL.md +58 -0
  214. package/marketplace/skills/performance-testing/SKILL.md +125 -0
  215. package/marketplace/skills/printify/SKILL.md +42 -0
  216. package/marketplace/skills/prioritization/SKILL.md +118 -0
  217. package/marketplace/skills/problem-framing/SKILL.md +41 -0
  218. package/marketplace/skills/problem-locating-solving/SKILL.md +203 -0
  219. package/marketplace/skills/project-knowledge-extraction/SKILL.md +54 -0
  220. package/marketplace/skills/prompt-craft/SKILL.md +134 -0
  221. package/marketplace/skills/prompt-injection-defense/SKILL.md +132 -0
  222. package/marketplace/skills/property-based-testing/SKILL.md +100 -0
  223. package/marketplace/skills/prototyping/SKILL.md +43 -0
  224. package/marketplace/skills/query-optimization/SKILL.md +144 -0
  225. package/marketplace/skills/real-time-updates/SKILL.md +324 -0
  226. package/marketplace/skills/ref-patterns/SKILL.md +284 -0
  227. package/marketplace/skills/refactor/SKILL.md +65 -0
  228. package/marketplace/skills/rendering-models/SKILL.md +142 -0
  229. package/marketplace/skills/replication-patterns/SKILL.md +110 -0
  230. package/marketplace/skills/research-synthesis/SKILL.md +41 -0
  231. package/marketplace/skills/route-handler-design/SKILL.md +347 -0
  232. package/marketplace/skills/schema-evolution/SKILL.md +140 -0
  233. package/marketplace/skills/security-fundamentals/SKILL.md +139 -0
  234. package/marketplace/skills/semantic-center/SKILL.md +194 -0
  235. package/marketplace/skills/semantic-relations/SKILL.md +250 -0
  236. package/marketplace/skills/semantics/SKILL.md +366 -0
  237. package/marketplace/skills/semiotics/SKILL.md +230 -0
  238. package/marketplace/skills/seo-strategy/SKILL.md +260 -0
  239. package/marketplace/skills/server-actions-design/SKILL.md +243 -0
  240. package/marketplace/skills/server-components-design/SKILL.md +190 -0
  241. package/marketplace/skills/sharding-strategy/SKILL.md +123 -0
  242. package/marketplace/skills/shopify/SKILL.md +42 -0
  243. package/marketplace/skills/skill-infrastructure/SKILL.md +320 -0
  244. package/marketplace/skills/skill-router/SKILL.md +71 -0
  245. package/marketplace/skills/skill-scaffold/SKILL.md +105 -0
  246. package/marketplace/skills/snapshot-testing/SKILL.md +120 -0
  247. package/marketplace/skills/spec-driven-development/SKILL.md +148 -0
  248. package/marketplace/skills/state-machine-modeling/SKILL.md +56 -0
  249. package/marketplace/skills/state-management/SKILL.md +134 -0
  250. package/marketplace/skills/streaming-architecture/SKILL.md +194 -0
  251. package/marketplace/skills/summarization/SKILL.md +156 -0
  252. package/marketplace/skills/suspense-patterns/SKILL.md +265 -0
  253. package/marketplace/skills/system-interface-contracts/SKILL.md +59 -0
  254. package/marketplace/skills/task-analysis/SKILL.md +201 -0
  255. package/marketplace/skills/taxonomy-design/SKILL.md +66 -0
  256. package/marketplace/skills/test-coverage-strategy/SKILL.md +108 -0
  257. package/marketplace/skills/test-doubles-design/SKILL.md +98 -0
  258. package/marketplace/skills/test-driven-development/SKILL.md +96 -0
  259. package/marketplace/skills/testing-strategy/SKILL.md +67 -0
  260. package/marketplace/skills/theme-system-design/SKILL.md +43 -0
  261. package/marketplace/skills/tool-call-flow/SKILL.md +229 -0
  262. package/marketplace/skills/tool-call-strategy/SKILL.md +292 -0
  263. package/marketplace/skills/transaction-isolation/SKILL.md +98 -0
  264. package/marketplace/skills/type-safety/SKILL.md +177 -0
  265. package/marketplace/skills/typography-system/SKILL.md +43 -0
  266. package/marketplace/skills/usability-testing/SKILL.md +43 -0
  267. package/marketplace/skills/user-research/SKILL.md +43 -0
  268. package/marketplace/skills/vercel-composition-patterns/SKILL.md +157 -0
  269. package/marketplace/skills/version-control/SKILL.md +233 -0
  270. package/marketplace/skills/visual-design-foundations/SKILL.md +59 -0
  271. package/marketplace/skills/visual-hierarchy/SKILL.md +43 -0
  272. package/marketplace/skills/webhook-integration/SKILL.md +331 -0
  273. package/marketplace/skills/writing-humanizer/SKILL.md +380 -0
  274. package/package.json +67 -0
  275. package/schemas/manifest.schema.json +811 -0
  276. package/schemas/manifest.v2.schema.json +164 -0
  277. package/schemas/manifest.v3.schema.json +758 -0
  278. package/schemas/manifest.v4.schema.json +755 -0
  279. package/schemas/manifest.v5.schema.json +755 -0
  280. package/schemas/manifest.v6.schema.json +811 -0
  281. package/schemas/skill.context.jsonld +279 -0
  282. package/schemas/skill.schema.json +919 -0
  283. package/schemas/skill.v2.schema.json +201 -0
  284. package/schemas/skill.v3.schema.json +827 -0
  285. package/schemas/skill.v4.schema.json +822 -0
  286. package/schemas/skill.v5.schema.json +830 -0
  287. package/schemas/skill.v6.schema.json +946 -0
  288. package/schemas/vocabulary/keywords.json +180 -0
  289. package/schemas/vocabulary/workspace_tags.json +23 -0
  290. package/scripts/__tests__/migrate-skill-v2-to-v3.test.js +161 -0
  291. package/scripts/__tests__/migrate-skill-v3-to-v4.test.js +158 -0
  292. package/scripts/__tests__/test-export-parser-drift.js +149 -0
  293. package/scripts/__tests__/test-marketplace-export.js +114 -0
  294. package/scripts/__tests__/test-router-paths.js +82 -0
  295. package/scripts/__tests__/test-stability-promotion.js +244 -0
  296. package/scripts/__tests__/test-v3-1-alias-contract.js +109 -0
  297. package/scripts/__tests__/test-v3-1-skos-runtime.js +116 -0
  298. package/scripts/backfill-schema-version.js +198 -0
  299. package/scripts/build-field-reference.js +160 -0
  300. package/scripts/build-retrieval-baseline.js +511 -0
  301. package/scripts/check-markdown-links.js +211 -0
  302. package/scripts/check-protocol-consistency.js +979 -0
  303. package/scripts/export-marketplace-skills.js +610 -0
  304. package/scripts/export-skill.js +374 -0
  305. package/scripts/generate-manifest.js +787 -0
  306. package/scripts/lib/alias-contract.js +83 -0
  307. package/scripts/lib/audit-prompt-builder.js +771 -0
  308. package/scripts/lib/mock-grader.js +134 -0
  309. package/scripts/lib/parse-frontmatter.js +429 -0
  310. package/scripts/lib/roots.js +119 -0
  311. package/scripts/lint/check-archetype-sections.js +185 -0
  312. package/scripts/lint/check-category-enum.js +83 -0
  313. package/scripts/lint/check-routing-eval.js +146 -0
  314. package/scripts/lint/check-routing-quality.js +211 -0
  315. package/scripts/lint/check-stability-promotion.js +220 -0
  316. package/scripts/lint/format-code-frame.js +206 -0
  317. package/scripts/marketplace-install.js +125 -0
  318. package/scripts/migrate-category-to-enum.js +169 -0
  319. package/scripts/migrate-skill-v2-to-v3.js +424 -0
  320. package/scripts/migrate-skill-v3-to-v4.js +200 -0
  321. package/scripts/migrate-skill-v5-to-v6.js +304 -0
  322. package/scripts/restructure-by-category.js +85 -0
  323. package/scripts/seed-publication-classification.js +282 -0
  324. package/scripts/skill-audit.js +893 -0
  325. package/scripts/skill-graph-drift.js +483 -0
  326. package/scripts/skill-graph-route.js +766 -0
  327. package/scripts/skill-graph-routing-eval.js +393 -0
  328. package/scripts/skill-lint.js +1317 -0
  329. package/scripts/skill-overlap.js +213 -0
  330. package/scripts/verify-skill-md-export.js +201 -0
@@ -0,0 +1,240 @@
1
+ # Marketplace Publication Queue (generated)
2
+
3
+ Generated: 2026-05-18T10:55:00.441Z
4
+ Schema: 2.0.0
5
+ Generator: skill-audit-loop@0.3.0
6
+ Source ledger: `skill-graph/data/publication-classification.json`
7
+
8
+ > Auto-generated from `skill-graph/data/publication-classification.json` by
9
+ > `skill-audit-loop/src/build-skill-audit-worklist.js`. Do not hand-edit — re-run
10
+ > `node scripts/skill/build-skill-audit-worklist.js --write` after editing the ledger.
11
+
12
+ ## Summary
13
+
14
+ - Publishable candidates: 136
15
+ - Sales-Hub-bound (excluded): 53
16
+ - Personal-infra (excluded): 27
17
+ - Already published (in OSS export): 140
18
+ - Tier counts: S=18 A=29 B=42 C=47
19
+ - Ledger entries total: 216
20
+
21
+ ## Tier S — Publish immediately (5★) (n=18)
22
+
23
+ | Rank | Skill | Pop | Source | Sanitize? | Demand | In Export | Audit Rank | Notes |
24
+ | --- | --- | ---: | --- | --- | --- | ---: | ---: | --- |
25
+ | 1 | `advanced-css-layout` | 5 | port | no | demand-cluster | no | 287 | |
26
+ | 2 | `autonomous-loop-patterns` | 5 | rewrite | yes | skills.sh-leaderboard | no | 35 | |
27
+ | 3 | `chrome-devtools-mcp` | 5 | port | no | skills.sh-leaderboard | no | 115 | |
28
+ | 4 | `cursor` | 5 | port | minor | skills.sh-leaderboard | no | 292 | |
29
+ | 5 | `dispatch-loop` | 5 | rewrite | yes | skills.sh-leaderboard | no | 186 | |
30
+ | 6 | `docker` | 5 | port | minor | skills.sh-leaderboard | no | 298 | |
31
+ | 7 | `git-worktree` | 5 | rewrite | yes | skills.sh-leaderboard | no | 246 | |
32
+ | 8 | `hook-patterns` | 5 | port | minor | skills.sh-leaderboard | no | 92 | |
33
+ | 9 | `human-in-the-loop` | 5 | port | minor | skills.sh-leaderboard | no | 93 | |
34
+ | 10 | `linear` *(→ linear-cli)* | 5 | port+sanitize | yes | demand-cluster | no | 70 | |
35
+ | 11 | `mcp-builder` | 5 | port | no | anthropic-official | no | 94 | |
36
+ | 12 | `next-best-practices` | 5 | port+sanitize | yes | skills.sh-leaderboard | no | 249 | |
37
+ | 13 | `next-cache-components` | 5 | port | minor | skills.sh-leaderboard | no | 367 | |
38
+ | 14 | `pdf` | 5 | port | minor | anthropic-official | no | 221 | |
39
+ | 15 | `playwright-cli` *(→ playwright-browser-automation)* | 5 | port | minor | skills.sh-leaderboard | no | 124 | |
40
+ | 16 | `radix-ui` | 5 | port+sanitize | yes | skills.sh-leaderboard | no | 224 | |
41
+ | 17 | `react-best-practices` | 5 | port+sanitize | yes | skills.sh-leaderboard | no | 226 | |
42
+ | 18 | `vercel` *(→ vercel-deployment)* | 5 | port | minor | skills.sh-leaderboard | no | 236 | |
43
+
44
+ ## Tier A — High demand, second wave (4★) (n=29)
45
+
46
+ | Rank | Skill | Pop | Source | Sanitize? | Demand | In Export | Audit Rank | Notes |
47
+ | --- | --- | ---: | --- | --- | --- | ---: | ---: | --- |
48
+ | 19 | `agent-messaging` | 4 | port+sanitize | yes | demand-cluster | no | 79 | cross-agent comm patterns; companion to a2a-protocol |
49
+ | 20 | `agent-session-handoff` | 4 | rewrite | yes | demand-cluster | no | 61 | session continuity; matches multi-agent demand |
50
+ | 21 | `agent-task-delegation` | 4 | rewrite | yes | skills.sh-leaderboard | no | 31 | subagent + dispatch patterns; skills.sh agent-workflows |
51
+ | 22 | `chat-interface` | 4 | rewrite | yes | demand-cluster | no | 320 | chat UI patterns; demand from AI app builders |
52
+ | 23 | `dark-mode` | 4 | port | minor | skills.sh-leaderboard | no | 241 | skills.sh design topic; companion to `dark-mode-implementation` (already pub) |
53
+ | 24 | `doc-co-authoring` | 4 | port | no | anthropic-official | no | 68 | Anthropic official slot is `doc-coauthoring` |
54
+ | 25 | `doc-updater` | 4 | port+sanitize | yes | demand-cluster | no | 210 | doc routing protocol — high demand |
55
+ | 26 | `docs-development` | 4 | port | minor | demand-cluster | no | 117 | docs-as-code; broad audience |
56
+ | 27 | `editorial-standards` | 4 | port | no | demand-cluster | no | 87 | doc quality bar; complements writing-humanizer |
57
+ | 28 | `email-templates` | 4 | port+sanitize | yes | demand-cluster | no | 350 | email patterns; transactional + marketing |
58
+ | 29 | `form-input-ux` | 4 | port | minor | demand-cluster | no | 245 | every app has forms |
59
+ | 30 | `frontend` | 4 | port | minor | demand-cluster | no | 155 | umbrella router skill |
60
+ | 31 | `frontend-structure` | 4 | port | minor | demand-cluster | no | 301 | folder + module conventions |
61
+ | 32 | `graphql` | 4 | port+sanitize | yes | demand-cluster | no | 46 | GraphQL patterns; broad demand |
62
+ | 33 | `i18n` | 4 | port | minor | demand-cluster | no | 355 | internationalization — every consumer app |
63
+ | 34 | `knowledge-graph` | 4 | port | minor | demand-cluster | no | 158 | Skill Graph differentiation; complements `context-graph` |
64
+ | 35 | `linting` | 4 | port+sanitize | yes | demand-cluster | no | 216 | ESLint + custom rule patterns |
65
+ | 36 | `memory-gardener` | 4 | port | minor | demand-cluster | no | 122 | agent memory CRUD/index |
66
+ | 37 | `memory-prune` | 4 | port | minor | demand-cluster | no | 21 | agent memory hygiene |
67
+ | 38 | `methodical` | 4 | rewrite | yes | demand-cluster | no | 218 | RLHF anti-patterns; very portable methodology |
68
+ | 39 | `middleware-architecture` | 4 | port | no | demand-cluster | no | 71 | Next.js/Express middleware patterns |
69
+ | 40 | `motion-design` | 4 | port | no | skills.sh-leaderboard | no | 328 | skills.sh design topic; `delight` adjacent |
70
+ | 41 | `no-cutting-corners` | 4 | port | no | demand-cluster | no | 427 | quality doctrine; companion to `methodical` |
71
+ | 42 | `quality-doctrine` | 4 | port | no | demand-cluster | no | 168 | per-artifact quality definitions |
72
+ | 43 | `self-evaluation` | 4 | port | no | demand-cluster | no | 229 | 1-5 self-score pattern; agent quality |
73
+ | 44 | `self-review-pattern` | 4 | port | no | demand-cluster | no | 281 | generate-critique-revise; eval discipline |
74
+ | 45 | `task-execution` | 4 | port | minor | demand-cluster | no | 100 | task workflow; complements `prioritization` (already pub) |
75
+ | 46 | `task-lifecycle` | 4 | rewrite | yes | demand-cluster | no | 101 | task state machine; agent ops |
76
+ | 47 | `wardley-mapping` | 4 | port | no | demand-cluster | no | 105 | strategic mapping — surging demand 2026 |
77
+
78
+ ## Tier B — Standard utility (3★) (n=42)
79
+
80
+ | Rank | Skill | Pop | Source | Sanitize? | Demand | In Export | Audit Rank | Notes |
81
+ | --- | --- | ---: | --- | --- | --- | ---: | ---: | --- |
82
+ | 48 | `adr` | 3 | port | no | niche | no | 78 | already partial dup of `architecture-decision-records` — merge or supersede |
83
+ | 49 | `agent-behavior` | 3 | port | minor | niche | no | 311 | agent behavior patterns |
84
+ | 50 | `agent-code-documentation` | 3 | port | no | niche | no | 107 | code doc patterns for agent-edited code |
85
+ | 51 | `agent-loop-infra` | 3 | rewrite | yes | niche | no | 59 | loop checkpoint state machine |
86
+ | 52 | `agent-observability` | 3 | port | minor | niche | no | 60 | telemetry pipeline patterns |
87
+ | 53 | `agent-script-control` | 3 | port | minor | niche | no | 259 | agent-driven shell control |
88
+ | 54 | `agent-task-brief` | 3 | port | minor | niche | no | 62 | task spec authoring for agents |
89
+ | 55 | `agent-to-agent` | 3 | port | minor | niche | no | 110 | A2A protocol primer |
90
+ | 56 | `agents` | 3 | port | minor | niche | no | 32 | agent system overview |
91
+ | 57 | `ai-coding-agents` | 3 | port+sanitize | yes | demand-cluster | no | 80 | agent roster + routing — popular topic |
92
+ | 58 | `backend` | 3 | port | minor | niche | no | 113 | backend patterns umbrella |
93
+ | 59 | `backend-structure` | 3 | port | minor | niche | no | 179 | backend folder/module conventions |
94
+ | 60 | `breakpoint-strategy` | 3 | port | no | niche | no | 347 | responsive breakpoint design |
95
+ | 61 | `browser-support` | 3 | port | no | niche | no | 141 | browser compat decisions |
96
+ | 62 | `categorization` | 3 | port | no | niche | no | 180 | classification methodology |
97
+ | 63 | `code-logic` | 3 | port | minor | niche | no | 38 | code reasoning patterns |
98
+ | 64 | `codebase-search` | 3 | port | minor | niche | no | 182 | grep / glob / agent search patterns |
99
+ | 65 | `composition-theory` | 3 | port | no | niche | no | 116 | composition primitives |
100
+ | 66 | `content-strategy` | 3 | port | no | niche | no | 3 | content audit + lifecycle |
101
+ | 67 | `contracts` | 3 | port+sanitize | yes | niche | no | 264 | software contract patterns |
102
+ | 68 | `copywriting` | 3 | port+sanitize | yes | niche | no | 16 | marketing copy; sales-hub-flavored body |
103
+ | 69 | `csv` | 3 | port | no | niche | no | 265 | CSV format patterns |
104
+ | 70 | `data-architect` | 3 | port | minor | niche | no | 293 | data architecture role/patterns |
105
+ | 71 | `data-science` | 3 | port | minor | niche | no | 184 | data science workflow |
106
+ | 72 | `data-sync` | 3 | port | minor | niche | no | 42 | data sync patterns |
107
+ | 73 | `data-table-ux` | 3 | port | minor | niche | no | 206 | TanStack Table adjacent |
108
+ | 74 | `data-viz` | 3 | port+sanitize | yes | niche | no | 84 | chart selection patterns |
109
+ | 75 | `dead-code-detection` | 3 | port | minor | niche | no | 363 | knip / ts-prune patterns |
110
+ | 76 | `dependency-management` | 3 | port | no | niche | no | 295 | npm/pnpm patterns |
111
+ | 77 | `design-execution` | 3 | port+sanitize | yes | niche | no | 148 | design implementation workflow |
112
+ | 78 | `design-guide` | 3 | port | yes | niche | no | 149 | design system authoring |
113
+ | 79 | `design-qa-gate` | 3 | port | minor | niche | no | 185 | design QA pattern |
114
+ | 80 | `design-review` | 3 | port | minor | niche | no | 296 | design review checklist |
115
+ | 81 | `design-token-architecture` | 3 | port | minor | niche | no | 207 | design token system |
116
+ | 82 | `digital-empire` | 3 | port | yes | niche | no | 151 | business model patterns; consider rename |
117
+ | 83 | `dnd-kit` | 3 | port | no | niche | no | 323 | drag-and-drop patterns |
118
+ | 84 | `dorothy` | 3 | port | yes | niche | no | 268 | dialog/decision methodology; consider rename |
119
+ | 85 | `ecosystem-modeling` | 3 | port | minor | niche | no | 86 | ecosystem mapping |
120
+ | 86 | `edge-case-matrix` | 3 | port | no | niche | no | 153 | edge case enumeration |
121
+ | 87 | `experiment` | 3 | port | minor | niche | no | 211 | experimentation workflow |
122
+ | 88 | `feature-gating` | 3 | port | minor | niche | no | 88 | feature flag patterns |
123
+ | 89 | `feedback-collection` | 3 | port | minor | niche | no | 243 | feedback loop patterns |
124
+
125
+ ## Tier C — Niche but publishable (2★) (n=47)
126
+
127
+ | Rank | Skill | Pop | Source | Sanitize? | Demand | In Export | Audit Rank | Notes |
128
+ | --- | --- | ---: | --- | --- | --- | ---: | ---: | --- |
129
+ | 90 | `file-splitting` | 2 | port | no | niche | no | 407 | file size discipline |
130
+ | 91 | `folder-structure` | 2 | port | minor | niche | no | 390 | folder org patterns |
131
+ | 92 | `ghostty` | 2 | port | minor | niche | no | 190 | Ghostty terminal config |
132
+ | 93 | `glossary` | 2 | port | no | niche | no | 91 | terminology management |
133
+ | 94 | `identifying-bottlenecks` | 2 | port | minor | niche | no | 214 | perf bottleneck triage |
134
+ | 95 | `ontology` | 2 | port | no | niche | no | 368 | already partial dup of `ontology-modeling` — merge |
135
+ | 96 | `ooda-loop` | 2 | port | no | niche | no | 163 | OODA methodology |
136
+ | 97 | `orchestration` | 2 | rewrite | yes | niche | no | 50 | orchestration patterns |
137
+ | 98 | `perceptual-integration` | 2 | port | minor | niche | no | 279 | UX perception patterns |
138
+ | 99 | `perspective` | 2 | rewrite | yes | niche | no | 222 | viewpoint/framing methodology |
139
+ | 100 | `provider-abstraction` | 2 | port+sanitize | yes | niche | no | 24 | provider adapter patterns |
140
+ | 101 | `rate-limiting` | 2 | port | minor | niche | no | 402 | rate limiting patterns |
141
+ | 102 | `repository-structure` | 2 | port | minor | niche | no | 335 | monorepo structure patterns |
142
+ | 103 | `responsive` | 2 | port | no | niche | no | 169 | responsive design patterns |
143
+ | 104 | `review-tooling` | 2 | port | minor | niche | no | 336 | code review tools survey |
144
+ | 105 | `scss-expert` | 2 | port | no | niche | no | 308 | SCSS patterns |
145
+ | 106 | `seo-audit` | 2 | port+sanitize | yes | niche | no | 360 | SEO audit checklist |
146
+ | 107 | `sequential-thinking` | 2 | rewrite | yes | niche | no | 338 | sequential reasoning method |
147
+ | 108 | `session-lifecycle` | 2 | rewrite | yes | niche | no | 72 | session hygiene |
148
+ | 109 | `session-progression` | 2 | port | minor | niche | no | 73 | session state progression |
149
+ | 110 | `session-structure` | 2 | port | minor | niche | no | 255 | session shape patterns |
150
+ | 111 | `shape-up` | 2 | port | no | niche | no | 231 | Basecamp Shape Up methodology |
151
+ | 112 | `site-architecture` | 2 | port | minor | niche | no | 282 | IA patterns |
152
+ | 113 | `skill-evolution` | 2 | port | minor | niche | no | 127 | corpus walker pattern |
153
+ | 114 | `skill-portability` | 2 | port | minor | niche | no | 256 | cross-CLI conversion |
154
+ | 115 | `streaming` | 2 | rewrite | yes | niche | no | 232 | streaming patterns |
155
+ | 116 | `task-evaluation` | 2 | port | minor | niche | no | 99 | task quality scoring |
156
+ | 117 | `task-path-optimization` | 2 | port | minor | niche | no | 54 | task graph optimization |
157
+ | 118 | `task-progression` | 2 | rewrite | yes | niche | no | 102 | task state progression |
158
+ | 119 | `task-sizing` | 2 | rewrite | yes | niche | no | 130 | task sizing methodology |
159
+ | 120 | `task-structure` | 2 | port | minor | niche | no | 284 | task shape patterns |
160
+ | 121 | `taxonomy` | 2 | port | no | niche | no | 233 | already partial dup of `taxonomy-design` — merge |
161
+ | 122 | `teaching-patterns` | 2 | port | no | niche | no | 196 | teaching/onboarding patterns |
162
+ | 123 | `technical-debt` | 2 | port | no | niche | no | 376 | tech debt tracking |
163
+ | 124 | `test-coverage` | 2 | port+sanitize | yes | niche | no | 285 | dup of `test-coverage-strategy` — merge |
164
+ | 125 | `test-generator` | 2 | port | minor | niche | no | 174 | test scaffolding patterns |
165
+ | 126 | `theme-factory` | 2 | port | no | anthropic-official | no | 340 | Anthropic official slot — port may conflict |
166
+ | 127 | `threaded-conversations` | 2 | rewrite | yes | niche | no | 103 | threaded UI patterns |
167
+ | 128 | `todo-lists` | 2 | port | no | niche | no | 176 | TODO/task UI patterns |
168
+ | 129 | `token-cost-estimation` | 2 | rewrite | yes | niche | no | 133 | LLM token cost math |
169
+ | 130 | `token-efficiency` | 2 | rewrite | yes | niche | no | 134 | token-efficient agent patterns |
170
+ | 131 | `tui` | 2 | rewrite | yes | niche | no | 234 | terminal UI patterns |
171
+ | 132 | `typography` | 2 | port | no | niche | no | 104 | dup of `typography-system` — merge |
172
+ | 133 | `ui-ux` | 2 | port+sanitize | yes | niche | no | 56 | UI/UX checklist |
173
+ | 134 | `ux-ui-patterns` | 2 | port | no | niche | no | 342 | UX pattern library |
174
+ | 135 | `value-engineering` | 2 | port | no | niche | no | 76 | value engineering methodology |
175
+ | 136 | `visual-design` | 2 | port | no | niche | no | 136 | dup of `visual-design-foundations` — merge |
176
+
177
+ ## Conflicts (53)
178
+
179
+ Ledger classification disagrees with manifest scope. Resolve before next publication batch.
180
+
181
+ | Skill | Ledger | Manifest Scope | Reason |
182
+ | --- | --- | --- | --- |
183
+ | `a2a-protocol` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
184
+ | `anomaly-detection` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
185
+ | `api-key-management` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
186
+ | `audit-traceability` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
187
+ | `backfill-patterns` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
188
+ | `banking` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
189
+ | `benchmarking-engine` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
190
+ | `bulk-operations` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
191
+ | `business-structure` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
192
+ | `canonical-unification` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
193
+ | `configuration-patterns` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
194
+ | `connector-blueprint` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
195
+ | `cost-aggregation` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
196
+ | `credential-encryption` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
197
+ | `csv-import-adapters` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
198
+ | `customer-journey` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
199
+ | `dashboard-modules` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
200
+ | `data-reconciliation` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
201
+ | `demo-data-seeding` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
202
+ | `deterministic` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
203
+ | `domain-modeling` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
204
+ | `duplicate-detection` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
205
+ | `encryption` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
206
+ | `entity-resolution` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
207
+ | `entity-status` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
208
+ | `financial-allocation` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
209
+ | `financial-display-contract` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
210
+ | `financial-metrics` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
211
+ | `fulfillment` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
212
+ | `gdpr-compliance` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
213
+ | `inngest-orchestration` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
214
+ | `invoice` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
215
+ | `kpi-cards` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
216
+ | `materialization-expert` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
217
+ | `multi-tenancy-rls` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
218
+ | `nextauth-patterns` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
219
+ | `page-cro` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
220
+ | `payment-lifecycle` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
221
+ | `product-photo` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
222
+ | `receipts` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
223
+ | `sales-channels` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
224
+ | `security-scanning` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
225
+ | `state-machine-patterns` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
226
+ | `stripe-ledger-recon` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
227
+ | `structured-logging` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
228
+ | `system-resilience` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
229
+ | `system-watchdog` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
230
+ | `temporal-data-patterns` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
231
+ | `troubleshooting` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
232
+ | `url-state-management` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
233
+ | `user-research-synthesis` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
234
+ | `vulnerability` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
235
+ | `websocket` | sales-hub-bound | shared | ledger marks sales-hub-bound but skill is in shared scope; verify ledger reflects current truth |
236
+
237
+ ## Supersedes
238
+
239
+ - `skill-graph/docs/_archived/marketplace-publication-priority-2026-05-18.md`
240
+
@@ -0,0 +1,82 @@
1
+ # Marketplace Release Agent Prompt
2
+
3
+ Use this prompt when handing the next implementation step to an agent. It assumes
4
+ Skill Graph remains the canonical protocol source and the marketplace release is
5
+ a generated public export surface.
6
+
7
+ ```text
8
+ You are working in the Skill Graph repository.
9
+
10
+ Goal: prepare the public marketplace release surface for skills.sh and SkillsMP
11
+ without weakening the canonical Skill Metadata Protocol source.
12
+
13
+ Read first:
14
+
15
+ - AGENTS.MD
16
+ - README.md
17
+ - SKILL_GRAPH.md
18
+ - SKILL_METADATA_PROTOCOL.md
19
+ - docs/quality-doctrine.md
20
+ - docs/marketplace-syndication.md
21
+ - docs/marketplace-skill-candidate-list.md
22
+ - docs/SKILL-MD-FORMAT-COMPATIBILITY.md
23
+ - scripts/export-skill.js
24
+ - scripts/verify-skill-md-export.js
25
+
26
+ Release principles:
27
+
28
+ 1. Keep this repository as the canonical protocol source.
29
+ 2. Generate a public export surface containing only privacy-gated skills.
30
+ 3. Use plain SKILL.md files for the marketplace surface, not protocol-enriched
31
+ source files directly.
32
+ 4. Shorten only export-specific descriptions for skills that exceed marketplace
33
+ or base Agent Skills limits. Do not weaken canonical Skill Metadata Protocol
34
+ descriptions.
35
+ 5. Add factual Skill Graph provenance metadata to exported skills:
36
+ skill_graph_source_repo, skill_graph_protocol, skill_graph_project, and
37
+ skill_graph_canonical_skill.
38
+ 6. Keep readable names and explicit metadata keys. Do not abbreviate names or
39
+ fields to save space.
40
+ 7. Do not publish private project skills, customer workflows, local runtime
41
+ paths, personal names, email addresses, token-like strings, private
42
+ repository names, or local operating context.
43
+ 8. Treat excluded skills as private source material only. If useful ideas should
44
+ become public, rewrite them as general portable skills and re-scan cleanly.
45
+
46
+ Implementation tasks:
47
+
48
+ 1. Start from the canonical Skill Graph skills under skills/.
49
+ 2. Build or extend a deterministic export script that creates the marketplace
50
+ surface from canonical sources.
51
+ 3. Make the generated surface contain one plain SKILL.md per public skill.
52
+ 4. Preserve the canonical source path in provenance metadata.
53
+ 5. Add export-specific descriptions only where required by hard limits.
54
+ 6. Add a privacy gate for the generated surface and fail the release if any
55
+ private/customer/local/personal/token-like signal appears.
56
+ 7. Add a plain Agent Skills shape validation gate for the generated surface.
57
+ 8. Decide and document the GitHub release target: this repo, a dedicated export
58
+ branch, or a dedicated export repository.
59
+ 9. Do not push until the generated surface passes npm.cmd run verify, export
60
+ verification, privacy scanning, and markdown link checking.
61
+ 10. After the release target is pushed, validate skills.sh installation with
62
+ npx skills add jacob-balslev/skills.
63
+ 11. Check SkillsMP discovery after GitHub indexing. If it is not indexed, contact
64
+ SkillsMP with the public GitHub source and the short project description.
65
+
66
+ Required verification:
67
+
68
+ - npm.cmd run verify
69
+ - node scripts/verify-skill-md-export.js
70
+ - node scripts/check-markdown-links.js
71
+ - a privacy scan over the generated export surface
72
+ - a git status check showing no accidental local artifacts staged
73
+
74
+ Short project description for outreach:
75
+
76
+ Skills that know your project and codebase. Structured and categorized. Skill
77
+ Metadata Protocol is a structured frontmatter contract for SKILL.md. Skill Graph
78
+ is the local library tooling that works across those structured skills.
79
+
80
+ Do not release from a dirty working tree. If unrelated local changes exist,
81
+ separate them into their own commits before preparing the marketplace release.
82
+ ```