opencode-skills-collection 3.1.0 → 3.1.2

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 (291) hide show
  1. package/bundled-skills/.antigravity-install-manifest.json +84 -1
  2. package/bundled-skills/2slides-ppt-generator/SKILL.md +8 -7
  3. package/bundled-skills/android-cli/SKILL.md +19 -7
  4. package/bundled-skills/android-ui-journey-testing/SKILL.md +191 -0
  5. package/bundled-skills/apple-notes-search/SKILL.md +12 -2
  6. package/bundled-skills/ask-matt/SKILL.md +92 -0
  7. package/bundled-skills/atlas-ledger/SKILL.md +8 -0
  8. package/bundled-skills/bugs-are-annoying/SKILL.md +137 -0
  9. package/bundled-skills/codebase-design/DEEPENING.md +37 -0
  10. package/bundled-skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
  11. package/bundled-skills/codebase-design/SKILL.md +145 -0
  12. package/bundled-skills/codex-fable5/SKILL.md +10 -2
  13. package/bundled-skills/competitor-analysis/LICENSE.txt +21 -0
  14. package/bundled-skills/competitor-analysis/SKILL.md +434 -0
  15. package/bundled-skills/competitor-analysis/references/battle-card-subagent.md +127 -0
  16. package/bundled-skills/competitor-analysis/references/battle-card.md +91 -0
  17. package/bundled-skills/competitor-analysis/references/example-research.md +130 -0
  18. package/bundled-skills/competitor-analysis/references/report-template.html +127 -0
  19. package/bundled-skills/competitor-analysis/references/research-patterns.md +217 -0
  20. package/bundled-skills/competitor-analysis/references/workflow.md +434 -0
  21. package/bundled-skills/competitor-analysis/scripts/capture_screenshots.mjs +142 -0
  22. package/bundled-skills/competitor-analysis/scripts/compile_report.mjs +929 -0
  23. package/bundled-skills/competitor-analysis/scripts/extract_vs_names.mjs +140 -0
  24. package/bundled-skills/competitor-analysis/scripts/gate_candidates.mjs +224 -0
  25. package/bundled-skills/competitor-analysis/scripts/list_urls.mjs +90 -0
  26. package/bundled-skills/competitor-analysis/scripts/md_utils.mjs +50 -0
  27. package/bundled-skills/competitor-analysis/scripts/merge_partials.mjs +291 -0
  28. package/bundled-skills/competitor-analysis/scripts/package.json +6 -0
  29. package/bundled-skills/design-it/3d-ui/SKILL.md +259 -0
  30. package/bundled-skills/design-it/SKILL.md +170 -0
  31. package/bundled-skills/design-it/ai-native-ui/SKILL.md +295 -0
  32. package/bundled-skills/design-it/aurora-ui/SKILL.md +307 -0
  33. package/bundled-skills/design-it/bento-ui/SKILL.md +314 -0
  34. package/bundled-skills/design-it/brutalism/SKILL.md +270 -0
  35. package/bundled-skills/design-it/brutalist-typography/SKILL.md +287 -0
  36. package/bundled-skills/design-it/card-based-design/SKILL.md +262 -0
  37. package/bundled-skills/design-it/claymorphism/SKILL.md +287 -0
  38. package/bundled-skills/design-it/color-blocking/SKILL.md +278 -0
  39. package/bundled-skills/design-it/command-center-ui/SKILL.md +345 -0
  40. package/bundled-skills/design-it/cyber-y2k/SKILL.md +312 -0
  41. package/bundled-skills/design-it/cyberpunk-ui/SKILL.md +262 -0
  42. package/bundled-skills/design-it/dark-mode/SKILL.md +289 -0
  43. package/bundled-skills/design-it/dashboard-design/SKILL.md +331 -0
  44. package/bundled-skills/design-it/data-dense-design/SKILL.md +322 -0
  45. package/bundled-skills/design-it/duotone-design/SKILL.md +248 -0
  46. package/bundled-skills/design-it/editorial-design/SKILL.md +328 -0
  47. package/bundled-skills/design-it/flat-design/SKILL.md +221 -0
  48. package/bundled-skills/design-it/flat-design-2/SKILL.md +240 -0
  49. package/bundled-skills/design-it/floating-ui/SKILL.md +299 -0
  50. package/bundled-skills/design-it/frutiger-aero/SKILL.md +274 -0
  51. package/bundled-skills/design-it/glassmorphism/SKILL.md +272 -0
  52. package/bundled-skills/design-it/gradient-design/SKILL.md +309 -0
  53. package/bundled-skills/design-it/high-contrast/SKILL.md +288 -0
  54. package/bundled-skills/design-it/holographic-ui/SKILL.md +310 -0
  55. package/bundled-skills/design-it/isometric-design/SKILL.md +228 -0
  56. package/bundled-skills/design-it/layered-design/SKILL.md +247 -0
  57. package/bundled-skills/design-it/material-design/SKILL.md +275 -0
  58. package/bundled-skills/design-it/maximalism/SKILL.md +297 -0
  59. package/bundled-skills/design-it/minimalism/SKILL.md +267 -0
  60. package/bundled-skills/design-it/monochromatic-ui/SKILL.md +296 -0
  61. package/bundled-skills/design-it/neo-brutalism/SKILL.md +270 -0
  62. package/bundled-skills/design-it/neumorphism/SKILL.md +248 -0
  63. package/bundled-skills/design-it/retro-design/SKILL.md +283 -0
  64. package/bundled-skills/design-it/retro-futurism/SKILL.md +259 -0
  65. package/bundled-skills/design-it/sci-fi-interface/SKILL.md +309 -0
  66. package/bundled-skills/design-it/skeuomorphism/SKILL.md +280 -0
  67. package/bundled-skills/design-it/soft-pastel/SKILL.md +307 -0
  68. package/bundled-skills/design-it/spatial-computing-ui/SKILL.md +300 -0
  69. package/bundled-skills/design-it/spatial-design/SKILL.md +268 -0
  70. package/bundled-skills/design-it/swiss-design/SKILL.md +293 -0
  71. package/bundled-skills/design-it/synthwave/SKILL.md +257 -0
  72. package/bundled-skills/design-it/tile-design/SKILL.md +297 -0
  73. package/bundled-skills/design-it/typography-first/SKILL.md +247 -0
  74. package/bundled-skills/design-it/vaporwave/SKILL.md +331 -0
  75. package/bundled-skills/design-it/vibrant-maximalism/SKILL.md +291 -0
  76. package/bundled-skills/design-it/widget-based-design/SKILL.md +274 -0
  77. package/bundled-skills/design-it/y2k-design/SKILL.md +268 -0
  78. package/bundled-skills/diagnosing-bugs/SKILL.md +165 -0
  79. package/bundled-skills/diagnosing-bugs/scripts/hitl-loop.template.sh +41 -0
  80. package/bundled-skills/docs/contributors/skill-scoring.md +235 -0
  81. package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
  82. package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
  83. package/bundled-skills/docs/maintainers/repo-growth-seo.md +3 -3
  84. package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
  85. package/bundled-skills/docs/users/bundles.md +145 -1
  86. package/bundled-skills/docs/users/claude-code-skills.md +1 -1
  87. package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
  88. package/bundled-skills/docs/users/getting-started.md +1 -1
  89. package/bundled-skills/docs/users/kiro-integration.md +1 -1
  90. package/bundled-skills/docs/users/specialized-plugin-roadmap.md +11 -4
  91. package/bundled-skills/docs/users/usage.md +4 -4
  92. package/bundled-skills/docs/users/visual-guide.md +4 -4
  93. package/bundled-skills/domain-modeling/ADR-FORMAT.md +47 -0
  94. package/bundled-skills/domain-modeling/CONTEXT-FORMAT.md +60 -0
  95. package/bundled-skills/domain-modeling/SKILL.md +105 -0
  96. package/bundled-skills/dos-verify-done-claims/SKILL.md +16 -4
  97. package/bundled-skills/ecl-harness-engineer/agents/creator-config.md +1 -1
  98. package/bundled-skills/ecl-harness-engineer/references/environment-config-guide.md +2 -2
  99. package/bundled-skills/ecl-harness-engineer/references/environment-detection-guide.md +4 -4
  100. package/bundled-skills/event-staffing-ordering/SKILL.md +4 -0
  101. package/bundled-skills/grill-me/SKILL.md +36 -0
  102. package/bundled-skills/grill-with-docs/SKILL.md +36 -0
  103. package/bundled-skills/grilling/SKILL.md +39 -0
  104. package/bundled-skills/handoff/SKILL.md +45 -0
  105. package/bundled-skills/image-generator/.env.example +7 -0
  106. package/bundled-skills/image-generator/SKILL.md +509 -0
  107. package/bundled-skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
  108. package/bundled-skills/improve-codebase-architecture/SKILL.md +97 -0
  109. package/bundled-skills/learn/SKILL.md +156 -0
  110. package/bundled-skills/lesson-generator/SKILL.md +90 -0
  111. package/bundled-skills/llm-council/.env.example +7 -0
  112. package/bundled-skills/llm-council/SKILL.md +602 -0
  113. package/bundled-skills/loop-library/SKILL.md +208 -0
  114. package/bundled-skills/loop-library/agents/openai.yaml +4 -0
  115. package/bundled-skills/loop-library/references/catalog.md +270 -0
  116. package/bundled-skills/lovable-cleanup/SKILL.md +9 -7
  117. package/bundled-skills/macos-screen-recorder/SKILL.md +9 -1
  118. package/bundled-skills/mailtrap-managing-contacts/SKILL.md +112 -0
  119. package/bundled-skills/mailtrap-sending-emails/SKILL.md +167 -0
  120. package/bundled-skills/mailtrap-setting-up-sending-domain/SKILL.md +77 -0
  121. package/bundled-skills/mailtrap-testing-with-sandbox/SKILL.md +110 -0
  122. package/bundled-skills/prototype/LOGIC.md +79 -0
  123. package/bundled-skills/prototype/SKILL.md +62 -0
  124. package/bundled-skills/prototype/UI.md +112 -0
  125. package/bundled-skills/screenstudio-alt/SKILL.md +9 -1
  126. package/bundled-skills/setup-matt-pocock-skills/SKILL.md +158 -0
  127. package/bundled-skills/setup-matt-pocock-skills/domain.md +51 -0
  128. package/bundled-skills/setup-matt-pocock-skills/issue-tracker-github.md +34 -0
  129. package/bundled-skills/setup-matt-pocock-skills/issue-tracker-gitlab.md +35 -0
  130. package/bundled-skills/setup-matt-pocock-skills/issue-tracker-local.md +19 -0
  131. package/bundled-skills/setup-matt-pocock-skills/triage-labels.md +15 -0
  132. package/bundled-skills/survey-generator/LICENSE +21 -0
  133. package/bundled-skills/survey-generator/SKILL.md +143 -0
  134. package/bundled-skills/survey-generator/build_artifact.py +208 -0
  135. package/bundled-skills/survey-generator/examples/agentic-engineering/research_bundle.json +1196 -0
  136. package/bundled-skills/survey-generator/examples/agentic-engineering/survey.html +706 -0
  137. package/bundled-skills/survey-generator/style_spec.json +85 -0
  138. package/bundled-skills/survey-generator/templates/research_bundle_template.json +69 -0
  139. package/bundled-skills/tdd/SKILL.md +139 -0
  140. package/bundled-skills/tdd/mocking.md +59 -0
  141. package/bundled-skills/tdd/refactoring.md +10 -0
  142. package/bundled-skills/tdd/tests.md +61 -0
  143. package/bundled-skills/teach/GLOSSARY-FORMAT.md +35 -0
  144. package/bundled-skills/teach/LEARNING-RECORD-FORMAT.md +46 -0
  145. package/bundled-skills/teach/MISSION-FORMAT.md +31 -0
  146. package/bundled-skills/teach/RESOURCES-FORMAT.md +32 -0
  147. package/bundled-skills/teach/SKILL.md +169 -0
  148. package/bundled-skills/to-issues/SKILL.md +115 -0
  149. package/bundled-skills/to-prd/SKILL.md +104 -0
  150. package/bundled-skills/tools-page-seo-optimizer/SKILL.md +616 -0
  151. package/bundled-skills/triage/AGENT-BRIEF.md +207 -0
  152. package/bundled-skills/triage/OUT-OF-SCOPE.md +105 -0
  153. package/bundled-skills/triage/SKILL.md +143 -0
  154. package/bundled-skills/vibecode-production-qa-validator/SKILL.md +371 -141
  155. package/bundled-skills/wiki-builder/SKILL.md +157 -0
  156. package/bundled-skills/wiki-builder/agents/openai.yaml +5 -0
  157. package/bundled-skills/wiki-builder/references/wiki-flavors.md +98 -0
  158. package/bundled-skills/wiki-builder/scripts/init_wiki.sh +105 -0
  159. package/bundled-skills/wiki-builder/templates/index.md +20 -0
  160. package/bundled-skills/wiki-builder/templates/maintenance-log.md +7 -0
  161. package/bundled-skills/wiki-builder/templates/prompts/compile-concept-page.md +12 -0
  162. package/bundled-skills/wiki-builder/templates/prompts/compile-index.md +11 -0
  163. package/bundled-skills/wiki-builder/templates/prompts/compile-source-page.md +12 -0
  164. package/bundled-skills/wiki-builder/templates/prompts/lint-wiki.md +10 -0
  165. package/bundled-skills/wiki-builder/templates/prompts/query-and-file.md +11 -0
  166. package/bundled-skills/wiki-builder/templates/sources.md +9 -0
  167. package/bundled-skills/wiki-builder/templates/wiki.config.md +53 -0
  168. package/bundled-skills/writing-great-skills/GLOSSARY.md +181 -0
  169. package/bundled-skills/writing-great-skills/SKILL.md +111 -0
  170. package/bundled-skills/yao-meta-skill/SKILL.md +86 -0
  171. package/bundled-skills/yao-meta-skill/agents/interface.yaml +26 -0
  172. package/bundled-skills/yao-meta-skill/manifest.json +24 -0
  173. package/bundled-skills/yao-meta-skill/references/artifact-design-doctrine.md +49 -0
  174. package/bundled-skills/yao-meta-skill/references/authoring-discipline.md +78 -0
  175. package/bundled-skills/yao-meta-skill/references/autonomous-adaptation.md +65 -0
  176. package/bundled-skills/yao-meta-skill/references/distribution-registry-method.md +60 -0
  177. package/bundled-skills/yao-meta-skill/references/eval-playbook.md +69 -0
  178. package/bundled-skills/yao-meta-skill/references/gate-selection.md +68 -0
  179. package/bundled-skills/yao-meta-skill/references/governance.md +134 -0
  180. package/bundled-skills/yao-meta-skill/references/human-review-template.md +54 -0
  181. package/bundled-skills/yao-meta-skill/references/intent-dialogue.md +138 -0
  182. package/bundled-skills/yao-meta-skill/references/iteration-philosophy.md +30 -0
  183. package/bundled-skills/yao-meta-skill/references/non-skill-decision-tree.md +39 -0
  184. package/bundled-skills/yao-meta-skill/references/operating-modes.md +107 -0
  185. package/bundled-skills/yao-meta-skill/references/output-eval-method.md +113 -0
  186. package/bundled-skills/yao-meta-skill/references/output-quality-risk.md +41 -0
  187. package/bundled-skills/yao-meta-skill/references/output-visual-quality.md +53 -0
  188. package/bundled-skills/yao-meta-skill/references/packaging-contracts.md +70 -0
  189. package/bundled-skills/yao-meta-skill/references/pattern-extraction-doctrine.md +76 -0
  190. package/bundled-skills/yao-meta-skill/references/platform-capability-matrix.md +49 -0
  191. package/bundled-skills/yao-meta-skill/references/prompt-engineering-doctrine.md +76 -0
  192. package/bundled-skills/yao-meta-skill/references/qa-ladder.md +57 -0
  193. package/bundled-skills/yao-meta-skill/references/reference-scan.md +126 -0
  194. package/bundled-skills/yao-meta-skill/references/regression-cause-taxonomy.md +80 -0
  195. package/bundled-skills/yao-meta-skill/references/resource-boundaries.md +120 -0
  196. package/bundled-skills/yao-meta-skill/references/review-studio-method.md +87 -0
  197. package/bundled-skills/yao-meta-skill/references/review-waiver-method.md +76 -0
  198. package/bundled-skills/yao-meta-skill/references/runtime-conformance-method.md +21 -0
  199. package/bundled-skills/yao-meta-skill/references/skill-archetypes.md +86 -0
  200. package/bundled-skills/yao-meta-skill/references/skill-atlas-method.md +35 -0
  201. package/bundled-skills/yao-meta-skill/references/skill-engineering-method.md +210 -0
  202. package/bundled-skills/yao-meta-skill/references/skill-ir-method.md +41 -0
  203. package/bundled-skills/yao-meta-skill/references/skillops-decision-policy.md +53 -0
  204. package/bundled-skills/yao-meta-skill/references/systems-thinking-doctrine.md +75 -0
  205. package/bundled-skills/yao-meta-skill/references/telemetry-drift-method.md +182 -0
  206. package/bundled-skills/yao-meta-skill/references/trust-security-method.md +79 -0
  207. package/bundled-skills/yao-meta-skill/references/user-memory-policy.md +35 -0
  208. package/bundled-skills/youtube-notetaker/SKILL.md +209 -0
  209. package/bundled-skills/youtube-notetaker/reference/artifact.html +269 -0
  210. package/bundled-skills/youtube-notetaker/scripts/contact_sheet.py +53 -0
  211. package/bundled-skills/youtube-notetaker/scripts/detect_slides.sh +19 -0
  212. package/bundled-skills/youtube-notetaker/scripts/download.sh +24 -0
  213. package/bundled-skills/youtube-notetaker/scripts/extract_slides.py +43 -0
  214. package/bundled-skills/youtube-notetaker/scripts/serve.py +222 -0
  215. package/bundled-skills/youtube-notetaker/scripts/setup.sh +27 -0
  216. package/bundled-skills/youtube-notetaker/scripts/verify.sh +31 -0
  217. package/bundled-skills/youtube-notetaker/scripts/vtt_to_transcript.py +59 -0
  218. package/bundled-skills/youtube-notetaker/scripts/write_library_item.py +69 -0
  219. package/package.json +1 -1
  220. package/skills_index.json +2013 -330
  221. package/bundled-skills/ai-md/SKILL.md +0 -523
  222. package/bundled-skills/atlas-contract/SKILL.md +0 -650
  223. package/bundled-skills/busybox-on-windows/SKILL.md +0 -40
  224. package/bundled-skills/monte-carlo-prevent/SKILL.md +0 -257
  225. package/bundled-skills/monte-carlo-prevent/references/TROUBLESHOOTING.md +0 -23
  226. package/bundled-skills/monte-carlo-prevent/references/parameters.md +0 -32
  227. package/bundled-skills/monte-carlo-prevent/references/workflows.md +0 -478
  228. package/bundled-skills/monte-carlo-push-ingestion/SKILL.md +0 -372
  229. package/bundled-skills/monte-carlo-push-ingestion/references/anomaly-detection.md +0 -87
  230. package/bundled-skills/monte-carlo-push-ingestion/references/custom-lineage.md +0 -203
  231. package/bundled-skills/monte-carlo-push-ingestion/references/direct-http-api.md +0 -207
  232. package/bundled-skills/monte-carlo-push-ingestion/references/prerequisites.md +0 -150
  233. package/bundled-skills/monte-carlo-push-ingestion/references/push-lineage.md +0 -160
  234. package/bundled-skills/monte-carlo-push-ingestion/references/push-metadata.md +0 -158
  235. package/bundled-skills/monte-carlo-push-ingestion/references/push-query-logs.md +0 -219
  236. package/bundled-skills/monte-carlo-push-ingestion/references/validation.md +0 -257
  237. package/bundled-skills/monte-carlo-push-ingestion/scripts/sample_verify.py +0 -357
  238. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_and_push_lineage.py +0 -70
  239. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_and_push_metadata.py +0 -65
  240. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_and_push_query_logs.py +0 -70
  241. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_lineage.py +0 -214
  242. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_metadata.py +0 -160
  243. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/collect_query_logs.py +0 -164
  244. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/push_lineage.py +0 -198
  245. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/push_metadata.py +0 -193
  246. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery/push_query_logs.py +0 -207
  247. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_and_push_metadata.py +0 -71
  248. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_and_push_query_logs.py +0 -64
  249. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_metadata.py +0 -253
  250. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/collect_query_logs.py +0 -149
  251. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/push_metadata.py +0 -190
  252. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/bigquery-iceberg/push_query_logs.py +0 -208
  253. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_and_push_lineage.py +0 -83
  254. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_and_push_metadata.py +0 -77
  255. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_and_push_query_logs.py +0 -83
  256. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_lineage.py +0 -240
  257. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_metadata.py +0 -212
  258. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/collect_query_logs.py +0 -204
  259. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/push_lineage.py +0 -192
  260. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/push_metadata.py +0 -178
  261. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/databricks/push_query_logs.py +0 -200
  262. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_and_push_lineage.py +0 -119
  263. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_and_push_metadata.py +0 -119
  264. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_and_push_query_logs.py +0 -117
  265. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_lineage.py +0 -265
  266. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_metadata.py +0 -313
  267. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/collect_query_logs.py +0 -284
  268. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/push_lineage.py +0 -309
  269. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/push_metadata.py +0 -245
  270. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/hive/push_query_logs.py +0 -255
  271. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_and_push_lineage.py +0 -78
  272. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_and_push_metadata.py +0 -80
  273. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_and_push_query_logs.py +0 -88
  274. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_lineage.py +0 -235
  275. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_metadata.py +0 -219
  276. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/collect_query_logs.py +0 -239
  277. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/push_lineage.py +0 -178
  278. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/push_metadata.py +0 -178
  279. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/redshift/push_query_logs.py +0 -196
  280. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_and_push_lineage.py +0 -154
  281. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_and_push_metadata.py +0 -137
  282. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_and_push_query_logs.py +0 -137
  283. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_lineage.py +0 -349
  284. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_metadata.py +0 -329
  285. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/collect_query_logs.py +0 -254
  286. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/push_lineage.py +0 -307
  287. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/push_metadata.py +0 -228
  288. package/bundled-skills/monte-carlo-push-ingestion/scripts/templates/snowflake/push_query_logs.py +0 -248
  289. package/bundled-skills/monte-carlo-push-ingestion/scripts/test_template_sdk_usage.py +0 -340
  290. package/bundled-skills/skill-optimizer/SKILL.md +0 -271
  291. package/bundled-skills/using-superpowers/SKILL.md +0 -98
@@ -0,0 +1,126 @@
1
+ # Reference Scan Strategy
2
+
3
+ Use a short benchmark scan before deep authoring. The goal is to borrow durable patterns from strong reference objects without importing their prose, weight, or brand language into the new skill.
4
+
5
+ ## Source Priority
6
+
7
+ Reference scan has two layers, and they must not be treated equally:
8
+
9
+ 1. **External Benchmark Scan**
10
+ - primary source of patterns
11
+ - use high-star public GitHub repos, official docs, strong public examples, and world-class products
12
+ - this layer defines the upper bound for quality
13
+ 2. **User Reference Intake**
14
+ - a taste-and-standard layer
15
+ - ask whether the user has reference repos, products, pages, prompts, or systems they admire
16
+ - learn only the pattern, structure, boundary, or quality bar; never copy wording or private material
17
+ 3. **Local Fit Check**
18
+ - secondary calibration layer
19
+ - use local files only for naming, privacy, compatibility, migration, and library-fit constraints
20
+ - this layer should not define the main design pattern
21
+
22
+ External sources should lead. User references should sharpen direction. Local files should calibrate.
23
+
24
+ ## Default Visibility
25
+
26
+ Reference synthesis should be silent by default.
27
+
28
+ - do the benchmark scan and pattern synthesis in the background
29
+ - convert the result into a recommendation for the user
30
+ - surface the full evidence only to authors and reviewers
31
+ - only expose the underlying tradeoffs to the user when intent is still uncertain or a real design conflict needs a decision
32
+
33
+ ## Why This Step Exists
34
+
35
+ A new skill often fails because it starts from an isolated idea instead of a proven pattern. A controlled reference scan improves the package before it grows:
36
+
37
+ - better boundary design
38
+ - cleaner folder and metadata choices
39
+ - more realistic quality gates
40
+ - stronger portability decisions
41
+ - better alignment with the user's own taste and quality bar
42
+
43
+ ## The Rule
44
+
45
+ Reference scanning is mandatory for:
46
+
47
+ - `Production` skills
48
+ - `Library` skills
49
+ - `Governed` skills
50
+ - meta-skills or packaging-heavy skills
51
+
52
+ Reference scanning is optional for:
53
+
54
+ - `Scaffold` skills
55
+ - one-person exploratory skills
56
+
57
+ ## Scope Limit
58
+
59
+ Do not turn this into open-ended research.
60
+
61
+ - scan at most `3-5` reference objects
62
+ - pick from no more than `3` categories
63
+ - extract patterns, not long copied content
64
+ - stop as soon as the borrow plan is clear
65
+ - prefer at least `2` external benchmark objects before treating the scan as complete
66
+ - if the user provides references, record what they admire and what should explicitly not be copied
67
+
68
+ ## Pattern Acceptance
69
+
70
+ Borrowed ideas must pass a lightweight pattern test before they shape the first package.
71
+
72
+ - `recurrence`: the pattern appears in more than one serious context or source
73
+ - `generativity`: the pattern can guide new cases, not just explain one example
74
+ - `distinctiveness`: the pattern is more specific than generic good advice
75
+ - `boundary`: the pattern names where not to apply it or what cost it introduces
76
+
77
+ For low-risk scaffold work, generativity plus boundary clarity can be enough. For production, library, and governed work, require more evidence before the pattern changes the package shape.
78
+
79
+ See [Pattern Extraction Doctrine](pattern-extraction-doctrine.md).
80
+
81
+ ## Reference Categories
82
+
83
+ Choose the smallest relevant set:
84
+
85
+ - `method`: loops, evaluation discipline, iteration structure
86
+ - `structure`: package anatomy, resource boundaries, metadata patterns
87
+ - `execution`: operator flow, scripts, initialization and validation experience
88
+ - `portability`: neutral metadata, adapters, degradation strategy
89
+ - `domain`: workflow-specific patterns from a top example in the same problem space
90
+
91
+ ## Output Format
92
+
93
+ A good scan produces a short report with:
94
+
95
+ 1. current skill anchor
96
+ 2. scan focus
97
+ 3. external benchmark objects
98
+ 4. user-supplied references
99
+ 5. local fit constraints
100
+ 6. what to borrow
101
+ 7. what not to borrow
102
+ 8. a compact borrow plan
103
+
104
+ ## What To Borrow
105
+
106
+ Borrow:
107
+
108
+ - repeatable loops
109
+ - clear boundary patterns
110
+ - proven gate choices
111
+ - portable metadata ideas
112
+ - clear operator-facing flows
113
+ - high-signal examples that show the finished experience, not just the internal method
114
+
115
+ Do not borrow:
116
+
117
+ - source-specific branding
118
+ - long copied prose
119
+ - unnecessary directories
120
+ - quality gates that exceed the skill's risk tier
121
+ - platform lock-in disguised as best practice
122
+ - local historical habits that are weaker than public top-tier benchmarks
123
+
124
+ ## Design Principle
125
+
126
+ The scan is successful only if it raises skill quality faster than it raises context cost. If benchmark material makes the new skill heavier without making it more reliable, discard it.
@@ -0,0 +1,80 @@
1
+ # Regression Cause Taxonomy
2
+
3
+ This taxonomy explains how iteration regressions are classified when a description candidate is evaluated for promotion.
4
+
5
+ ## Core Principle
6
+
7
+ A candidate should not be judged only by aggregate pass/fail counts. The iteration system should explain why a candidate was blocked, kept behind the current description, or promoted.
8
+
9
+ ## Cause Tags
10
+
11
+ ### `no_candidate_outperformed_current`
12
+
13
+ The selected winner is still the current description. No candidate earned promotion.
14
+
15
+ ### `visible_holdout_regression`
16
+
17
+ The candidate regressed on the visible holdout suite by adding false positives or false negatives.
18
+
19
+ ### `blind_holdout_regression`
20
+
21
+ The candidate regressed on blind holdout prompts. This blocks promotion because the failure is not only local to the tuning loop.
22
+
23
+ ### `current_holdout_gap_present`
24
+
25
+ The current or selected winner still carries a visible holdout miss. Promotion may still stay on `keep_current`, but the iteration bundle should show the unresolved gap.
26
+
27
+ ### `current_holdout_risk`
28
+
29
+ The visible holdout calibration still looks risky even when promotion is not blocked. This is an audit signal that the route boundary needs future work.
30
+
31
+ ### `judge_blind_regression`
32
+
33
+ The rubric judge found worse blind-holdout behavior than the current or baseline description.
34
+
35
+ ### `judge_blind_low_agreement`
36
+
37
+ The judge-backed blind evaluation did not produce enough agreement confidence to support promotion.
38
+
39
+ ### `adversarial_regression`
40
+
41
+ The candidate performed worse on adversarial holdout prompts that simulate route collisions or disguised requests.
42
+
43
+ ### `adversarial_overlap_risk`
44
+
45
+ The adversarial calibration layer reports an `overlap` risk band, meaning route boundaries are too weak for safe promotion.
46
+
47
+ ### `adversarial_watch_risk`
48
+
49
+ The adversarial calibration layer reports a non-failing but cautionary risk band such as `watch` or `tight`.
50
+
51
+ ### `family_instability`
52
+
53
+ At least one tracked family stops being clean under blind, judge-backed blind, or adversarial evaluation.
54
+
55
+ ### `route_confusion`
56
+
57
+ The route confusion matrix shows route theft or misrouting between sibling skills.
58
+
59
+ ### `route_ambiguity`
60
+
61
+ The route confusion matrix reports ambiguous cases near the configured margin-warning threshold.
62
+
63
+ ### `longer_without_gain`
64
+
65
+ The candidate is materially longer than the current description without producing a better route outcome.
66
+
67
+ ### `promotion_ready`
68
+
69
+ The candidate passed every promotion gate and is eligible for review and promotion.
70
+
71
+ ## Usage
72
+
73
+ These cause tags should appear in:
74
+
75
+ - promotion decisions
76
+ - iteration bundles
77
+ - regression histories
78
+ - human review summaries
79
+
80
+ They are intended to make iteration auditable rather than merely descriptive.
@@ -0,0 +1,120 @@
1
+ # Resource Boundary Spec
2
+
3
+ This spec defines where information belongs inside a skill package.
4
+
5
+ ## Principle
6
+
7
+ Keep the main skill small enough to route and execute clearly. Move detail out of `SKILL.md` as soon as it stops helping routing or branch selection.
8
+
9
+ Do not add structure for imagined future needs. A folder, script, eval, or governance file belongs in the package only when it reduces current ambiguity, execution burden, route risk, or maintenance risk.
10
+
11
+ ## Context Budget Tiers
12
+
13
+ Use the lightest budget that still fits the package.
14
+
15
+ - `scaffold`: `700` initial-load tokens
16
+ - `production`: `1000` initial-load tokens
17
+ - `library`: `1300` initial-load tokens
18
+ - `governed`: `1300` initial-load tokens
19
+
20
+ If `manifest.json` sets `context_budget_tier`, that tier overrides the default budget derived from lifecycle or maturity metadata. This allows a high-governance skill to keep a stricter initial-load budget than its lifecycle label alone would imply.
21
+
22
+ ## Placement Rules
23
+
24
+ ### Put content in `SKILL.md` when it is:
25
+
26
+ - part of the trigger surface
27
+ - part of the core execution skeleton
28
+ - part of the output contract
29
+ - necessary for branch selection or safe defaults
30
+
31
+ ### Put content in `references/` when it is:
32
+
33
+ - domain guidance
34
+ - long examples
35
+ - policy material
36
+ - schemas or templates humans or agents may read on demand
37
+
38
+ ### Put content in `scripts/` when it is:
39
+
40
+ - deterministic
41
+ - repetitive
42
+ - brittle if rewritten from prose
43
+ - easier to validate as code than as instructions
44
+
45
+ ### Put content in `evals/` when:
46
+
47
+ - the skill is reused enough that routing mistakes matter
48
+ - near-neighbor confusion is likely
49
+ - quality claims should be reproducible
50
+
51
+ ### Put content in `assets/` when:
52
+
53
+ - the package includes output artifacts, examples, or static files that should not bloat prompt context
54
+
55
+ ## Anti-Patterns
56
+
57
+ Avoid these:
58
+
59
+ - storing long policy text directly in `SKILL.md`
60
+ - adding `references/` with no files that are actually used
61
+ - adding `scripts/` for logic that is still best expressed in prose
62
+ - adding `evals/` for one-off or disposable skills
63
+ - creating every folder by default even when empty
64
+ - keeping folders that are neither referenced in `SKILL.md` nor declared as factory components
65
+ - adding broad configuration knobs before a real variation exists
66
+ - adding governance or reports to make a scaffold look mature when no reuse pressure exists
67
+
68
+ ## Heuristics
69
+
70
+ ### `SKILL.md`
71
+
72
+ - should stay focused
73
+ - should not become the full knowledge base
74
+ - should mention any optional directory that materially affects execution
75
+
76
+ ### `references/`
77
+
78
+ - should earn their keep
79
+ - should usually be named and discoverable from `SKILL.md`
80
+
81
+ ### `scripts/`
82
+
83
+ - should exist only when deterministic logic or formatting logic is real
84
+ - should be referenced explicitly from `SKILL.md` when required for execution
85
+
86
+ ### `evals/`
87
+
88
+ - should exist when routing or quality claims need to be defended
89
+ - should be skipped for disposable personal drafts
90
+
91
+ ## Unused Resource Detection
92
+
93
+ `resource_boundary_check.py` warns when a non-empty optional directory appears decorative:
94
+
95
+ - the directory exists and contains files
96
+ - the main `SKILL.md` does not reference it
97
+ - and the directory is not declared in `manifest.json` factory components
98
+
99
+ This protects the package from looking more sophisticated than it actually is.
100
+
101
+ ## Quality Density
102
+
103
+ The checker also reports `quality_density`, a local signal for how much governance and quality evidence is packed into the initial load budget.
104
+
105
+ It combines:
106
+
107
+ - governance score
108
+ - presence of evals
109
+ - presence of reports
110
+ - references and scripts
111
+ - interface and manifest metadata
112
+ - failure or test evidence
113
+
114
+ Higher density means the package is staying lean while still proving quality.
115
+
116
+ ## Quality Intent
117
+
118
+ The best skill is not the one with the most files. The best skill is the smallest package that still makes the recurring job reliable, reusable, and auditable.
119
+
120
+ See [Authoring Discipline](authoring-discipline.md) for the author and reviewer rules that keep resource growth tied to a real user goal.
@@ -0,0 +1,87 @@
1
+ # Review Studio 2.0 Method
2
+
3
+ Review Studio is the release-facing audit surface for a skill package. It does not replace the detailed reports; it turns them into one reviewer decision page.
4
+
5
+ ## Purpose
6
+
7
+ - Show release blockers and warnings before the package deepens.
8
+ - Link every gate back to a concrete evidence artifact.
9
+ - Generate review actions for every blocker and warning, with source-fix location and verification command.
10
+ - Make human warning acceptance auditable through a waiver ledger.
11
+ - Make reviewer comments auditable through an annotation ledger tied to gates, source/report paths, and optional line numbers.
12
+ - Keep review flow vertical: summary first, gates second, supporting details after.
13
+ - Avoid hiding output quality, runtime, trust, portfolio, and operating-loop issues across separate pages.
14
+
15
+ ## Required Gates
16
+
17
+ 1. Intent Canvas: intent confidence and unresolved input/output/exclusion gaps.
18
+ 2. Trigger Lab: route scorecard, misroutes, ambiguous cases, and near-neighbor safety.
19
+ 3. Output Lab: with-skill vs baseline delta, execution mode, timing/token evidence, case count, file-backed cases, near-neighbor cases, boundary cases, blind A/B review pack evidence, and reviewer adjudication status.
20
+ 4. Context Budget: initial load, budget tier, warnings, and quality density.
21
+ 5. Runtime Matrix: target conformance pass/fail and degradation notes.
22
+ 6. Trust Report: secret scan, script surface, dependency pinning, network/interactive flags, and package hash.
23
+ 7. Permission Gates: reviewer-approved capability scope, reason, expiry, evidence, and target-enforcement notes.
24
+ 8. Runtime Permission Probes: packaged adapter permission contracts, native-enforcement flags, metadata fallback notes, and residual risks.
25
+ 9. Skill Atlas: route collisions, stale skills, owner gaps, and no-route opportunities.
26
+ 10. Operations Loop: local-first metadata-only adoption, missed-trigger, bad-output, script-error, and review-drift signals.
27
+ 11. Review Waivers: human risk approvals, active coverage, expired approvals, invalid records, and expiry policy.
28
+ 12. Registry Audit: package metadata, install evidence, compatibility entries, and archive/source checksums.
29
+ 13. Release Notes: promotion status, migration notes, known gaps, and next move.
30
+
31
+ ## Gate Semantics
32
+
33
+ - `pass`: evidence is present and the gate is satisfied.
34
+ - `warn`: review can continue, but the issue must be visible before release.
35
+ - `block`: do not claim production, library, governed, or public readiness until fixed.
36
+
37
+ For library and governed skills, Output Lab should have at least five cases and cover file-backed, near-neighbor, and boundary scenarios.
38
+
39
+ Production, library, and governed reviews should also show a blind A/B review pack. The Review Studio gate may warn when scorecard evidence exists but no blind pack is present, because the package can prove assertions but not yet reduce reviewer bias.
40
+
41
+ When `reports/output_execution_runs.json` exists, Review Studio should show the number of variant runs, command-executed runs, model-executed runs, recorded fixtures, timing-observed runs, and token-estimated runs. Recorded fixtures are valid reproducibility evidence, but they must not be described as model-executed output evidence.
42
+
43
+ When `reports/output_review_adjudication.json` exists, Review Studio should show reviewed pairs and pending pairs. Pending reviewer decisions are acceptable as an explicit state, but they must not be counted as agreement or human review evidence. For production, library, and governed packages, pending reviewer decisions should keep the Output Lab in `warn` until reviewer decisions are recorded or the warning is explicitly accepted in the waiver ledger. Invalid adjudication records should block release because they make the blind review audit untrustworthy.
44
+
45
+ The Operations Loop must never display raw telemetry logs. It should link only to `reports/adoption_drift_report.md`; privacy or schema violations are blockers.
46
+
47
+ The Runtime Permission Probes gate is evaluated after packaging, because it reads generated target adapters. A missing probe can warn in lighter modes, but governed release should not claim target permission readiness without `reports/runtime_permission_probes.json`.
48
+
49
+ The Review Waivers gate must never convert a blocker into a pass. Waivers only cover warning-level risks, require reviewer, reason, scope, and expiry, and must link only to `reports/review_waivers.md`.
50
+
51
+ Review Annotations are not waivers. They are reviewer comments attached to a Review Studio gate plus a relative source/report path and optional line number. Use them to preserve review context, requested edits, and source-line notes. Open blocker annotations should make the Review Studio decision `blocked` until the annotation is resolved or deferred with reviewer rationale. Open warning annotations can move the package into review, but they do not create gate-specific `review_actions`; actions remain reserved for non-pass gates.
52
+
53
+ ## Review Actions
54
+
55
+ Every non-pass gate must produce a `review_actions` entry in `reports/review-studio.json`. When all gates pass, `review_actions` should be an empty list and the page should explicitly say there are no blocker or warning actions.
56
+
57
+ Each action must include:
58
+
59
+ - `gate_key`
60
+ - `status`
61
+ - `summary`
62
+ - `why`
63
+ - `source_fix`
64
+ - `source_refs`
65
+ - `evidence`
66
+ - `verification_command`
67
+
68
+ `source_refs` must be structured entries with relative `path`, human label, kind, existence flag, best-effort line number, matched pattern, short source excerpt, and relative link when the file exists. They should point to the smallest useful report or source file, not just a broad directory. The HTML page should render the excerpt next to the link so reviewers can understand why a line anchor matters before opening the full artifact.
69
+
70
+ The HTML page should render these actions before the detailed supporting sections so a reviewer can move directly from warning to fix. Action entries do not change gate count or score; they make the current decision more operational.
71
+
72
+ For `world-class-evidence`, the action should also expose an evidence-step card for every pending evidence key. Each card should show the submission path, template path, blocked source checks, command handoff, first runbook steps, provenance requirements, success checks, evidence artifacts, and privacy boundary. These cards are collection guidance only; they must not count as accepted evidence or change world-class readiness.
73
+
74
+ ## Review Annotations
75
+
76
+ `reports/review_annotations.json` is the structured ledger, and `reports/review_annotations.md` is the human-readable review note surface. Each annotation should include:
77
+
78
+ - `gate_key`
79
+ - `target_path`
80
+ - `line` when a useful source line exists
81
+ - `severity`
82
+ - `status`
83
+ - `reviewer`
84
+ - `body`
85
+ - optional `suggested_action`
86
+
87
+ The ledger should reject absolute paths or paths that escape the skill directory. Missing target files are allowed as visible evidence gaps, not hidden failures.
@@ -0,0 +1,76 @@
1
+ # Review Waiver Method
2
+
3
+ Review waivers make human risk acceptance explicit. They are not a way to hide problems; they are a local audit record for warning-level risks that the reviewer intentionally accepts for a bounded release window.
4
+
5
+ ## When To Use
6
+
7
+ Use a waiver when:
8
+
9
+ - Review Studio shows a warning that is understood and intentionally accepted.
10
+ - The warning cannot be fixed before release without a worse tradeoff.
11
+ - A reviewer can name the reason, scope, evidence, and expiry date.
12
+
13
+ Do not use a waiver for blocker gates in v0. Blockers must be fixed before production, library, governed, or public readiness is claimed. In governed mode, missing or invalid high-permission approvals are blockers and should be fixed in `security/permission_policy.json`, not waived.
14
+
15
+ ## Required Fields
16
+
17
+ Every waiver must include:
18
+
19
+ - `gate_key`: the Review Studio gate being accepted.
20
+ - `decision`: `accepted-risk`, `false-positive`, or `temporary-exception`.
21
+ - `reviewer`: the accountable human or team.
22
+ - `reason`: a concrete reason of at least 20 characters.
23
+ - `created_at`: ISO date.
24
+ - `expires_at`: ISO date.
25
+ - `evidence`: optional path or note that explains the decision.
26
+ - `scope`: default `current-release`.
27
+
28
+ ## Gate Key Policy
29
+
30
+ The waiver ledger must track the Review Studio gate universe explicitly:
31
+
32
+ - `review_studio_gate_keys`: every gate Review Studio can render.
33
+ - `waiverable_gate_keys`: warning gates that may receive bounded human acceptance.
34
+ - `non_waivable_gate_keys`: gates that must not be accepted through a waiver.
35
+
36
+ When Review Studio adds or renames a gate, update the waiver gate policy and tests in the same change. `review-waivers` and `world-class-evidence` stay non-waivable: the first is the waiver mechanism itself, and the second can only be satisfied by accepted ledger evidence.
37
+
38
+ ## Release Semantics
39
+
40
+ - Invalid waiver records block Review Studio.
41
+ - Expired waiver records stay visible and no longer cover warnings.
42
+ - Active waivers cover only the exact gate key they name.
43
+ - A warning without an active waiver remains visible as a warning.
44
+ - Raw user prompts, outputs, credentials, and private transcripts must not be stored in waiver reasons.
45
+
46
+ ## Commands
47
+
48
+ Render or validate the ledger:
49
+
50
+ ```bash
51
+ python3 scripts/render_review_waivers.py .
52
+ ```
53
+
54
+ Add a bounded approval:
55
+
56
+ ```bash
57
+ python3 scripts/yao.py review-waivers . \
58
+ --add-waiver \
59
+ --gate-key trust-report \
60
+ --reviewer "Yao Team" \
61
+ --reason "Network-capable scripts are documented and bounded for this release." \
62
+ --expires-at 2026-09-30
63
+ ```
64
+
65
+ For a non-governed release where `permission-gates` is only a warning, the same command can name `--gate-key permission-gates`. Governed releases must instead provide reviewer, scope, reason, expiry, evidence, and target-enforcement fields in `security/permission_policy.json`.
66
+
67
+ Review Studio reads `reports/review_waivers.json` and links to `reports/review_waivers.md`.
68
+
69
+ ## Candidate Actions
70
+
71
+ The waiver report also surfaces current candidate actions from local evidence:
72
+
73
+ - waiverable warning candidates, such as an `output-lab` warning caused by pending reviewer decisions or missing provider-backed runs
74
+ - non-waivable boundaries, especially `world-class-evidence`, where pending ledger evidence cannot be converted into completion by a waiver
75
+
76
+ A waiver can make a bounded warning auditable for a release window. It cannot count as provider-backed evidence, human adjudication, native runtime enforcement, external telemetry, or public world-class readiness.
@@ -0,0 +1,21 @@
1
+ # Runtime Conformance Method
2
+
3
+ Runtime conformance turns platform compatibility from a packaging afterthought into a release gate.
4
+
5
+ ## Purpose
6
+
7
+ Use this check when a skill is packaged for OpenAI, Claude, Agent Skills, VS Code / Copilot, or generic targets. The goal is not to prove that every runtime behaves identically. The goal is to prove that the package exposes enough metadata, files, and degradation notes for each runtime to consume it safely.
8
+
9
+ ## V0 Checks
10
+
11
+ - `SKILL.md` exists and has frontmatter `name` and `description`.
12
+ - `description` stays within the 1024 character limit used by common Agent Skills clients.
13
+ - `manifest.json` includes name, version, owner, maturity, status, review cadence, and target platforms.
14
+ - `agents/interface.yaml` includes display text, default prompt, activation mode, execution context, trust metadata, adapter targets, and degradation strategy.
15
+ - Skill IR exists and matches the frontmatter name and description.
16
+ - Resources named by Skill IR are relative paths and resolve inside the package.
17
+ - Unsupported or lossy target behavior is represented by a degradation note.
18
+
19
+ ## Reviewer Gate
20
+
21
+ A reviewer should be able to see a target matrix with pass/fail status, failures, warnings, and artifact paths. Any failed target blocks library, governed, or team-distributed release for that target.
@@ -0,0 +1,86 @@
1
+ # Skill Archetypes
2
+
3
+ Use these archetypes to decide what kind of skill you are building before you decide how many files or gates to add.
4
+
5
+ ## Scaffold
6
+
7
+ Purpose:
8
+
9
+ - quick packaging for a real but still exploratory workflow
10
+
11
+ Default assets:
12
+
13
+ - `SKILL.md`
14
+ - `agents/interface.yaml`
15
+
16
+ Use when:
17
+
18
+ - reuse is plausible but not proven
19
+ - failure cost is low
20
+ - the workflow is still changing
21
+
22
+ ## Production
23
+
24
+ Purpose:
25
+
26
+ - compact skill for team reuse
27
+
28
+ Default assets:
29
+
30
+ - lean `SKILL.md`
31
+ - `agents/interface.yaml`
32
+ - selective `references/`
33
+ - selective `evals/`
34
+
35
+ Use when:
36
+
37
+ - route mistakes waste team time
38
+ - a checklist or focused script improves reliability
39
+
40
+ ## Library
41
+
42
+ Purpose:
43
+
44
+ - shared capability with visible evidence and portability expectations
45
+
46
+ Default assets:
47
+
48
+ - route evals
49
+ - packaging checks
50
+ - manifest metadata
51
+ - public reports
52
+
53
+ Use when:
54
+
55
+ - the skill will be reused across teams or clients
56
+ - the skill is likely to have near-neighbor route collisions
57
+
58
+ ## Governed
59
+
60
+ Purpose:
61
+
62
+ - high-trust skill with explicit ownership and review
63
+
64
+ Default assets:
65
+
66
+ - lifecycle metadata
67
+ - governance score
68
+ - review cadence
69
+ - regression history
70
+ - governed examples or policy references
71
+
72
+ Use when:
73
+
74
+ - the skill is operationally sensitive
75
+ - the skill influences incident, release, compliance, or organizational standards
76
+
77
+ ## Anti-Archetypes
78
+
79
+ Do not force a request into a skill archetype when it is really:
80
+
81
+ - a one-off answer
82
+ - a document
83
+ - a brainstorm
84
+ - an implementation task with no reusable process
85
+
86
+ See [Non-Skill Decision Tree](non-skill-decision-tree.md).
@@ -0,0 +1,35 @@
1
+ # Skill Atlas Method
2
+
3
+ Skill Atlas is the 2.0 operating layer for a workspace that contains many skills.
4
+
5
+ ## Purpose
6
+
7
+ Single-skill quality is not enough for a team library. A skill portfolio also needs to reveal route collisions, stale ownership, duplicate resources, and repeated no-route opportunities.
8
+
9
+ ## V0 Checks
10
+
11
+ - Catalog every `SKILL.md` under a workspace.
12
+ - Extract name, description, owner, maturity, targets, updated date, and review cadence.
13
+ - Detect similar descriptions as route-overlap candidates.
14
+ - Detect duplicate skill names.
15
+ - Detect shared script/reference filenames as dependency signals.
16
+ - Flag missing owner or review metadata.
17
+ - Flag stale skills based on `updated_at` and `review_cadence`.
18
+ - Extract no-route opportunities from failure notes.
19
+ - Read aggregate adoption drift reports and flag telemetry drift without reading raw telemetry logs.
20
+
21
+ ## Scope Policy
22
+
23
+ Atlas keeps a full catalog, but release gates should distinguish actionable library skills from examples and test fixtures.
24
+
25
+ Use `skill_atlas/policy.json` to mark path prefixes as non-actionable when they are intentionally retained as examples, evolution snapshots, embedded generated skills, or validator fixtures. Non-actionable items still appear in the full report, route matrix, stale list, and owner gap list, but Review Studio should use the actionable counts for release readiness.
26
+
27
+ ## Telemetry Link
28
+
29
+ Atlas may read each skill's aggregate `reports/adoption_drift_report.json` to surface portfolio drift signals such as no telemetry for production/library/governed skills, missed triggers, bad outputs, missing resources, script errors, and review-overdue counts. It must not read or package `reports/telemetry_events.jsonl`; raw telemetry remains local-only evidence owned by the skill.
30
+
31
+ Write drift output to `skill_atlas/drift_signals.json`. Non-actionable scopes stay visible in that file and in the HTML report, but only actionable drift signals should affect release readiness.
32
+
33
+ ## Reviewer Gate
34
+
35
+ Use Atlas before promoting a single skill into a shared library. If an actionable route collision, missing owner, stale governed skill, or telemetry drift signal appears, fix the portfolio boundary before adding more local complexity to one skill. Non-actionable issues should stay visible as evidence, not as release blockers.