skillfullstack 0.0.0-stage → 1.0.0

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 (775) hide show
  1. package/.skillsRegistry/catalog.json +231 -0
  2. package/AGENTS.md +89 -0
  3. package/README.md +210 -2
  4. package/bin/index.js +508 -0
  5. package/package.json +57 -4
  6. package/skills/backend/apiEngineering/SKILL.md +102 -0
  7. package/skills/backend/apiEngineering/evals/evalApiEngineering.py +81 -0
  8. package/skills/backend/apiEngineering/evals/fixtures/invalid/sampleInvalidOpenApi.json +40 -0
  9. package/skills/backend/apiEngineering/evals/fixtures/valid/sampleValidOpenApi.json +47 -0
  10. package/skills/backend/apiEngineering/policies/compatibility.md +42 -0
  11. package/skills/backend/apiEngineering/policies/mandatory.md +48 -0
  12. package/skills/backend/apiEngineering/policies/performance.md +39 -0
  13. package/skills/backend/apiEngineering/policies/security.md +36 -0
  14. package/skills/backend/apiEngineering/references/apiObservability.md +39 -0
  15. package/skills/backend/apiEngineering/references/apiReference.md +3 -0
  16. package/skills/backend/apiEngineering/references/apiSecurityOwasp.md +47 -0
  17. package/skills/backend/apiEngineering/references/contractCompatibility.md +26 -0
  18. package/skills/backend/apiEngineering/references/databaseTransactions.md +40 -0
  19. package/skills/backend/apiEngineering/references/distributedReliability.md +26 -0
  20. package/skills/backend/apiEngineering/references/multiTenancy.md +27 -0
  21. package/skills/backend/apiEngineering/references/openApi32Standards.md +58 -0
  22. package/skills/backend/apiEngineering/references/paginationVersioning.md +57 -0
  23. package/skills/backend/apiEngineering/references/responseStandards.md +94 -0
  24. package/skills/backend/apiEngineering/scripts/auditApiContract.py +123 -0
  25. package/skills/backend/apiEngineering/scripts/checkBreakingChanges.py +77 -0
  26. package/skills/backend/apiEngineering/scripts/generateResponseEnvelope.py +88 -0
  27. package/skills/backend/apiEngineering/templates/apiChecklist.md +27 -0
  28. package/skills/backend/apiEngineering/templates/openapi.yaml +125 -0
  29. package/skills/backend/apiEngineering/templates/problemDetails.json +44 -0
  30. package/skills/backend/databaseArchitecture/SKILL.md +118 -0
  31. package/skills/backend/databaseArchitecture/evals/evalDatabaseArchitecture.py +85 -0
  32. package/skills/backend/databaseArchitecture/evals/fixtures/dangerousMigration.sql +4 -0
  33. package/skills/backend/databaseArchitecture/evals/fixtures/invalidSchema.sql +23 -0
  34. package/skills/backend/databaseArchitecture/evals/fixtures/safeMigration.sql +3 -0
  35. package/skills/backend/databaseArchitecture/evals/fixtures/validSchema.sql +37 -0
  36. package/skills/backend/databaseArchitecture/policies/integrity.md +25 -0
  37. package/skills/backend/databaseArchitecture/policies/mandatory.md +32 -0
  38. package/skills/backend/databaseArchitecture/policies/migration.md +22 -0
  39. package/skills/backend/databaseArchitecture/policies/normalization.md +25 -0
  40. package/skills/backend/databaseArchitecture/policies/performance.md +26 -0
  41. package/skills/backend/databaseArchitecture/policies/recovery.md +23 -0
  42. package/skills/backend/databaseArchitecture/policies/security.md +26 -0
  43. package/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md +70 -0
  44. package/skills/backend/databaseArchitecture/references/analyticsWarehousing.md +32 -0
  45. package/skills/backend/databaseArchitecture/references/apiReference.md +3 -0
  46. package/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md +27 -0
  47. package/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md +30 -0
  48. package/skills/backend/databaseArchitecture/references/databaseTaxonomy.md +32 -0
  49. package/skills/backend/databaseArchitecture/references/indexingOptimization.md +32 -0
  50. package/skills/backend/databaseArchitecture/references/normalizationTheory.md +61 -0
  51. package/skills/backend/databaseArchitecture/references/scalabilitySharding.md +37 -0
  52. package/skills/backend/databaseArchitecture/references/transactionConcurrency.md +39 -0
  53. package/skills/backend/databaseArchitecture/scripts/analyzeMigration.py +99 -0
  54. package/skills/backend/databaseArchitecture/scripts/auditDatabaseSchema.py +177 -0
  55. package/skills/backend/databaseArchitecture/scripts/inspectDatabaseIndexes.py +149 -0
  56. package/skills/backend/databaseArchitecture/templates/adrTemplate.md +32 -0
  57. package/skills/backend/databaseArchitecture/templates/databaseChecklist.md +29 -0
  58. package/skills/backend/databaseArchitecture/templates/migrationPlan.md +40 -0
  59. package/skills/backend/durableBackgroundJobs/SKILL.md +112 -0
  60. package/skills/backend/durableBackgroundJobs/evals/durableJobVerification.json +14 -0
  61. package/skills/backend/durableBackgroundJobs/references/apiReference.md +3 -0
  62. package/skills/backend/durableBackgroundJobs/references/durableStepPatterns.md +6 -0
  63. package/skills/backend/durableBackgroundJobs/references/idempotencyKeys.md +5 -0
  64. package/skills/backend/durableBackgroundJobs/scripts/testWorkflowDispatch.py +24 -0
  65. package/skills/backend/golangStandard/SKILL.md +155 -0
  66. package/skills/backend/golangStandard/evals/goVerification.json +14 -0
  67. package/skills/backend/golangStandard/references/apiReference.md +3 -0
  68. package/skills/backend/golangStandard/references/layoutGuide.md +26 -0
  69. package/skills/backend/golangStandard/references/slogPatterns.md +26 -0
  70. package/skills/backend/golangStandard/scripts/scaffoldGoModule.py +105 -0
  71. package/skills/backend/pythonStandard/SKILL.md +138 -0
  72. package/skills/backend/pythonStandard/evals/pythonVerification.json +14 -0
  73. package/skills/backend/pythonStandard/references/apiReference.md +3 -0
  74. package/skills/backend/pythonStandard/references/pydanticPatterns.md +16 -0
  75. package/skills/backend/pythonStandard/references/pyprojectSpecs.md +37 -0
  76. package/skills/backend/pythonStandard/scripts/scaffoldUvProject.py +79 -0
  77. package/skills/backend/upstash/SKILL.md +98 -0
  78. package/skills/backend/upstash/evals/upstashVerification.json +14 -0
  79. package/skills/backend/upstash/references/apiReference.md +3 -0
  80. package/skills/backend/upstash/references/qstashFlowControl.md +34 -0
  81. package/skills/backend/upstash/references/ratelimitPatterns.md +53 -0
  82. package/skills/backend/upstash/references/workflowPatterns.md +35 -0
  83. package/skills/backend/upstash/scripts/testRedisConnection.py +36 -0
  84. package/skills/cicdDevops/cicdPipeline/SKILL.md +148 -0
  85. package/skills/cicdDevops/cicdPipeline/evals/evalCicd.py +37 -0
  86. package/skills/cicdDevops/cicdPipeline/references/apiReference.md +3 -0
  87. package/skills/cicdDevops/cicdPipeline/references/cicdDeploymentPatterns.md +27 -0
  88. package/skills/cicdDevops/cicdPipeline/scripts/auditDockerfileSecurity.py +56 -0
  89. package/skills/dataAi/mcpServerDevelopment/SKILL.md +123 -0
  90. package/skills/dataAi/mcpServerDevelopment/evals/mcpVerification.json +14 -0
  91. package/skills/dataAi/mcpServerDevelopment/references/apiReference.md +3 -0
  92. package/skills/dataAi/mcpServerDevelopment/references/mcpClientConfigs.md +38 -0
  93. package/skills/dataAi/mcpServerDevelopment/references/toolSchemaDesign.md +6 -0
  94. package/skills/dataAi/mcpServerDevelopment/scripts/runFastMcpBoilerplate.py +36 -0
  95. package/skills/dataAi/ragPipelineProduction/SKILL.md +113 -0
  96. package/skills/dataAi/ragPipelineProduction/evals/ragVerification.json +14 -0
  97. package/skills/dataAi/ragPipelineProduction/references/apiReference.md +3 -0
  98. package/skills/dataAi/ragPipelineProduction/references/chunkingStrategies.md +10 -0
  99. package/skills/dataAi/ragPipelineProduction/references/rrfAlgorithm.md +13 -0
  100. package/skills/dataAi/ragPipelineProduction/scripts/runHybridRrfSearch.py +33 -0
  101. package/skills/devopsCloud/cloudflare/SKILL.md +282 -0
  102. package/skills/devopsCloud/cloudflare/assets/README.md +48 -0
  103. package/skills/devopsCloud/cloudflare/assets/ai/agents-sdk.md +118 -0
  104. package/skills/devopsCloud/cloudflare/assets/ai/ai-gateway.md +105 -0
  105. package/skills/devopsCloud/cloudflare/assets/ai/ai-search.md +129 -0
  106. package/skills/devopsCloud/cloudflare/assets/ai/workers-ai.md +127 -0
  107. package/skills/devopsCloud/cloudflare/assets/cli/c3.md +292 -0
  108. package/skills/devopsCloud/cloudflare/assets/cli/cf-cli.md +90 -0
  109. package/skills/devopsCloud/cloudflare/assets/cli/wrangler.md +43 -0
  110. package/skills/devopsCloud/cloudflare/assets/compute/cron-triggers.md +486 -0
  111. package/skills/devopsCloud/cloudflare/assets/compute/service-bindings.md +251 -0
  112. package/skills/devopsCloud/cloudflare/assets/compute/smart-placement.md +435 -0
  113. package/skills/devopsCloud/cloudflare/assets/compute/static-assets.md +220 -0
  114. package/skills/devopsCloud/cloudflare/assets/compute/workers.md +129 -0
  115. package/skills/devopsCloud/cloudflare/assets/database-storage/d1.md +105 -0
  116. package/skills/devopsCloud/cloudflare/assets/database-storage/durable-objects.md +122 -0
  117. package/skills/devopsCloud/cloudflare/assets/database-storage/hyperdrive.md +210 -0
  118. package/skills/devopsCloud/cloudflare/assets/database-storage/kv.md +198 -0
  119. package/skills/devopsCloud/cloudflare/assets/database-storage/queues.md +105 -0
  120. package/skills/devopsCloud/cloudflare/assets/database-storage/r2.md +105 -0
  121. package/skills/devopsCloud/cloudflare/assets/database-storage/vectorize.md +97 -0
  122. package/skills/devopsCloud/cloudflare/assets/database-storage/workflows.md +141 -0
  123. package/skills/devopsCloud/cloudflare/assets/llms.txt +143 -0
  124. package/skills/devopsCloud/cloudflare/assets/networking-security/cache-cdn.md +109 -0
  125. package/skills/devopsCloud/cloudflare/assets/networking-security/dns.md +71 -0
  126. package/skills/devopsCloud/cloudflare/assets/networking-security/rate-limiting.md +130 -0
  127. package/skills/devopsCloud/cloudflare/assets/networking-security/tunnels.md +57 -0
  128. package/skills/devopsCloud/cloudflare/assets/networking-security/waf.md +143 -0
  129. package/skills/devopsCloud/cloudflare/assets/troubleshooting/1xxx-errors.md +209 -0
  130. package/skills/devopsCloud/cloudflare/assets/troubleshooting/5xx-errors.md +111 -0
  131. package/skills/devopsCloud/cloudflare/assets/troubleshooting/http-status-codes.md +38 -0
  132. package/skills/devopsCloud/cloudflare/evals/evals.json +75 -0
  133. package/skills/devopsCloud/cloudflare/references/ai-gateway/README.md +27 -0
  134. package/skills/devopsCloud/cloudflare/references/ai-gateway/configuration.md +18 -0
  135. package/skills/devopsCloud/cloudflare/references/ai-gateway/dynamic-routing.md +15 -0
  136. package/skills/devopsCloud/cloudflare/references/ai-gateway/features.md +22 -0
  137. package/skills/devopsCloud/cloudflare/references/ai-gateway/sdk-integration.md +19 -0
  138. package/skills/devopsCloud/cloudflare/references/ai-gateway/troubleshooting.md +16 -0
  139. package/skills/devopsCloud/cloudflare/references/ai-search/README.md +25 -0
  140. package/skills/devopsCloud/cloudflare/references/ai-search/api.md +13 -0
  141. package/skills/devopsCloud/cloudflare/references/ai-search/configuration.md +16 -0
  142. package/skills/devopsCloud/cloudflare/references/ai-search/gotchas.md +13 -0
  143. package/skills/devopsCloud/cloudflare/references/ai-search/patterns.md +15 -0
  144. package/skills/devopsCloud/cloudflare/references/bindings/README.md +16 -0
  145. package/skills/devopsCloud/cloudflare/references/bindings/api.md +19 -0
  146. package/skills/devopsCloud/cloudflare/references/bindings/configuration.md +20 -0
  147. package/skills/devopsCloud/cloudflare/references/bindings/gotchas.md +18 -0
  148. package/skills/devopsCloud/cloudflare/references/bindings/patterns.md +20 -0
  149. package/skills/devopsCloud/cloudflare/references/browser-rendering/README.md +18 -0
  150. package/skills/devopsCloud/cloudflare/references/browser-rendering/api.md +12 -0
  151. package/skills/devopsCloud/cloudflare/references/browser-rendering/configuration.md +12 -0
  152. package/skills/devopsCloud/cloudflare/references/browser-rendering/gotchas.md +15 -0
  153. package/skills/devopsCloud/cloudflare/references/browser-rendering/patterns.md +12 -0
  154. package/skills/devopsCloud/cloudflare/references/cliComparison.md +93 -0
  155. package/skills/devopsCloud/cloudflare/references/containers/README.md +23 -0
  156. package/skills/devopsCloud/cloudflare/references/containers/api.md +13 -0
  157. package/skills/devopsCloud/cloudflare/references/containers/configuration.md +15 -0
  158. package/skills/devopsCloud/cloudflare/references/containers/gotchas.md +16 -0
  159. package/skills/devopsCloud/cloudflare/references/containers/patterns.md +18 -0
  160. package/skills/devopsCloud/cloudflare/references/cron-triggers/README.md +20 -0
  161. package/skills/devopsCloud/cloudflare/references/cron-triggers/api.md +16 -0
  162. package/skills/devopsCloud/cloudflare/references/cron-triggers/configuration.md +16 -0
  163. package/skills/devopsCloud/cloudflare/references/cron-triggers/gotchas.md +17 -0
  164. package/skills/devopsCloud/cloudflare/references/cron-triggers/patterns.md +18 -0
  165. package/skills/devopsCloud/cloudflare/references/d1/README.md +15 -0
  166. package/skills/devopsCloud/cloudflare/references/d1/api.md +18 -0
  167. package/skills/devopsCloud/cloudflare/references/d1/configuration.md +18 -0
  168. package/skills/devopsCloud/cloudflare/references/d1/gotchas.md +18 -0
  169. package/skills/devopsCloud/cloudflare/references/d1/patterns.md +21 -0
  170. package/skills/devopsCloud/cloudflare/references/frameworkCompatibility.md +110 -0
  171. package/skills/devopsCloud/cloudflare/references/hyperdrive/README.md +28 -0
  172. package/skills/devopsCloud/cloudflare/references/hyperdrive/api.md +26 -0
  173. package/skills/devopsCloud/cloudflare/references/hyperdrive/configuration.md +34 -0
  174. package/skills/devopsCloud/cloudflare/references/hyperdrive/gotchas.md +20 -0
  175. package/skills/devopsCloud/cloudflare/references/hyperdrive/patterns.md +15 -0
  176. package/skills/devopsCloud/cloudflare/references/images/README.md +12 -0
  177. package/skills/devopsCloud/cloudflare/references/images/api.md +13 -0
  178. package/skills/devopsCloud/cloudflare/references/images/configuration.md +17 -0
  179. package/skills/devopsCloud/cloudflare/references/images/gotchas.md +16 -0
  180. package/skills/devopsCloud/cloudflare/references/images/patterns.md +16 -0
  181. package/skills/devopsCloud/cloudflare/references/kv/README.md +15 -0
  182. package/skills/devopsCloud/cloudflare/references/kv/api.md +18 -0
  183. package/skills/devopsCloud/cloudflare/references/kv/configuration.md +16 -0
  184. package/skills/devopsCloud/cloudflare/references/kv/gotchas.md +17 -0
  185. package/skills/devopsCloud/cloudflare/references/kv/patterns.md +21 -0
  186. package/skills/devopsCloud/cloudflare/references/miniflare/README.md +22 -0
  187. package/skills/devopsCloud/cloudflare/references/miniflare/api.md +16 -0
  188. package/skills/devopsCloud/cloudflare/references/miniflare/configuration.md +16 -0
  189. package/skills/devopsCloud/cloudflare/references/miniflare/gotchas.md +15 -0
  190. package/skills/devopsCloud/cloudflare/references/miniflare/patterns.md +19 -0
  191. package/skills/devopsCloud/cloudflare/references/observability/README.md +27 -0
  192. package/skills/devopsCloud/cloudflare/references/observability/api.md +20 -0
  193. package/skills/devopsCloud/cloudflare/references/observability/configuration.md +23 -0
  194. package/skills/devopsCloud/cloudflare/references/observability/gotchas.md +25 -0
  195. package/skills/devopsCloud/cloudflare/references/observability/patterns.md +14 -0
  196. package/skills/devopsCloud/cloudflare/references/pages/README.md +20 -0
  197. package/skills/devopsCloud/cloudflare/references/pages/api.md +13 -0
  198. package/skills/devopsCloud/cloudflare/references/pages/configuration.md +16 -0
  199. package/skills/devopsCloud/cloudflare/references/pages/gotchas.md +19 -0
  200. package/skills/devopsCloud/cloudflare/references/pages/patterns.md +15 -0
  201. package/skills/devopsCloud/cloudflare/references/pages-functions/README.md +20 -0
  202. package/skills/devopsCloud/cloudflare/references/pages-functions/api.md +13 -0
  203. package/skills/devopsCloud/cloudflare/references/pages-functions/configuration.md +14 -0
  204. package/skills/devopsCloud/cloudflare/references/pages-functions/gotchas.md +17 -0
  205. package/skills/devopsCloud/cloudflare/references/pages-functions/patterns.md +16 -0
  206. package/skills/devopsCloud/cloudflare/references/productSelectionMatrix.md +54 -0
  207. package/skills/devopsCloud/cloudflare/references/queues/README.md +24 -0
  208. package/skills/devopsCloud/cloudflare/references/queues/api.md +16 -0
  209. package/skills/devopsCloud/cloudflare/references/queues/configuration.md +20 -0
  210. package/skills/devopsCloud/cloudflare/references/queues/gotchas.md +18 -0
  211. package/skills/devopsCloud/cloudflare/references/queues/patterns.md +21 -0
  212. package/skills/devopsCloud/cloudflare/references/r2/README.md +26 -0
  213. package/skills/devopsCloud/cloudflare/references/r2/api.md +16 -0
  214. package/skills/devopsCloud/cloudflare/references/r2/configuration.md +19 -0
  215. package/skills/devopsCloud/cloudflare/references/r2/gotchas.md +17 -0
  216. package/skills/devopsCloud/cloudflare/references/r2/patterns.md +18 -0
  217. package/skills/devopsCloud/cloudflare/references/secrets-store/README.md +22 -0
  218. package/skills/devopsCloud/cloudflare/references/secrets-store/api.md +21 -0
  219. package/skills/devopsCloud/cloudflare/references/secrets-store/configuration.md +25 -0
  220. package/skills/devopsCloud/cloudflare/references/secrets-store/gotchas.md +19 -0
  221. package/skills/devopsCloud/cloudflare/references/secrets-store/patterns.md +27 -0
  222. package/skills/devopsCloud/cloudflare/references/skill-feedback.md +41 -0
  223. package/skills/devopsCloud/cloudflare/references/static-assets/README.md +21 -0
  224. package/skills/devopsCloud/cloudflare/references/static-assets/api.md +16 -0
  225. package/skills/devopsCloud/cloudflare/references/static-assets/configuration.md +16 -0
  226. package/skills/devopsCloud/cloudflare/references/static-assets/gotchas.md +18 -0
  227. package/skills/devopsCloud/cloudflare/references/static-assets/patterns.md +17 -0
  228. package/skills/devopsCloud/cloudflare/references/stream/README.md +22 -0
  229. package/skills/devopsCloud/cloudflare/references/stream/api-live.md +18 -0
  230. package/skills/devopsCloud/cloudflare/references/stream/api.md +21 -0
  231. package/skills/devopsCloud/cloudflare/references/stream/configuration.md +18 -0
  232. package/skills/devopsCloud/cloudflare/references/stream/gotchas.md +18 -0
  233. package/skills/devopsCloud/cloudflare/references/stream/patterns.md +22 -0
  234. package/skills/devopsCloud/cloudflare/references/tail-workers/README.md +21 -0
  235. package/skills/devopsCloud/cloudflare/references/tail-workers/api.md +13 -0
  236. package/skills/devopsCloud/cloudflare/references/tail-workers/configuration.md +15 -0
  237. package/skills/devopsCloud/cloudflare/references/tail-workers/gotchas.md +16 -0
  238. package/skills/devopsCloud/cloudflare/references/tail-workers/patterns.md +15 -0
  239. package/skills/devopsCloud/cloudflare/references/tunnel/README.md +20 -0
  240. package/skills/devopsCloud/cloudflare/references/tunnel/api.md +14 -0
  241. package/skills/devopsCloud/cloudflare/references/tunnel/configuration.md +14 -0
  242. package/skills/devopsCloud/cloudflare/references/tunnel/gotchas.md +15 -0
  243. package/skills/devopsCloud/cloudflare/references/tunnel/networking.md +14 -0
  244. package/skills/devopsCloud/cloudflare/references/tunnel/patterns.md +15 -0
  245. package/skills/devopsCloud/cloudflare/references/vectorize/README.md +22 -0
  246. package/skills/devopsCloud/cloudflare/references/vectorize/api.md +18 -0
  247. package/skills/devopsCloud/cloudflare/references/vectorize/configuration.md +19 -0
  248. package/skills/devopsCloud/cloudflare/references/vectorize/gotchas.md +15 -0
  249. package/skills/devopsCloud/cloudflare/references/vectorize/patterns.md +24 -0
  250. package/skills/devopsCloud/cloudflare/references/waf/README.md +21 -0
  251. package/skills/devopsCloud/cloudflare/references/waf/api.md +17 -0
  252. package/skills/devopsCloud/cloudflare/references/waf/configuration.md +18 -0
  253. package/skills/devopsCloud/cloudflare/references/waf/gotchas.md +19 -0
  254. package/skills/devopsCloud/cloudflare/references/waf/patterns.md +17 -0
  255. package/skills/devopsCloud/cloudflare/references/workers-ai/README.md +24 -0
  256. package/skills/devopsCloud/cloudflare/references/workers-ai/api.md +13 -0
  257. package/skills/devopsCloud/cloudflare/references/workers-ai/configuration.md +16 -0
  258. package/skills/devopsCloud/cloudflare/references/workers-ai/gotchas.md +15 -0
  259. package/skills/devopsCloud/cloudflare/references/workers-ai/patterns.md +14 -0
  260. package/skills/devopsCloud/cloudflare/references/workflows/README.md +23 -0
  261. package/skills/devopsCloud/cloudflare/references/workflows/api.md +17 -0
  262. package/skills/devopsCloud/cloudflare/references/workflows/configuration.md +18 -0
  263. package/skills/devopsCloud/cloudflare/references/workflows/gotchas.md +19 -0
  264. package/skills/devopsCloud/cloudflare/references/workflows/patterns.md +30 -0
  265. package/skills/devopsCloud/cloudflare/scripts/auditCloudflareProduction.py +95 -0
  266. package/skills/foundation/promptEvalTesting/SKILL.md +114 -0
  267. package/skills/foundation/promptEvalTesting/evals/promptEvalVerification.json +14 -0
  268. package/skills/foundation/promptEvalTesting/references/apiReference.md +3 -0
  269. package/skills/foundation/promptEvalTesting/references/evalMetricsCatalog.md +7 -0
  270. package/skills/foundation/promptEvalTesting/references/promptfooConfigSpecs.md +16 -0
  271. package/skills/foundation/promptEvalTesting/scripts/runPromptEvalSuite.py +29 -0
  272. package/skills/frontend/astro/SKILL.md +327 -0
  273. package/skills/frontend/astro/assets/README.md +71 -0
  274. package/skills/frontend/astro/assets/add-content-to-your-site/content-collections.md +1061 -0
  275. package/skills/frontend/astro/assets/add-content-to-your-site/data-fetching.md +109 -0
  276. package/skills/frontend/astro/assets/add-content-to-your-site/images.md +719 -0
  277. package/skills/frontend/astro/assets/add-content-to-your-site/markdown.md +725 -0
  278. package/skills/frontend/astro/assets/build-your-ui/components.md +402 -0
  279. package/skills/frontend/astro/assets/build-your-ui/fonts.md +437 -0
  280. package/skills/frontend/astro/assets/build-your-ui/front-end-frameworks.md +245 -0
  281. package/skills/frontend/astro/assets/build-your-ui/layouts.md +267 -0
  282. package/skills/frontend/astro/assets/build-your-ui/scripts-and-event-handling.md +229 -0
  283. package/skills/frontend/astro/assets/build-your-ui/styles-and-css.md +782 -0
  284. package/skills/frontend/astro/assets/build-your-ui/syntax-highlighting.md +269 -0
  285. package/skills/frontend/astro/assets/configuration/build-with-ai.md +389 -0
  286. package/skills/frontend/astro/assets/configuration/configuration-overview.md +122 -0
  287. package/skills/frontend/astro/assets/configuration/dev-toolbar.md +86 -0
  288. package/skills/frontend/astro/assets/configuration/editor-setup.md +166 -0
  289. package/skills/frontend/astro/assets/configuration/environment-variables.md +352 -0
  290. package/skills/frontend/astro/assets/configuration/typescript.md +379 -0
  291. package/skills/frontend/astro/assets/configuration/working-with-integrations.md +606 -0
  292. package/skills/frontend/astro/assets/reference/adapter-reference.md +1242 -0
  293. package/skills/frontend/astro/assets/reference/cli-reference.md +575 -0
  294. package/skills/frontend/astro/assets/reference/configuration-reference.md +3144 -0
  295. package/skills/frontend/astro/assets/reference/content-loader-reference.md +1682 -0
  296. package/skills/frontend/astro/assets/reference/directives-reference.md +324 -0
  297. package/skills/frontend/astro/assets/reference/image-service-reference.md +346 -0
  298. package/skills/frontend/astro/assets/reference/integrations-reference.md +2813 -0
  299. package/skills/frontend/astro/assets/reference/modules/astro-actions.md +604 -0
  300. package/skills/frontend/astro/assets/reference/modules/astro-app.md +460 -0
  301. package/skills/frontend/astro/assets/reference/modules/astro-assets.md +1657 -0
  302. package/skills/frontend/astro/assets/reference/modules/astro-config.md +395 -0
  303. package/skills/frontend/astro/assets/reference/modules/astro-content.md +720 -0
  304. package/skills/frontend/astro/assets/reference/modules/astro-env.md +46 -0
  305. package/skills/frontend/astro/assets/reference/modules/astro-fetch.md +346 -0
  306. package/skills/frontend/astro/assets/reference/modules/astro-hono.md +37 -0
  307. package/skills/frontend/astro/assets/reference/modules/astro-i18n.md +462 -0
  308. package/skills/frontend/astro/assets/reference/modules/astro-middleware.md +292 -0
  309. package/skills/frontend/astro/assets/reference/modules/astro-static-paths.md +74 -0
  310. package/skills/frontend/astro/assets/reference/modules/astro-transitions.md +595 -0
  311. package/skills/frontend/astro/assets/reference/modules/astro-zod.md +120 -0
  312. package/skills/frontend/astro/assets/reference/session-driver-reference.md +205 -0
  313. package/skills/frontend/astro/assets/routing-and-navigation/endpoints.md +251 -0
  314. package/skills/frontend/astro/assets/routing-and-navigation/internationalization.md +374 -0
  315. package/skills/frontend/astro/assets/routing-and-navigation/middleware.md +288 -0
  316. package/skills/frontend/astro/assets/routing-and-navigation/pages.md +205 -0
  317. package/skills/frontend/astro/assets/routing-and-navigation/prefetch.md +273 -0
  318. package/skills/frontend/astro/assets/routing-and-navigation/routing.md +760 -0
  319. package/skills/frontend/astro/assets/routing-and-navigation/view-transitions.md +792 -0
  320. package/skills/frontend/astro/assets/server-rendering/actions.md +770 -0
  321. package/skills/frontend/astro/assets/server-rendering/caching.md +255 -0
  322. package/skills/frontend/astro/assets/server-rendering/on-demand-rendering.md +289 -0
  323. package/skills/frontend/astro/assets/server-rendering/server-islands.md +126 -0
  324. package/skills/frontend/astro/assets/server-rendering/sessions.md +270 -0
  325. package/skills/frontend/astro/assets/start-a-new-project/develop-and-build.md +147 -0
  326. package/skills/frontend/astro/assets/start-a-new-project/installation.md +342 -0
  327. package/skills/frontend/astro/assets/start-a-new-project/project-structure.md +137 -0
  328. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/testing.md +412 -0
  329. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/troubleshooting.md +229 -0
  330. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/upgrade-astro.md +205 -0
  331. package/skills/frontend/astro/assets/welcome/courses.md +46 -0
  332. package/skills/frontend/astro/assets/welcome/islands-architecture.md +135 -0
  333. package/skills/frontend/astro/assets/welcome/why-astro.md +90 -0
  334. package/skills/frontend/astro/evals/evals.json +66 -0
  335. package/skills/frontend/astro/references/contentCollections.md +164 -0
  336. package/skills/frontend/astro/references/islandsArchitecture.md +128 -0
  337. package/skills/frontend/astro/references/serverIslandsAndActions.md +187 -0
  338. package/skills/frontend/astro/scripts/auditAstroProduction.py +78 -0
  339. package/skills/frontend/generativeUi/SKILL.md +128 -0
  340. package/skills/frontend/generativeUi/evals/generativeUiVerification.json +14 -0
  341. package/skills/frontend/generativeUi/references/apiReference.md +3 -0
  342. package/skills/frontend/generativeUi/references/clientToolComponentMapping.md +8 -0
  343. package/skills/frontend/generativeUi/references/dataStreamProtocol.md +10 -0
  344. package/skills/frontend/generativeUi/scripts/generateUiComponentStub.py +46 -0
  345. package/skills/frontend/nextjs/SKILL.md +138 -0
  346. package/skills/frontend/nextjs/assets/README.md +67 -0
  347. package/skills/frontend/nextjs/assets/api-reference/cli/create-next-app.md +210 -0
  348. package/skills/frontend/nextjs/assets/api-reference/cli/next.md +484 -0
  349. package/skills/frontend/nextjs/assets/api-reference/components/font.md +952 -0
  350. package/skills/frontend/nextjs/assets/api-reference/components/form.md +387 -0
  351. package/skills/frontend/nextjs/assets/api-reference/components/image.md +1372 -0
  352. package/skills/frontend/nextjs/assets/api-reference/components/link.md +954 -0
  353. package/skills/frontend/nextjs/assets/api-reference/components/script.md +421 -0
  354. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-private.md +211 -0
  355. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-remote.md +652 -0
  356. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache.md +848 -0
  357. package/skills/frontend/nextjs/assets/api-reference/directives/use-client.md +149 -0
  358. package/skills/frontend/nextjs/assets/api-reference/directives/use-server.md +234 -0
  359. package/skills/frontend/nextjs/assets/api-reference/edge-runtime.md +188 -0
  360. package/skills/frontend/nextjs/assets/api-reference/file-conventions/default.md +80 -0
  361. package/skills/frontend/nextjs/assets/api-reference/file-conventions/dynamic-routes.md +417 -0
  362. package/skills/frontend/nextjs/assets/api-reference/file-conventions/error.md +361 -0
  363. package/skills/frontend/nextjs/assets/api-reference/file-conventions/forbidden.md +75 -0
  364. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation-client.md +308 -0
  365. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation.md +177 -0
  366. package/skills/frontend/nextjs/assets/api-reference/file-conventions/intercepting-routes.md +78 -0
  367. package/skills/frontend/nextjs/assets/api-reference/file-conventions/layout.md +803 -0
  368. package/skills/frontend/nextjs/assets/api-reference/file-conventions/loading.md +209 -0
  369. package/skills/frontend/nextjs/assets/api-reference/file-conventions/mdx-components.md +84 -0
  370. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/app-icons.md +302 -0
  371. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/manifest.md +90 -0
  372. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/opengraph-image.md +580 -0
  373. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/robots.md +234 -0
  374. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/sitemap.md +459 -0
  375. package/skills/frontend/nextjs/assets/api-reference/file-conventions/not-found.md +278 -0
  376. package/skills/frontend/nextjs/assets/api-reference/file-conventions/page.md +283 -0
  377. package/skills/frontend/nextjs/assets/api-reference/file-conventions/parallel-routes.md +517 -0
  378. package/skills/frontend/nextjs/assets/api-reference/file-conventions/proxy.md +857 -0
  379. package/skills/frontend/nextjs/assets/api-reference/file-conventions/public-folder.md +47 -0
  380. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-groups.md +40 -0
  381. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/dynamicParams.md +40 -0
  382. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/ensureStatic.md +195 -0
  383. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/instant.md +204 -0
  384. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/maxDuration.md +42 -0
  385. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/preferredRegion.md +55 -0
  386. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/prefetch.md +113 -0
  387. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/runtime.md +43 -0
  388. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route.md +772 -0
  389. package/skills/frontend/nextjs/assets/api-reference/file-conventions/src-folder.md +42 -0
  390. package/skills/frontend/nextjs/assets/api-reference/file-conventions/template.md +174 -0
  391. package/skills/frontend/nextjs/assets/api-reference/file-conventions/unauthorized.md +143 -0
  392. package/skills/frontend/nextjs/assets/api-reference/functions/after.md +332 -0
  393. package/skills/frontend/nextjs/assets/api-reference/functions/cacheLife.md +642 -0
  394. package/skills/frontend/nextjs/assets/api-reference/functions/cacheTag.md +272 -0
  395. package/skills/frontend/nextjs/assets/api-reference/functions/catchError.md +267 -0
  396. package/skills/frontend/nextjs/assets/api-reference/functions/connection.md +114 -0
  397. package/skills/frontend/nextjs/assets/api-reference/functions/cookies.md +349 -0
  398. package/skills/frontend/nextjs/assets/api-reference/functions/draft-mode.md +173 -0
  399. package/skills/frontend/nextjs/assets/api-reference/functions/fetch.md +141 -0
  400. package/skills/frontend/nextjs/assets/api-reference/functions/forbidden.md +327 -0
  401. package/skills/frontend/nextjs/assets/api-reference/functions/generate-image-metadata.md +311 -0
  402. package/skills/frontend/nextjs/assets/api-reference/functions/generate-metadata.md +1510 -0
  403. package/skills/frontend/nextjs/assets/api-reference/functions/generate-sitemaps.md +102 -0
  404. package/skills/frontend/nextjs/assets/api-reference/functions/generate-static-params.md +606 -0
  405. package/skills/frontend/nextjs/assets/api-reference/functions/generate-viewport.md +347 -0
  406. package/skills/frontend/nextjs/assets/api-reference/functions/headers.md +92 -0
  407. package/skills/frontend/nextjs/assets/api-reference/functions/image-response.md +225 -0
  408. package/skills/frontend/nextjs/assets/api-reference/functions/io.md +131 -0
  409. package/skills/frontend/nextjs/assets/api-reference/functions/navigation.md +220 -0
  410. package/skills/frontend/nextjs/assets/api-reference/functions/next-request.md +116 -0
  411. package/skills/frontend/nextjs/assets/api-reference/functions/next-response.md +219 -0
  412. package/skills/frontend/nextjs/assets/api-reference/functions/next-root-params.md +479 -0
  413. package/skills/frontend/nextjs/assets/api-reference/functions/not-found.md +269 -0
  414. package/skills/frontend/nextjs/assets/api-reference/functions/permanentRedirect.md +92 -0
  415. package/skills/frontend/nextjs/assets/api-reference/functions/prefetch.md +202 -0
  416. package/skills/frontend/nextjs/assets/api-reference/functions/redirect.md +255 -0
  417. package/skills/frontend/nextjs/assets/api-reference/functions/refresh.md +91 -0
  418. package/skills/frontend/nextjs/assets/api-reference/functions/revalidatePath.md +248 -0
  419. package/skills/frontend/nextjs/assets/api-reference/functions/revalidateTag.md +175 -0
  420. package/skills/frontend/nextjs/assets/api-reference/functions/unauthorized.md +389 -0
  421. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_cache.md +131 -0
  422. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_noStore.md +61 -0
  423. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_rethrow.md +79 -0
  424. package/skills/frontend/nextjs/assets/api-reference/functions/updateTag.md +173 -0
  425. package/skills/frontend/nextjs/assets/api-reference/functions/use-link-status.md +268 -0
  426. package/skills/frontend/nextjs/assets/api-reference/functions/use-offline.md +222 -0
  427. package/skills/frontend/nextjs/assets/api-reference/functions/use-params.md +102 -0
  428. package/skills/frontend/nextjs/assets/api-reference/functions/use-pathname.md +189 -0
  429. package/skills/frontend/nextjs/assets/api-reference/functions/use-report-web-vitals.md +175 -0
  430. package/skills/frontend/nextjs/assets/api-reference/functions/use-router.md +214 -0
  431. package/skills/frontend/nextjs/assets/api-reference/functions/use-search-params.md +416 -0
  432. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segment.md +214 -0
  433. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segments.md +116 -0
  434. package/skills/frontend/nextjs/assets/api-reference/functions/use-server-inserted-html.md +145 -0
  435. package/skills/frontend/nextjs/assets/api-reference/functions/userAgent.md +95 -0
  436. package/skills/frontend/nextjs/assets/api-reference/turbopack.md +552 -0
  437. package/skills/frontend/nextjs/assets/architecture/accessibility.md +47 -0
  438. package/skills/frontend/nextjs/assets/architecture/fast-refresh.md +122 -0
  439. package/skills/frontend/nextjs/assets/architecture/nextjs-compiler.md +376 -0
  440. package/skills/frontend/nextjs/assets/architecture/supported-browsers.md +146 -0
  441. package/skills/frontend/nextjs/assets/community/contribution-guide.md +459 -0
  442. package/skills/frontend/nextjs/assets/community/rspack.md +25 -0
  443. package/skills/frontend/nextjs/assets/getting-started/caching.md +626 -0
  444. package/skills/frontend/nextjs/assets/getting-started/css.md +336 -0
  445. package/skills/frontend/nextjs/assets/getting-started/deploying.md +115 -0
  446. package/skills/frontend/nextjs/assets/getting-started/error-handling.md +485 -0
  447. package/skills/frontend/nextjs/assets/getting-started/fetching-data.md +743 -0
  448. package/skills/frontend/nextjs/assets/getting-started/fonts.md +232 -0
  449. package/skills/frontend/nextjs/assets/getting-started/images.md +272 -0
  450. package/skills/frontend/nextjs/assets/getting-started/installation.md +446 -0
  451. package/skills/frontend/nextjs/assets/getting-started/layouts-and-pages.md +386 -0
  452. package/skills/frontend/nextjs/assets/getting-started/linking-and-navigating.md +475 -0
  453. package/skills/frontend/nextjs/assets/getting-started/metadata-and-og-images.md +370 -0
  454. package/skills/frontend/nextjs/assets/getting-started/mutating-data.md +679 -0
  455. package/skills/frontend/nextjs/assets/getting-started/project-structure.md +290 -0
  456. package/skills/frontend/nextjs/assets/getting-started/proxy.md +107 -0
  457. package/skills/frontend/nextjs/assets/getting-started/revalidating.md +241 -0
  458. package/skills/frontend/nextjs/assets/getting-started/route-handlers.md +233 -0
  459. package/skills/frontend/nextjs/assets/getting-started/server-and-client-components.md +683 -0
  460. package/skills/frontend/nextjs/assets/getting-started/upgrading.md +137 -0
  461. package/skills/frontend/nextjs/assets/glossary.md +315 -0
  462. package/skills/frontend/nextjs/evals/nextjsVerification.json +14 -0
  463. package/skills/frontend/nextjs/references/apiReference.md +3 -0
  464. package/skills/frontend/nextjs/references/dataAccessLayer.md +39 -0
  465. package/skills/frontend/nextjs/references/nextjsFeatureMap.md +276 -0
  466. package/skills/frontend/nextjs/references/productionChecklist.md +49 -0
  467. package/skills/frontend/nextjs/references/securityHeadersCsp.md +44 -0
  468. package/skills/frontend/nextjs/scripts/auditProductionReadiness.py +85 -0
  469. package/skills/frontend/shadcn-ui/SKILL.md +102 -0
  470. package/skills/frontend/shadcn-ui/assets/README.md +82 -0
  471. package/skills/frontend/shadcn-ui/assets/advanced/javascript.md +44 -0
  472. package/skills/frontend/shadcn-ui/assets/advanced/monorepo.md +254 -0
  473. package/skills/frontend/shadcn-ui/assets/advanced/react-19.md +166 -0
  474. package/skills/frontend/shadcn-ui/assets/advanced/tailwind-v4.md +333 -0
  475. package/skills/frontend/shadcn-ui/assets/ai-elements/chain-of-thought.md +519 -0
  476. package/skills/frontend/shadcn-ui/assets/ai-elements/chat.md +581 -0
  477. package/skills/frontend/shadcn-ui/assets/ai-elements/checkpoint.md +243 -0
  478. package/skills/frontend/shadcn-ui/assets/ai-elements/confirmation.md +382 -0
  479. package/skills/frontend/shadcn-ui/assets/ai-elements/context.md +188 -0
  480. package/skills/frontend/shadcn-ui/assets/ai-elements/file-tree.md +248 -0
  481. package/skills/frontend/shadcn-ui/assets/ai-elements/index.md +307 -0
  482. package/skills/frontend/shadcn-ui/assets/ai-elements/inline-citation.md +219 -0
  483. package/skills/frontend/shadcn-ui/assets/ai-elements/message.md +298 -0
  484. package/skills/frontend/shadcn-ui/assets/ai-elements/model-selector.md +368 -0
  485. package/skills/frontend/shadcn-ui/assets/ai-elements/plan.md +398 -0
  486. package/skills/frontend/shadcn-ui/assets/ai-elements/prompt-input.md +403 -0
  487. package/skills/frontend/shadcn-ui/assets/ai-elements/queue.md +517 -0
  488. package/skills/frontend/shadcn-ui/assets/ai-elements/reasoning.md +349 -0
  489. package/skills/frontend/shadcn-ui/assets/ai-elements/sources.md +303 -0
  490. package/skills/frontend/shadcn-ui/assets/ai-elements/stack-trace.md +514 -0
  491. package/skills/frontend/shadcn-ui/assets/ai-elements/subagent.md +551 -0
  492. package/skills/frontend/shadcn-ui/assets/ai-elements/suggestion.md +246 -0
  493. package/skills/frontend/shadcn-ui/assets/ai-elements/task.md +380 -0
  494. package/skills/frontend/shadcn-ui/assets/ai-elements/terminal.md +463 -0
  495. package/skills/frontend/shadcn-ui/assets/ai-elements/test-results.md +641 -0
  496. package/skills/frontend/shadcn-ui/assets/ai-elements/tool.md +915 -0
  497. package/skills/frontend/shadcn-ui/assets/components/accordion.md +490 -0
  498. package/skills/frontend/shadcn-ui/assets/components/alert-dialog.md +520 -0
  499. package/skills/frontend/shadcn-ui/assets/components/alert.md +351 -0
  500. package/skills/frontend/shadcn-ui/assets/components/aspect-ratio.md +206 -0
  501. package/skills/frontend/shadcn-ui/assets/components/attachment.md +715 -0
  502. package/skills/frontend/shadcn-ui/assets/components/avatar.md +581 -0
  503. package/skills/frontend/shadcn-ui/assets/components/badge.md +276 -0
  504. package/skills/frontend/shadcn-ui/assets/components/breadcrumb.md +556 -0
  505. package/skills/frontend/shadcn-ui/assets/components/bubble.md +706 -0
  506. package/skills/frontend/shadcn-ui/assets/components/button-group.md +969 -0
  507. package/skills/frontend/shadcn-ui/assets/components/button.md +523 -0
  508. package/skills/frontend/shadcn-ui/assets/components/calendar.md +959 -0
  509. package/skills/frontend/shadcn-ui/assets/components/card.md +684 -0
  510. package/skills/frontend/shadcn-ui/assets/components/carousel.md +643 -0
  511. package/skills/frontend/shadcn-ui/assets/components/chart.md +1295 -0
  512. package/skills/frontend/shadcn-ui/assets/components/checkbox.md +553 -0
  513. package/skills/frontend/shadcn-ui/assets/components/code-block.md +2041 -0
  514. package/skills/frontend/shadcn-ui/assets/components/collapsible.md +504 -0
  515. package/skills/frontend/shadcn-ui/assets/components/combobox.md +1102 -0
  516. package/skills/frontend/shadcn-ui/assets/components/command.md +682 -0
  517. package/skills/frontend/shadcn-ui/assets/components/context-menu.md +949 -0
  518. package/skills/frontend/shadcn-ui/assets/components/data-table.md +1667 -0
  519. package/skills/frontend/shadcn-ui/assets/components/date-picker.md +698 -0
  520. package/skills/frontend/shadcn-ui/assets/components/dialog.md +454 -0
  521. package/skills/frontend/shadcn-ui/assets/components/direction.md +205 -0
  522. package/skills/frontend/shadcn-ui/assets/components/drawer.md +806 -0
  523. package/skills/frontend/shadcn-ui/assets/components/dropdown-menu.md +1315 -0
  524. package/skills/frontend/shadcn-ui/assets/components/empty.md +562 -0
  525. package/skills/frontend/shadcn-ui/assets/components/field.md +1321 -0
  526. package/skills/frontend/shadcn-ui/assets/components/hover-card.md +342 -0
  527. package/skills/frontend/shadcn-ui/assets/components/index.md +82 -0
  528. package/skills/frontend/shadcn-ui/assets/components/input-group.md +980 -0
  529. package/skills/frontend/shadcn-ui/assets/components/input-otp.md +551 -0
  530. package/skills/frontend/shadcn-ui/assets/components/input.md +555 -0
  531. package/skills/frontend/shadcn-ui/assets/components/item.md +937 -0
  532. package/skills/frontend/shadcn-ui/assets/components/kbd.md +290 -0
  533. package/skills/frontend/shadcn-ui/assets/components/label.md +327 -0
  534. package/skills/frontend/shadcn-ui/assets/components/marker.md +445 -0
  535. package/skills/frontend/shadcn-ui/assets/components/menubar.md +804 -0
  536. package/skills/frontend/shadcn-ui/assets/components/message-scroller.md +2770 -0
  537. package/skills/frontend/shadcn-ui/assets/components/message.md +618 -0
  538. package/skills/frontend/shadcn-ui/assets/components/native-select.md +321 -0
  539. package/skills/frontend/shadcn-ui/assets/components/navigation-menu.md +568 -0
  540. package/skills/frontend/shadcn-ui/assets/components/pagination.md +425 -0
  541. package/skills/frontend/shadcn-ui/assets/components/popover.md +402 -0
  542. package/skills/frontend/shadcn-ui/assets/components/progress.md +240 -0
  543. package/skills/frontend/shadcn-ui/assets/components/questionnaire.md +2055 -0
  544. package/skills/frontend/shadcn-ui/assets/components/radio-group.md +440 -0
  545. package/skills/frontend/shadcn-ui/assets/components/resizable.md +302 -0
  546. package/skills/frontend/shadcn-ui/assets/components/scroll-area.md +226 -0
  547. package/skills/frontend/shadcn-ui/assets/components/select.md +647 -0
  548. package/skills/frontend/shadcn-ui/assets/components/separator.md +235 -0
  549. package/skills/frontend/shadcn-ui/assets/components/sheet.md +354 -0
  550. package/skills/frontend/shadcn-ui/assets/components/sidebar.md +1156 -0
  551. package/skills/frontend/shadcn-ui/assets/components/skeleton.md +217 -0
  552. package/skills/frontend/shadcn-ui/assets/components/slider.md +253 -0
  553. package/skills/frontend/shadcn-ui/assets/components/spinner.md +352 -0
  554. package/skills/frontend/shadcn-ui/assets/components/switch.md +296 -0
  555. package/skills/frontend/shadcn-ui/assets/components/table.md +572 -0
  556. package/skills/frontend/shadcn-ui/assets/components/tabs.md +425 -0
  557. package/skills/frontend/shadcn-ui/assets/components/textarea.md +218 -0
  558. package/skills/frontend/shadcn-ui/assets/components/toast.md +260 -0
  559. package/skills/frontend/shadcn-ui/assets/components/toggle-group.md +419 -0
  560. package/skills/frontend/shadcn-ui/assets/components/toggle.md +220 -0
  561. package/skills/frontend/shadcn-ui/assets/components/tooltip.md +332 -0
  562. package/skills/frontend/shadcn-ui/assets/components/trace.md +1890 -0
  563. package/skills/frontend/shadcn-ui/assets/components/typography.md +561 -0
  564. package/skills/frontend/shadcn-ui/assets/dark-mode/next.md +108 -0
  565. package/skills/frontend/shadcn-ui/assets/dark-mode/overview.md +75 -0
  566. package/skills/frontend/shadcn-ui/assets/dark-mode/vite.md +144 -0
  567. package/skills/frontend/shadcn-ui/assets/forms/next.md +716 -0
  568. package/skills/frontend/shadcn-ui/assets/forms/overview.md +60 -0
  569. package/skills/frontend/shadcn-ui/assets/forms/react-hook-form.md +2055 -0
  570. package/skills/frontend/shadcn-ui/assets/forms/tanstack-form.md +2236 -0
  571. package/skills/frontend/shadcn-ui/assets/installation/astro.md +252 -0
  572. package/skills/frontend/shadcn-ui/assets/installation/manual.md +255 -0
  573. package/skills/frontend/shadcn-ui/assets/installation/next.md +256 -0
  574. package/skills/frontend/shadcn-ui/assets/installation/react-router.md +226 -0
  575. package/skills/frontend/shadcn-ui/assets/installation/remix.md +52 -0
  576. package/skills/frontend/shadcn-ui/assets/installation/vite.md +314 -0
  577. package/skills/frontend/shadcn-ui/assets/mcp/mcp.md +338 -0
  578. package/skills/frontend/shadcn-ui/assets/overview/changelog.md +6 -0
  579. package/skills/frontend/shadcn-ui/assets/overview/cli.md +738 -0
  580. package/skills/frontend/shadcn-ui/assets/overview/components-json.md +379 -0
  581. package/skills/frontend/shadcn-ui/assets/overview/directory.md +74 -0
  582. package/skills/frontend/shadcn-ui/assets/overview/introduction.md +77 -0
  583. package/skills/frontend/shadcn-ui/assets/overview/skills.md +71 -0
  584. package/skills/frontend/shadcn-ui/assets/overview/theming.md +304 -0
  585. package/skills/frontend/shadcn-ui/assets/overview/typeset.md +242 -0
  586. package/skills/frontend/shadcn-ui/assets/registry/getting-started.md +648 -0
  587. package/skills/frontend/shadcn-ui/assets/registry/overview.md +90 -0
  588. package/skills/frontend/shadcn-ui/assets/registry/registry-item-json.md +483 -0
  589. package/skills/frontend/shadcn-ui/assets/registry/registry-json.md +178 -0
  590. package/skills/frontend/shadcn-ui/evals/componentVerification.json +19 -0
  591. package/skills/frontend/shadcn-ui/references/aiComponentsCatalog.md +51 -0
  592. package/skills/frontend/shadcn-ui/references/apiReference.md +3 -0
  593. package/skills/frontend/shadcn-ui/references/blocksCatalog.md +32 -0
  594. package/skills/frontend/shadcn-ui/references/cliCommands.md +47 -0
  595. package/skills/frontend/shadcn-ui/references/componentMarkdownSources.md +48 -0
  596. package/skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py +43 -0
  597. package/skills/frontend/tsxReactStandard/SKILL.md +150 -0
  598. package/skills/frontend/tsxReactStandard/evals/tsxVerification.json +14 -0
  599. package/skills/frontend/tsxReactStandard/references/apiReference.md +3 -0
  600. package/skills/frontend/tsxReactStandard/references/discriminatedUnions.md +31 -0
  601. package/skills/frontend/tsxReactStandard/references/tsconfigStrict.md +36 -0
  602. package/skills/frontend/tsxReactStandard/scripts/validateTsxTypes.py +44 -0
  603. package/skills/gitVersionControl/gitWorkflow/SKILL.md +128 -0
  604. package/skills/gitVersionControl/gitWorkflow/assets/README.md +23 -0
  605. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-environment.md +87 -0
  606. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-formatting.md +156 -0
  607. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-reference.md +2363 -0
  608. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-git.md +156 -0
  609. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-remote-repositories.md +65 -0
  610. package/skills/gitVersionControl/gitWorkflow/assets/using-git/associating-text-editors-with-git.md +93 -0
  611. package/skills/gitVersionControl/gitWorkflow/assets/using-git/caching-your-github-credentials.md +115 -0
  612. package/skills/gitVersionControl/gitWorkflow/assets/using-git/getting-changes-from-a-remote-repository.md +76 -0
  613. package/skills/gitVersionControl/gitWorkflow/assets/using-git/ignoring-files.md +51 -0
  614. package/skills/gitVersionControl/gitWorkflow/assets/using-git/managing-remote-repositories.md +231 -0
  615. package/skills/gitVersionControl/gitWorkflow/assets/using-git/pushing-commits-to-a-remote-repository.md +119 -0
  616. package/skills/gitVersionControl/gitWorkflow/evals/evalGitWorkflow.py +43 -0
  617. package/skills/gitVersionControl/gitWorkflow/references/apiReference.md +3 -0
  618. package/skills/gitVersionControl/gitWorkflow/references/branchingModels.md +32 -0
  619. package/skills/gitVersionControl/gitWorkflow/scripts/diagnoseGitGraph.py +68 -0
  620. package/skills/github/assets/README.md +39 -0
  621. package/skills/github/assets/cli/gh-environment.md +87 -0
  622. package/skills/github/assets/cli/gh-formatting.md +156 -0
  623. package/skills/github/assets/cli/gh-reference.md +2363 -0
  624. package/skills/github/assets/docs-api/github-docs-api.md +60 -0
  625. package/skills/github/assets/rest-api/actions-secrets.md +1272 -0
  626. package/skills/github/assets/rest-api/actions-variables.md +1247 -0
  627. package/skills/github/assets/rest-api/actions-workflow-runs.md +1697 -0
  628. package/skills/github/assets/rest-api/actions-workflows.md +348 -0
  629. package/skills/github/assets/rest-api/authenticating.md +174 -0
  630. package/skills/github/assets/rest-api/branches.md +727 -0
  631. package/skills/github/assets/rest-api/checks-runs.md +1013 -0
  632. package/skills/github/assets/rest-api/checks-suites.md +1142 -0
  633. package/skills/github/assets/rest-api/code-scanning.md +2957 -0
  634. package/skills/github/assets/rest-api/collaborators.md +547 -0
  635. package/skills/github/assets/rest-api/commits.md +957 -0
  636. package/skills/github/assets/rest-api/dependabot-alerts.md +895 -0
  637. package/skills/github/assets/rest-api/orgs.md +1172 -0
  638. package/skills/github/assets/rest-api/overview.md +875 -0
  639. package/skills/github/assets/rest-api/pull-reviews.md +722 -0
  640. package/skills/github/assets/rest-api/pulls.md +1605 -0
  641. package/skills/github/assets/rest-api/quickstart.md +344 -0
  642. package/skills/github/assets/rest-api/releases.md +650 -0
  643. package/skills/github/assets/rest-api/repos.md +2957 -0
  644. package/skills/github/assets/rest-api/rules.md +1507 -0
  645. package/skills/github/assets/rest-api/secret-scanning.md +947 -0
  646. package/skills/github/assets/rest-api/teams.md +1690 -0
  647. package/skills/github/githubAction/SKILL.md +159 -0
  648. package/skills/github/githubAction/assets/README.md +38 -0
  649. package/skills/github/githubAction/assets/reference/contexts.md +918 -0
  650. package/skills/github/githubAction/assets/reference/dependency-caching.md +393 -0
  651. package/skills/github/githubAction/assets/reference/events-that-trigger-workflows.md +1348 -0
  652. package/skills/github/githubAction/assets/reference/expressions.md +441 -0
  653. package/skills/github/githubAction/assets/reference/metadata-syntax.md +803 -0
  654. package/skills/github/githubAction/assets/reference/variables.md +149 -0
  655. package/skills/github/githubAction/assets/reference/workflow-cancellation.md +22 -0
  656. package/skills/github/githubAction/assets/reference/workflow-commands.md +1056 -0
  657. package/skills/github/githubAction/assets/reference/workflow-syntax.md +1721 -0
  658. package/skills/github/githubAction/assets/rest-api/secrets.md +1272 -0
  659. package/skills/github/githubAction/assets/rest-api/workflow-runs.md +1697 -0
  660. package/skills/github/githubAction/assets/rest-api/workflows.md +348 -0
  661. package/skills/github/githubAction/assets/starter-workflows/automation/stale.yml +27 -0
  662. package/skills/github/githubAction/assets/starter-workflows/ci/blank.yml +36 -0
  663. package/skills/github/githubAction/assets/starter-workflows/ci/docker-image.yml +18 -0
  664. package/skills/github/githubAction/assets/starter-workflows/ci/go.yml +28 -0
  665. package/skills/github/githubAction/assets/starter-workflows/ci/maven.yml +35 -0
  666. package/skills/github/githubAction/assets/starter-workflows/ci/node.js.yml +31 -0
  667. package/skills/github/githubAction/assets/starter-workflows/ci/python-app.yml +39 -0
  668. package/skills/github/githubAction/assets/starter-workflows/ci/rust.yml +22 -0
  669. package/skills/github/githubAction/assets/starter-workflows/code-scanning/codeql.yml +97 -0
  670. package/skills/github/githubAction/evals/actionVerification.json +14 -0
  671. package/skills/github/githubAction/references/apiReference.md +3 -0
  672. package/skills/github/githubAction/references/workflowPatterns.md +81 -0
  673. package/skills/github/githubAction/scripts/validateWorkflowYaml.py +53 -0
  674. package/skills/github/githubQuality/SKILL.md +136 -0
  675. package/skills/github/githubQuality/assets/README.md +24 -0
  676. package/skills/github/githubQuality/assets/pull-requests/about-code-owners.md +178 -0
  677. package/skills/github/githubQuality/assets/pull-requests/about-merge-methods.md +48 -0
  678. package/skills/github/githubQuality/assets/pull-requests/creating-a-pull-request.md +170 -0
  679. package/skills/github/githubQuality/assets/pull-requests/giving-reviews.md +48 -0
  680. package/skills/github/githubQuality/assets/pull-requests/managing-a-merge-queue.md +134 -0
  681. package/skills/github/githubQuality/assets/pull-requests/merging-a-pull-request.md +101 -0
  682. package/skills/github/githubQuality/assets/pull-requests/resolving-reviews.md +59 -0
  683. package/skills/github/githubQuality/assets/pull-requests/status-checks.md +135 -0
  684. package/skills/github/githubQuality/assets/rest-api/checks-runs.md +1013 -0
  685. package/skills/github/githubQuality/assets/rest-api/checks-suites.md +1142 -0
  686. package/skills/github/githubQuality/assets/rest-api/commits.md +957 -0
  687. package/skills/github/githubQuality/assets/rest-api/pulls.md +1605 -0
  688. package/skills/github/githubQuality/assets/rest-api/reviews.md +722 -0
  689. package/skills/github/githubQuality/evals/qualityVerification.json +14 -0
  690. package/skills/github/githubQuality/references/apiReference.md +3 -0
  691. package/skills/github/githubQuality/references/codeownersExample.md +26 -0
  692. package/skills/github/githubQuality/references/prTemplate.md +20 -0
  693. package/skills/github/githubQuality/scripts/auditPrQuality.py +52 -0
  694. package/skills/github/githubSecurity/SKILL.md +170 -0
  695. package/skills/github/githubSecurity/assets/README.md +32 -0
  696. package/skills/github/githubSecurity/assets/code-scanning/code-scanning-alerts.md +133 -0
  697. package/skills/github/githubSecurity/assets/code-scanning/code-scanning.md +67 -0
  698. package/skills/github/githubSecurity/assets/code-scanning/codeql-code-scanning.md +79 -0
  699. package/skills/github/githubSecurity/assets/code-scanning/configure-code-scanning.md +121 -0
  700. package/skills/github/githubSecurity/assets/dependabot/about-the-dependabot-yml-file.md +74 -0
  701. package/skills/github/githubSecurity/assets/dependabot/dependabot-alerts.md +133 -0
  702. package/skills/github/githubSecurity/assets/dependabot/dependabot-security-updates.md +95 -0
  703. package/skills/github/githubSecurity/assets/dependabot/dependabot-version-updates.md +80 -0
  704. package/skills/github/githubSecurity/assets/rest-api/code-scanning.md +2957 -0
  705. package/skills/github/githubSecurity/assets/rest-api/dependabot-alerts.md +895 -0
  706. package/skills/github/githubSecurity/assets/rest-api/secret-scanning.md +947 -0
  707. package/skills/github/githubSecurity/assets/secret-scanning/enable-secret-scanning.md +59 -0
  708. package/skills/github/githubSecurity/assets/secret-scanning/secret-scanning.md +105 -0
  709. package/skills/github/githubSecurity/assets/security-advisories/github-advisory-database.md +148 -0
  710. package/skills/github/githubSecurity/evals/securityVerification.json +14 -0
  711. package/skills/github/githubSecurity/references/apiReference.md +3 -0
  712. package/skills/github/githubSecurity/references/codeqlAnalysis.yml +42 -0
  713. package/skills/github/githubSecurity/references/dependabotConfig.yml +27 -0
  714. package/skills/github/githubSecurity/scripts/auditRepoSecurity.py +47 -0
  715. package/skills/github/githubSetup/SKILL.md +137 -0
  716. package/skills/github/githubSetup/assets/README.md +40 -0
  717. package/skills/github/githubSetup/assets/branches/about-protected-branches.md +198 -0
  718. package/skills/github/githubSetup/assets/branches/changing-the-default-branch.md +49 -0
  719. package/skills/github/githubSetup/assets/branches/deleting-and-restoring-branches.md +44 -0
  720. package/skills/github/githubSetup/assets/branches/managing-a-branch-protection-rule.md +115 -0
  721. package/skills/github/githubSetup/assets/branches/renaming-a-branch.md +74 -0
  722. package/skills/github/githubSetup/assets/branches/viewing-branches-in-your-repository.md +30 -0
  723. package/skills/github/githubSetup/assets/repositories/about-repositories.md +127 -0
  724. package/skills/github/githubSetup/assets/repositories/cloning-a-repository.md +114 -0
  725. package/skills/github/githubSetup/assets/repositories/creating-a-new-repository.md +82 -0
  726. package/skills/github/githubSetup/assets/repositories/creating-a-repository-from-a-template.md +51 -0
  727. package/skills/github/githubSetup/assets/repositories/deleting-a-repository.md +34 -0
  728. package/skills/github/githubSetup/assets/repositories/managing-teams-and-people-with-access.md +69 -0
  729. package/skills/github/githubSetup/assets/repositories/renaming-a-repository.md +47 -0
  730. package/skills/github/githubSetup/assets/repositories/restoring-a-deleted-repository.md +61 -0
  731. package/skills/github/githubSetup/assets/repositories/setting-repository-visibility.md +137 -0
  732. package/skills/github/githubSetup/assets/rest-api/branches.md +727 -0
  733. package/skills/github/githubSetup/assets/rest-api/quickstart.md +344 -0
  734. package/skills/github/githubSetup/assets/rest-api/repos.md +2957 -0
  735. package/skills/github/githubSetup/assets/rulesets/about-rulesets.md +72 -0
  736. package/skills/github/githubSetup/assets/rulesets/available-rules-for-rulesets.md +383 -0
  737. package/skills/github/githubSetup/assets/rulesets/converting-branch-protections-to-rulesets.md +92 -0
  738. package/skills/github/githubSetup/assets/rulesets/creating-rulesets-for-a-repository.md +108 -0
  739. package/skills/github/githubSetup/assets/rulesets/managing-rulesets-for-a-repository.md +149 -0
  740. package/skills/github/githubSetup/assets/rulesets/troubleshooting-rules.md +122 -0
  741. package/skills/github/githubSetup/evals/setupVerification.json +14 -0
  742. package/skills/github/githubSetup/references/apiReference.md +3 -0
  743. package/skills/github/githubSetup/references/repoSettingsBlueprint.md +13 -0
  744. package/skills/github/githubSetup/references/rulesetTemplates.json +42 -0
  745. package/skills/github/githubSetup/scripts/configureRepoBaseline.py +46 -0
  746. package/skills/github/githubTeam/SKILL.md +115 -0
  747. package/skills/github/githubTeam/assets/README.md +21 -0
  748. package/skills/github/githubTeam/assets/organizations/about-organizations.md +69 -0
  749. package/skills/github/githubTeam/assets/organizations/repository-roles-for-an-organization.md +94 -0
  750. package/skills/github/githubTeam/assets/rest-api/collaborators.md +547 -0
  751. package/skills/github/githubTeam/assets/rest-api/orgs.md +1172 -0
  752. package/skills/github/githubTeam/assets/rest-api/teams.md +1690 -0
  753. package/skills/github/githubTeam/assets/teams/about-teams.md +82 -0
  754. package/skills/github/githubTeam/assets/teams/adding-members-to-a-team.md +55 -0
  755. package/skills/github/githubTeam/evals/teamVerification.json +14 -0
  756. package/skills/github/githubTeam/references/apiReference.md +3 -0
  757. package/skills/github/githubTeam/references/permissionMatrix.md +17 -0
  758. package/skills/github/githubTeam/references/reviewAssignment.md +17 -0
  759. package/skills/github/githubTeam/scripts/manageTeamSync.py +31 -0
  760. package/skills/securityQa/llmSecurityRedteaming/SKILL.md +86 -0
  761. package/skills/securityQa/llmSecurityRedteaming/evals/securityRedteamVerification.json +14 -0
  762. package/skills/securityQa/llmSecurityRedteaming/references/apiReference.md +3 -0
  763. package/skills/securityQa/llmSecurityRedteaming/references/jailbreakTaxonomy.md +6 -0
  764. package/skills/securityQa/llmSecurityRedteaming/references/owaspLlmTopTen.md +12 -0
  765. package/skills/securityQa/llmSecurityRedteaming/scripts/testPromptInjection.py +34 -0
  766. package/skills/softwareDevelopment/requirementsEngineering/SKILL.md +110 -0
  767. package/skills/softwareDevelopment/requirementsEngineering/evals/evalRequirements.py +33 -0
  768. package/skills/softwareDevelopment/requirementsEngineering/references/apiReference.md +3 -0
  769. package/skills/softwareDevelopment/requirementsEngineering/references/requirementsAnalysisModels.md +34 -0
  770. package/skills/softwareDevelopment/requirementsEngineering/scripts/validateUserStories.py +49 -0
  771. package/skills/testing/testDrivenDevelopment/SKILL.md +122 -0
  772. package/skills/testing/testDrivenDevelopment/evals/evalTdd.py +25 -0
  773. package/skills/testing/testDrivenDevelopment/references/apiReference.md +3 -0
  774. package/skills/testing/testDrivenDevelopment/references/testPyramidDoubles.md +35 -0
  775. package/skills/testing/testDrivenDevelopment/scripts/auditTestPyramid.py +58 -0
@@ -0,0 +1,947 @@
1
+ # REST API endpoints for secret scanning
2
+
3
+ Use the REST API to retrieve and update secret alerts from a repository.
4
+
5
+ ## About secret scanning
6
+
7
+ You can use the API to:
8
+
9
+ * Enable or disable secret scanning and push protection for a repository. For more information, see [REST API endpoints for repositories](/en/rest/repos/repos#update-a-repository) and expand the "Properties of the `security_and_analysis` object" section.
10
+ * Retrieve and update secret scanning alerts from a repository. For further details, see the sections below.
11
+
12
+ For more information about secret scanning, see [Secret scanning](/en/code-security/concepts/secret-security/secret-scanning).
13
+
14
+ > [!NOTE]
15
+ > Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.
16
+
17
+ ## List secret scanning alerts for an organization
18
+
19
+ ```
20
+ GET /orgs/{org}/secret-scanning/alerts
21
+ ```
22
+
23
+ Lists secret scanning alerts for eligible repositories in an organization, from newest to oldest.
24
+ The authenticated user must be an administrator or security manager for the organization to use this endpoint.
25
+ OAuth app tokens and personal access tokens (classic) need the repo or security\_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public\_repo scope instead.
26
+
27
+ ### Parameters
28
+
29
+ #### Headers
30
+
31
+ * **`accept`** (string)
32
+ Setting to `application/vnd.github+json` is recommended.
33
+
34
+ #### Path and query parameters
35
+
36
+ * **`org`** (string) (required)
37
+ The organization name. The name is not case sensitive.
38
+
39
+ * **`state`** (string)
40
+ Set to open or resolved to only list secret scanning alerts in a specific state.
41
+ Can be one of: `open`, `resolved`
42
+
43
+ * **`secret_type`** (string)
44
+ A comma-separated list of secret types to return. All default secret patterns are returned. To return generic patterns, pass the token name(s) in the parameter. See "Supported secret scanning patterns" for a complete list of secret types.
45
+
46
+ * **`exclude_secret_types`** (string)
47
+ A comma-separated list of secret types to exclude from the results. All default secret patterns are returned except those matching the specified types. Cannot be combined with the secret\_type parameter. See "Supported secret scanning patterns" for a complete list of secret types.
48
+
49
+ * **`exclude_providers`** (string)
50
+ A comma-separated list of provider slugs to exclude from the results.
51
+ Provider slugs use lowercase with underscores (e.g., github\_secret\_scanning, clojars).
52
+ You can find the provider slug in the provider\_slug field of each alert.
53
+ Cannot be combined with the providers parameter.
54
+
55
+ * **`providers`** (string)
56
+ A comma-separated list of provider slugs to filter by.
57
+ Provider slugs use lowercase with underscores (e.g., github\_secret\_scanning, clojars).
58
+ You can find the provider slug in the provider\_slug field of each alert.
59
+ Cannot be combined with the exclude\_providers parameter.
60
+
61
+ * **`resolution`** (string)
62
+ A comma-separated list of resolutions. Only secret scanning alerts with one of these resolutions are listed. Valid resolutions are false\_positive, wont\_fix, revoked, pattern\_edited, pattern\_deleted or used\_in\_tests.
63
+
64
+ * **`assignee`** (string)
65
+ Filters alerts by assignee. Use \* to get all assigned alerts, none to get all unassigned alerts, or a GitHub username to get alerts assigned to a specific user.
66
+
67
+ * **`sort`** (string)
68
+ The property to sort the results by. created means when the alert was created. updated means when the alert was updated or resolved.
69
+ Default: `created`
70
+ Can be one of: `created`, `updated`
71
+
72
+ * **`direction`** (string)
73
+ The direction to sort the results by.
74
+ Default: `desc`
75
+ Can be one of: `asc`, `desc`
76
+
77
+ * **`page`** (integer)
78
+ The page number of the results to fetch. For more information, see "Using pagination in the REST API."
79
+ Default: `1`
80
+
81
+ * **`per_page`** (integer)
82
+ The number of results per page (max 100). For more information, see "Using pagination in the REST API."
83
+ Default: `30`
84
+
85
+ * **`before`** (string)
86
+ A cursor, as given in the Link header. If specified, the query only searches for events before this cursor. To receive an initial cursor on your first request, include an empty "before" query string.
87
+
88
+ * **`after`** (string)
89
+ A cursor, as given in the Link header. If specified, the query only searches for events after this cursor. To receive an initial cursor on your first request, include an empty "after" query string.
90
+
91
+ * **`validity`** (string)
92
+ A comma-separated list of validities that, when present, will return alerts that match the validities in this list. Valid options are active, inactive, and unknown.
93
+
94
+ * **`is_publicly_leaked`** (boolean)
95
+ A boolean value representing whether or not to filter alerts by the publicly-leaked tag being present.
96
+ Default: `false`
97
+
98
+ * **`is_multi_repo`** (boolean)
99
+ A boolean value representing whether or not to filter alerts by the multi-repo tag being present.
100
+ Default: `false`
101
+
102
+ * **`hide_secret`** (boolean)
103
+ A boolean value representing whether or not to hide literal secrets in the results.
104
+ Default: `false`
105
+
106
+ * **`is_bypassed`** (boolean)
107
+ A boolean value (true or false) indicating whether to filter alerts by their push protection bypass status. When set to true, only alerts that were created because a push protection rule was bypassed will be returned. When set to false, only alerts that were not caused by a push protection bypass will be returned.
108
+
109
+ * **`included_metadata`** (string)
110
+ A comma-separated list of metadata fields to filter alerts by. Only alerts that have all of the
111
+ specified metadata fields attached will be returned. Possible values are: owner-email, owner-id,
112
+ owner-name, secret-id, secret-name, secret-issued-date, secret-expiration-date, organization-name,
113
+ organization-id, last-used-date, and has-organization-access.
114
+
115
+ * **`owner_email_hash`** (string)
116
+ Filters alerts to only those whose attached owner\_email metadata field matches the
117
+ provided value. The value must be the lowercase hex-encoded SHA-256 hash of the email
118
+ address to match (for example, the SHA-256 of <user@example.com>). Only alerts that
119
+ have an owner\_email metadata value whose SHA-256 hash equals this parameter are
120
+ returned.
121
+
122
+ ### HTTP response status codes
123
+
124
+ * **200** - OK
125
+
126
+ * **404** - Resource not found
127
+
128
+ * **503** - Service unavailable
129
+
130
+ ### Code examples
131
+
132
+ #### Example
133
+
134
+ **Request:**
135
+
136
+ ```curl
137
+ curl -L \
138
+ -X GET \
139
+ https://api.github.com/orgs/ORG/secret-scanning/alerts
140
+ ```
141
+
142
+ **Response schema (Status: 200):**
143
+
144
+ Array of objects:
145
+
146
+ * `number`: integer, read-only
147
+ * `created_at`: string, format: date-time, read-only
148
+ * `updated_at`: any of:
149
+ * **null**
150
+ * **string, format: date-time, read-only**
151
+ * `url`: string, format: uri, read-only
152
+ * `html_url`: string, format: uri, read-only
153
+ * `locations_url`: string, format: uri
154
+ * `state`: string, enum: `open`, `resolved`
155
+ * `resolution`: string or null, enum: `false_positive`, `wont_fix`, `revoked`, `used_in_tests`, `null`
156
+ * `resolved_at`: string or null, format: date-time
157
+ * `resolved_by`: any of:
158
+ * **null**
159
+ * **Simple User**
160
+ * `name`: string or null
161
+ * `email`: string or null
162
+ * `login`: required, string
163
+ * `id`: required, integer, format: int64
164
+ * `node_id`: required, string
165
+ * `avatar_url`: required, string, format: uri
166
+ * `gravatar_id`: required, string or null
167
+ * `url`: required, string, format: uri
168
+ * `html_url`: required, string, format: uri
169
+ * `followers_url`: required, string, format: uri
170
+ * `following_url`: required, string
171
+ * `gists_url`: required, string
172
+ * `starred_url`: required, string
173
+ * `subscriptions_url`: required, string, format: uri
174
+ * `organizations_url`: required, string, format: uri
175
+ * `repos_url`: required, string, format: uri
176
+ * `events_url`: required, string
177
+ * `received_events_url`: required, string, format: uri
178
+ * `type`: required, string
179
+ * `site_admin`: required, boolean
180
+ * `starred_at`: string
181
+ * `user_view_type`: string
182
+ * `secret_type`: string
183
+ * `secret_type_display_name`: string
184
+ * `provider`: string or null
185
+ * `provider_slug`: string or null
186
+ * `secret`: string
187
+ * `repository`: `Simple Repository`:
188
+ * `id`: required, integer, format: int64
189
+ * `node_id`: required, string
190
+ * `name`: required, string
191
+ * `full_name`: required, string
192
+ * `owner`: required, `Simple User` (see above)
193
+ * `private`: required, boolean
194
+ * `html_url`: required, string, format: uri
195
+ * `description`: required, string or null
196
+ * `fork`: required, boolean
197
+ * `url`: required, string, format: uri
198
+ * `archive_url`: required, string
199
+ * `assignees_url`: required, string
200
+ * `blobs_url`: required, string
201
+ * `branches_url`: required, string
202
+ * `collaborators_url`: required, string
203
+ * `comments_url`: required, string
204
+ * `commits_url`: required, string
205
+ * `compare_url`: required, string
206
+ * `contents_url`: required, string
207
+ * `contributors_url`: required, string, format: uri
208
+ * `deployments_url`: required, string, format: uri
209
+ * `downloads_url`: required, string, format: uri
210
+ * `events_url`: required, string, format: uri
211
+ * `forks_url`: required, string, format: uri
212
+ * `git_commits_url`: required, string
213
+ * `git_refs_url`: required, string
214
+ * `git_tags_url`: required, string
215
+ * `issue_comment_url`: required, string
216
+ * `issue_events_url`: required, string
217
+ * `issues_url`: required, string
218
+ * `keys_url`: required, string
219
+ * `labels_url`: required, string
220
+ * `languages_url`: required, string, format: uri
221
+ * `merges_url`: required, string, format: uri
222
+ * `milestones_url`: required, string
223
+ * `notifications_url`: required, string
224
+ * `pulls_url`: required, string
225
+ * `releases_url`: required, string
226
+ * `stargazers_url`: required, string, format: uri
227
+ * `statuses_url`: required, string
228
+ * `subscribers_url`: required, string, format: uri
229
+ * `subscription_url`: required, string, format: uri
230
+ * `tags_url`: required, string, format: uri
231
+ * `teams_url`: required, string, format: uri
232
+ * `trees_url`: required, string
233
+ * `hooks_url`: required, string, format: uri
234
+ * `push_protection_bypassed`: boolean or null
235
+ * `push_protection_bypassed_by`: any of:
236
+ * **null**
237
+ * **Simple User** (see above)
238
+ * `push_protection_bypassed_at`: string or null, format: date-time
239
+ * `push_protection_bypass_request_reviewer`: any of:
240
+ * **null**
241
+ * **Simple User** (see above)
242
+ * `push_protection_bypass_request_reviewer_comment`: string or null
243
+ * `push_protection_bypass_request_comment`: string or null
244
+ * `push_protection_bypass_request_html_url`: string or null, format: uri
245
+ * `resolution_comment`: string or null
246
+ * `validity`: string, enum: `active`, `inactive`, `unknown`
247
+ * `publicly_leaked`: boolean or null
248
+ * `multi_repo`: boolean or null
249
+ * `is_base64_encoded`: boolean or null
250
+ * `first_location_detected`: any of:
251
+ * **null**
252
+ * **object**
253
+ * `has_more_locations`: boolean
254
+ * `assigned_to`: any of:
255
+ * **null**
256
+ * **Simple User** (see above)
257
+ * `closure_request_comment`: string or null
258
+ * `closure_request_reviewer_comment`: string or null
259
+ * `closure_request_reviewer`: any of:
260
+ * **null**
261
+ * **Simple User** (see above)
262
+
263
+ ## List secret scanning alerts for a repository
264
+
265
+ ```
266
+ GET /repos/{owner}/{repo}/secret-scanning/alerts
267
+ ```
268
+
269
+ Lists secret scanning alerts for an eligible repository, from newest to oldest.
270
+ The authenticated user must be an administrator for the repository or for the organization that owns the repository to use this endpoint.
271
+ OAuth app tokens and personal access tokens (classic) need the repo or security\_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public\_repo scope instead.
272
+
273
+ ### Parameters
274
+
275
+ #### Headers
276
+
277
+ * **`accept`** (string)
278
+ Setting to `application/vnd.github+json` is recommended.
279
+
280
+ #### Path and query parameters
281
+
282
+ * **`owner`** (string) (required)
283
+ The account owner of the repository. The name is not case sensitive.
284
+
285
+ * **`repo`** (string) (required)
286
+ The name of the repository without the .git extension. The name is not case sensitive.
287
+
288
+ * **`state`** (string)
289
+ Set to open or resolved to only list secret scanning alerts in a specific state.
290
+ Can be one of: `open`, `resolved`
291
+
292
+ * **`secret_type`** (string)
293
+ A comma-separated list of secret types to return. All default secret patterns are returned. To return generic patterns, pass the token name(s) in the parameter. See "Supported secret scanning patterns" for a complete list of secret types.
294
+
295
+ * **`exclude_secret_types`** (string)
296
+ A comma-separated list of secret types to exclude from the results. All default secret patterns are returned except those matching the specified types. Cannot be combined with the secret\_type parameter. See "Supported secret scanning patterns" for a complete list of secret types.
297
+
298
+ * **`exclude_providers`** (string)
299
+ A comma-separated list of provider slugs to exclude from the results.
300
+ Provider slugs use lowercase with underscores (e.g., github\_secret\_scanning, clojars).
301
+ You can find the provider slug in the provider\_slug field of each alert.
302
+ Cannot be combined with the providers parameter.
303
+
304
+ * **`providers`** (string)
305
+ A comma-separated list of provider slugs to filter by.
306
+ Provider slugs use lowercase with underscores (e.g., github\_secret\_scanning, clojars).
307
+ You can find the provider slug in the provider\_slug field of each alert.
308
+ Cannot be combined with the exclude\_providers parameter.
309
+
310
+ * **`resolution`** (string)
311
+ A comma-separated list of resolutions. Only secret scanning alerts with one of these resolutions are listed. Valid resolutions are false\_positive, wont\_fix, revoked, pattern\_edited, pattern\_deleted or used\_in\_tests.
312
+
313
+ * **`assignee`** (string)
314
+ Filters alerts by assignee. Use \* to get all assigned alerts, none to get all unassigned alerts, or a GitHub username to get alerts assigned to a specific user.
315
+
316
+ * **`sort`** (string)
317
+ The property to sort the results by. created means when the alert was created. updated means when the alert was updated or resolved.
318
+ Default: `created`
319
+ Can be one of: `created`, `updated`
320
+
321
+ * **`direction`** (string)
322
+ The direction to sort the results by.
323
+ Default: `desc`
324
+ Can be one of: `asc`, `desc`
325
+
326
+ * **`page`** (integer)
327
+ The page number of the results to fetch. For more information, see "Using pagination in the REST API."
328
+ Default: `1`
329
+
330
+ * **`per_page`** (integer)
331
+ The number of results per page (max 100). For more information, see "Using pagination in the REST API."
332
+ Default: `30`
333
+
334
+ * **`before`** (string)
335
+ A cursor, as given in the Link header. If specified, the query only searches for events before this cursor. To receive an initial cursor on your first request, include an empty "before" query string.
336
+
337
+ * **`after`** (string)
338
+ A cursor, as given in the Link header. If specified, the query only searches for events after this cursor. To receive an initial cursor on your first request, include an empty "after" query string.
339
+
340
+ * **`validity`** (string)
341
+ A comma-separated list of validities that, when present, will return alerts that match the validities in this list. Valid options are active, inactive, and unknown.
342
+
343
+ * **`is_publicly_leaked`** (boolean)
344
+ A boolean value representing whether or not to filter alerts by the publicly-leaked tag being present.
345
+ Default: `false`
346
+
347
+ * **`is_multi_repo`** (boolean)
348
+ A boolean value representing whether or not to filter alerts by the multi-repo tag being present.
349
+ Default: `false`
350
+
351
+ * **`hide_secret`** (boolean)
352
+ A boolean value representing whether or not to hide literal secrets in the results.
353
+ Default: `false`
354
+
355
+ * **`is_bypassed`** (boolean)
356
+ A boolean value (true or false) indicating whether to filter alerts by their push protection bypass status. When set to true, only alerts that were created because a push protection rule was bypassed will be returned. When set to false, only alerts that were not caused by a push protection bypass will be returned.
357
+
358
+ * **`included_metadata`** (string)
359
+ A comma-separated list of metadata fields to filter alerts by. Only alerts that have all of the
360
+ specified metadata fields attached will be returned. Possible values are: owner-email, owner-id,
361
+ owner-name, secret-id, secret-name, secret-issued-date, secret-expiration-date, organization-name,
362
+ organization-id, last-used-date, and has-organization-access.
363
+
364
+ * **`owner_email_hash`** (string)
365
+ Filters alerts to only those whose attached owner\_email metadata field matches the
366
+ provided value. The value must be the lowercase hex-encoded SHA-256 hash of the email
367
+ address to match (for example, the SHA-256 of <user@example.com>). Only alerts that
368
+ have an owner\_email metadata value whose SHA-256 hash equals this parameter are
369
+ returned.
370
+
371
+ ### HTTP response status codes
372
+
373
+ * **200** - OK
374
+
375
+ * **404** - Repository is public or secret scanning is disabled for the repository
376
+
377
+ * **503** - Service unavailable
378
+
379
+ ### Code examples
380
+
381
+ #### Example
382
+
383
+ **Request:**
384
+
385
+ ```curl
386
+ curl -L \
387
+ -X GET \
388
+ https://api.github.com/repos/OWNER/REPO/secret-scanning/alerts
389
+ ```
390
+
391
+ **Response schema (Status: 200):**
392
+
393
+ Array of objects:
394
+
395
+ * `number`: integer, read-only
396
+ * `created_at`: string, format: date-time, read-only
397
+ * `updated_at`: any of:
398
+ * **null**
399
+ * **string, format: date-time, read-only**
400
+ * `url`: string, format: uri, read-only
401
+ * `html_url`: string, format: uri, read-only
402
+ * `locations_url`: string, format: uri
403
+ * `state`: string, enum: `open`, `resolved`
404
+ * `resolution`: string or null, enum: `false_positive`, `wont_fix`, `revoked`, `used_in_tests`, `null`
405
+ * `resolved_at`: string or null, format: date-time
406
+ * `resolved_by`: any of:
407
+ * **null**
408
+ * **Simple User**
409
+ * `name`: string or null
410
+ * `email`: string or null
411
+ * `login`: required, string
412
+ * `id`: required, integer, format: int64
413
+ * `node_id`: required, string
414
+ * `avatar_url`: required, string, format: uri
415
+ * `gravatar_id`: required, string or null
416
+ * `url`: required, string, format: uri
417
+ * `html_url`: required, string, format: uri
418
+ * `followers_url`: required, string, format: uri
419
+ * `following_url`: required, string
420
+ * `gists_url`: required, string
421
+ * `starred_url`: required, string
422
+ * `subscriptions_url`: required, string, format: uri
423
+ * `organizations_url`: required, string, format: uri
424
+ * `repos_url`: required, string, format: uri
425
+ * `events_url`: required, string
426
+ * `received_events_url`: required, string, format: uri
427
+ * `type`: required, string
428
+ * `site_admin`: required, boolean
429
+ * `starred_at`: string
430
+ * `user_view_type`: string
431
+ * `resolution_comment`: string or null
432
+ * `secret_type`: string
433
+ * `secret_type_display_name`: string
434
+ * `provider`: string or null
435
+ * `provider_slug`: string or null
436
+ * `secret`: string
437
+ * `push_protection_bypassed`: boolean or null
438
+ * `push_protection_bypassed_by`: any of:
439
+ * **null**
440
+ * **Simple User** (see above)
441
+ * `push_protection_bypassed_at`: string or null, format: date-time
442
+ * `push_protection_bypass_request_reviewer`: any of:
443
+ * **null**
444
+ * **Simple User** (see above)
445
+ * `push_protection_bypass_request_reviewer_comment`: string or null
446
+ * `push_protection_bypass_request_comment`: string or null
447
+ * `push_protection_bypass_request_html_url`: string or null, format: uri
448
+ * `validity`: string, enum: `active`, `inactive`, `unknown`
449
+ * `publicly_leaked`: boolean or null
450
+ * `multi_repo`: boolean or null
451
+ * `is_base64_encoded`: boolean or null
452
+ * `first_location_detected`: any of:
453
+ * **null**
454
+ * **object**
455
+ * `has_more_locations`: boolean
456
+ * `assigned_to`: any of:
457
+ * **null**
458
+ * **Simple User** (see above)
459
+ * `closure_request_comment`: string or null
460
+ * `closure_request_reviewer_comment`: string or null
461
+ * `closure_request_reviewer`: any of:
462
+ * **null**
463
+ * **Simple User** (see above)
464
+
465
+ ## Get a secret scanning alert
466
+
467
+ ```
468
+ GET /repos/{owner}/{repo}/secret-scanning/alerts/{alert_number}
469
+ ```
470
+
471
+ Gets a single secret scanning alert detected in an eligible repository.
472
+ The authenticated user must be an administrator for the repository or for the organization that owns the repository to use this endpoint.
473
+ OAuth app tokens and personal access tokens (classic) need the repo or security\_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public\_repo scope instead.
474
+
475
+ ### Parameters
476
+
477
+ #### Headers
478
+
479
+ * **`accept`** (string)
480
+ Setting to `application/vnd.github+json` is recommended.
481
+
482
+ #### Path and query parameters
483
+
484
+ * **`owner`** (string) (required)
485
+ The account owner of the repository. The name is not case sensitive.
486
+
487
+ * **`repo`** (string) (required)
488
+ The name of the repository without the .git extension. The name is not case sensitive.
489
+
490
+ * **`alert_number`** (integer) (required)
491
+ The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation.
492
+
493
+ * **`hide_secret`** (boolean)
494
+ A boolean value representing whether or not to hide literal secrets in the results.
495
+ Default: `false`
496
+
497
+ ### HTTP response status codes
498
+
499
+ * **200** - OK
500
+
501
+ * **304** - Not modified
502
+
503
+ * **404** - Repository is public, or secret scanning is disabled for the repository, or the resource is not found
504
+
505
+ * **503** - Service unavailable
506
+
507
+ ### Code examples
508
+
509
+ #### Example
510
+
511
+ **Request:**
512
+
513
+ ```curl
514
+ curl -L \
515
+ -X GET \
516
+ https://api.github.com/repos/OWNER/REPO/secret-scanning/alerts/ALERT_NUMBER
517
+ ```
518
+
519
+ **Response schema (Status: 200):**
520
+
521
+ * `number`: integer, read-only
522
+ * `created_at`: string, format: date-time, read-only
523
+ * `updated_at`: any of:
524
+ * **null**
525
+ * **string, format: date-time, read-only**
526
+ * `url`: string, format: uri, read-only
527
+ * `html_url`: string, format: uri, read-only
528
+ * `locations_url`: string, format: uri
529
+ * `state`: string, enum: `open`, `resolved`
530
+ * `resolution`: string or null, enum: `false_positive`, `wont_fix`, `revoked`, `used_in_tests`, `null`
531
+ * `resolved_at`: string or null, format: date-time
532
+ * `resolved_by`: any of:
533
+ * **null**
534
+ * **Simple User**
535
+ * `name`: string or null
536
+ * `email`: string or null
537
+ * `login`: required, string
538
+ * `id`: required, integer, format: int64
539
+ * `node_id`: required, string
540
+ * `avatar_url`: required, string, format: uri
541
+ * `gravatar_id`: required, string or null
542
+ * `url`: required, string, format: uri
543
+ * `html_url`: required, string, format: uri
544
+ * `followers_url`: required, string, format: uri
545
+ * `following_url`: required, string
546
+ * `gists_url`: required, string
547
+ * `starred_url`: required, string
548
+ * `subscriptions_url`: required, string, format: uri
549
+ * `organizations_url`: required, string, format: uri
550
+ * `repos_url`: required, string, format: uri
551
+ * `events_url`: required, string
552
+ * `received_events_url`: required, string, format: uri
553
+ * `type`: required, string
554
+ * `site_admin`: required, boolean
555
+ * `starred_at`: string
556
+ * `user_view_type`: string
557
+ * `resolution_comment`: string or null
558
+ * `secret_type`: string
559
+ * `secret_type_display_name`: string
560
+ * `provider`: string or null
561
+ * `provider_slug`: string or null
562
+ * `secret`: string
563
+ * `push_protection_bypassed`: boolean or null
564
+ * `push_protection_bypassed_by`: any of:
565
+ * **null**
566
+ * **Simple User** (see above)
567
+ * `push_protection_bypassed_at`: string or null, format: date-time
568
+ * `push_protection_bypass_request_reviewer`: any of:
569
+ * **null**
570
+ * **Simple User** (see above)
571
+ * `push_protection_bypass_request_reviewer_comment`: string or null
572
+ * `push_protection_bypass_request_comment`: string or null
573
+ * `push_protection_bypass_request_html_url`: string or null, format: uri
574
+ * `validity`: string, enum: `active`, `inactive`, `unknown`
575
+ * `publicly_leaked`: boolean or null
576
+ * `multi_repo`: boolean or null
577
+ * `is_base64_encoded`: boolean or null
578
+ * `first_location_detected`: any of:
579
+ * **null**
580
+ * **object**
581
+ * `has_more_locations`: boolean
582
+ * `assigned_to`: any of:
583
+ * **null**
584
+ * **Simple User** (see above)
585
+ * `closure_request_comment`: string or null
586
+ * `closure_request_reviewer_comment`: string or null
587
+ * `closure_request_reviewer`: any of:
588
+ * **null**
589
+ * **Simple User** (see above)
590
+ * `metadata`: array of objects:
591
+ * `key`: required, string
592
+ * `value`: required, string
593
+
594
+ ## Update a secret scanning alert
595
+
596
+ ```
597
+ PATCH /repos/{owner}/{repo}/secret-scanning/alerts/{alert_number}
598
+ ```
599
+
600
+ Updates the status of a secret scanning alert in an eligible repository.
601
+ You can also use this endpoint to assign or unassign an alert to a user who has write access to the repository.
602
+ The authenticated user must be an administrator for the repository or for the organization that owns the repository to use this endpoint.
603
+ OAuth app tokens and personal access tokens (classic) need the repo or security\_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public\_repo scope instead.
604
+ Note
605
+
606
+ If delegated alert dismissal is enabled, resolving or reopening an alert also requires write access to the "Secret scanning alert dismissal requests" permission. Granting the permission to the app alone is not sufficient if the token's permissions exclude it.
607
+
608
+ ### Parameters
609
+
610
+ #### Headers
611
+
612
+ * **`accept`** (string)
613
+ Setting to `application/vnd.github+json` is recommended.
614
+
615
+ #### Path and query parameters
616
+
617
+ * **`owner`** (string) (required)
618
+ The account owner of the repository. The name is not case sensitive.
619
+
620
+ * **`repo`** (string) (required)
621
+ The name of the repository without the .git extension. The name is not case sensitive.
622
+
623
+ * **`alert_number`** (integer) (required)
624
+ The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation.
625
+
626
+ #### Body parameters
627
+
628
+ * **`state`** (string)
629
+ Sets the state of the secret scanning alert. You must provide resolution when you set the state to resolved.
630
+ Can be one of: `open`, `resolved`
631
+
632
+ * **`resolution`** (string or null)
633
+ Required when the state is resolved. The reason for resolving the alert.
634
+ Can be one of: `false_positive`, `wont_fix`, `revoked`, `used_in_tests`, `null`
635
+
636
+ * **`resolution_comment`** (string or null)
637
+ An optional comment when closing or reopening an alert. Cannot be updated or deleted.
638
+
639
+ * **`assignee`** (string or null)
640
+ The username of the user to assign to the alert. Set to null to unassign the alert.
641
+
642
+ * **`validity`** (string or null)
643
+ Sets the validity of the secret scanning alert. Can be active, inactive, or null to clear the override.
644
+ Can be one of: `active`, `inactive`, `null`
645
+
646
+ ### HTTP response status codes
647
+
648
+ * **200** - OK
649
+
650
+ * **400** - Bad request, resolution comment is invalid or the resolution was not changed.
651
+
652
+ * **403** - Delegated alert dismissal is enabled and the authenticated user is not a valid reviewer.
653
+
654
+ * **404** - Repository is public, or secret scanning is disabled for the repository, or the resource is not found
655
+
656
+ * **422** - State does not match the resolution or resolution comment, assignee does not have write access to the repository, or the requested validity change could not be applied to this alert
657
+
658
+ * **503** - Service unavailable
659
+
660
+ ### Code examples
661
+
662
+ #### Example
663
+
664
+ **Request:**
665
+
666
+ ```curl
667
+ curl -L \
668
+ -X PATCH \
669
+ https://api.github.com/repos/OWNER/REPO/secret-scanning/alerts/ALERT_NUMBER \
670
+ -d '{
671
+ "state": "resolved",
672
+ "resolution": "false_positive"
673
+ }'
674
+ ```
675
+
676
+ **Response schema (Status: 200):**
677
+
678
+ Same response schema as [Get a secret scanning alert](#get-a-secret-scanning-alert).
679
+
680
+ ## List locations for a secret scanning alert
681
+
682
+ ```
683
+ GET /repos/{owner}/{repo}/secret-scanning/alerts/{alert_number}/locations
684
+ ```
685
+
686
+ Lists all locations for a given secret scanning alert for an eligible repository.
687
+ The authenticated user must be an administrator for the repository or for the organization that owns the repository to use this endpoint.
688
+ OAuth app tokens and personal access tokens (classic) need the repo or security\_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public\_repo scope instead.
689
+
690
+ ### Parameters
691
+
692
+ #### Headers
693
+
694
+ * **`accept`** (string)
695
+ Setting to `application/vnd.github+json` is recommended.
696
+
697
+ #### Path and query parameters
698
+
699
+ * **`owner`** (string) (required)
700
+ The account owner of the repository. The name is not case sensitive.
701
+
702
+ * **`repo`** (string) (required)
703
+ The name of the repository without the .git extension. The name is not case sensitive.
704
+
705
+ * **`alert_number`** (integer) (required)
706
+ The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation.
707
+
708
+ * **`page`** (integer)
709
+ The page number of the results to fetch. For more information, see "Using pagination in the REST API."
710
+ Default: `1`
711
+
712
+ * **`per_page`** (integer)
713
+ The number of results per page (max 100). For more information, see "Using pagination in the REST API."
714
+ Default: `30`
715
+
716
+ ### HTTP response status codes
717
+
718
+ * **200** - OK
719
+
720
+ * **404** - Repository is public, or secret scanning is disabled for the repository, or the resource is not found
721
+
722
+ * **503** - Service unavailable
723
+
724
+ ### Code examples
725
+
726
+ #### Example
727
+
728
+ **Request:**
729
+
730
+ ```curl
731
+ curl -L \
732
+ -X GET \
733
+ https://api.github.com/repos/OWNER/REPO/secret-scanning/alerts/ALERT_NUMBER/locations
734
+ ```
735
+
736
+ **Response schema (Status: 200):**
737
+
738
+ Array of objects:
739
+
740
+ * `type`: string, enum: `commit`, `wiki_commit`, `issue_title`, `issue_body`, `issue_comment`, `discussion_title`, `discussion_body`, `discussion_comment`, `pull_request_title`, `pull_request_body`, `pull_request_comment`, `pull_request_review`, `pull_request_review_comment`, `actions_log`
741
+ * `details`: any of:
742
+ * **object**
743
+ * `path`: required, string
744
+ * `start_line`: required, number
745
+ * `end_line`: required, number
746
+ * `start_column`: required, number
747
+ * `end_column`: required, number
748
+ * `blob_sha`: required, string
749
+ * `blob_url`: required, string
750
+ * `commit_sha`: required, string
751
+ * `commit_url`: required, string
752
+ * `html_url`: string, format: uri
753
+ * **object**
754
+ * `path`: required, string
755
+ * `start_line`: required, number
756
+ * `end_line`: required, number
757
+ * `start_column`: required, number
758
+ * `end_column`: required, number
759
+ * `blob_sha`: required, string
760
+ * `page_url`: required, string
761
+ * `commit_sha`: required, string
762
+ * `commit_url`: required, string
763
+ * **object**
764
+ * `issue_title_url`: required, string, format: uri
765
+ * `html_url`: string, format: uri
766
+ * **object**
767
+ * `issue_body_url`: required, string, format: uri
768
+ * `html_url`: string, format: uri
769
+ * **object**
770
+ * `issue_comment_url`: required, string, format: uri
771
+ * `html_url`: string, format: uri
772
+ * **object**
773
+ * `discussion_title_url`: required, string, format: uri
774
+ * **object**
775
+ * `discussion_body_url`: required, string, format: uri
776
+ * **object**
777
+ * `discussion_comment_url`: required, string, format: uri
778
+ * **object**
779
+ * `pull_request_title_url`: required, string, format: uri
780
+ * `html_url`: string, format: uri
781
+ * **object**
782
+ * `pull_request_body_url`: required, string, format: uri
783
+ * `html_url`: string, format: uri
784
+ * **object**
785
+ * `pull_request_comment_url`: required, string, format: uri
786
+ * `html_url`: string, format: uri
787
+ * **object**
788
+ * `pull_request_review_url`: required, string, format: uri
789
+ * `html_url`: string, format: uri
790
+ * **object**
791
+ * `pull_request_review_comment_url`: required, string, format: uri
792
+ * `html_url`: string, format: uri
793
+ * **object**
794
+ * `path`: required, string
795
+ * `start_line`: required, number
796
+ * `end_line`: required, number
797
+ * `start_column`: required, number
798
+ * `end_column`: required, number
799
+
800
+ ## Create a push protection bypass
801
+
802
+ ```
803
+ POST /repos/{owner}/{repo}/secret-scanning/push-protection-bypasses
804
+ ```
805
+
806
+ Creates a bypass for a previously push protected secret.
807
+ The authenticated user must be the original author of the committed secret.
808
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint.
809
+
810
+ ### Parameters
811
+
812
+ #### Headers
813
+
814
+ * **`accept`** (string)
815
+ Setting to `application/vnd.github+json` is recommended.
816
+
817
+ #### Path and query parameters
818
+
819
+ * **`owner`** (string) (required)
820
+ The account owner of the repository. The name is not case sensitive.
821
+
822
+ * **`repo`** (string) (required)
823
+ The name of the repository without the .git extension. The name is not case sensitive.
824
+
825
+ #### Body parameters
826
+
827
+ * **`reason`** (string) (required)
828
+ The reason for bypassing push protection.
829
+ Can be one of: `false_positive`, `used_in_tests`, `will_fix_later`
830
+
831
+ * **`placeholder_id`** (string) (required)
832
+ The ID of the push protection bypass placeholder. This value is returned on any push protected routes.
833
+
834
+ ### HTTP response status codes
835
+
836
+ * **200** - OK
837
+
838
+ * **403** - User does not have enough permissions to perform this action.
839
+
840
+ * **404** - Placeholder ID not found, or push protection is disabled on this repository.
841
+
842
+ * **422** - Bad request, input data missing or incorrect.
843
+
844
+ * **503** - Service unavailable
845
+
846
+ ### Code examples
847
+
848
+ #### Example
849
+
850
+ **Request:**
851
+
852
+ ```curl
853
+ curl -L \
854
+ -X POST \
855
+ https://api.github.com/repos/OWNER/REPO/secret-scanning/push-protection-bypasses \
856
+ -d '{
857
+ "reason": "will_fix_later",
858
+ "placeholder_id": "2k4dM4tseyC5lPIsjl5emX9sPNk"
859
+ }'
860
+ ```
861
+
862
+ **Response schema (Status: 200):**
863
+
864
+ * `reason`: string, enum: `false_positive`, `used_in_tests`, `will_fix_later`
865
+ * `expire_at`: string or null, format: date-time
866
+ * `token_type`: string
867
+
868
+ ## Get secret scanning scan history for a repository
869
+
870
+ ```
871
+ GET /repos/{owner}/{repo}/secret-scanning/scan-history
872
+ ```
873
+
874
+ Lists the latest default incremental and backfill scans by type for a repository.
875
+ Note
876
+
877
+ This endpoint requires GitHub Advanced Security.
878
+
879
+ OAuth app tokens and personal access tokens (classic) need the repo or security\_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public\_repo scope instead.
880
+
881
+ ### Parameters
882
+
883
+ #### Headers
884
+
885
+ * **`accept`** (string)
886
+ Setting to `application/vnd.github+json` is recommended.
887
+
888
+ #### Path and query parameters
889
+
890
+ * **`owner`** (string) (required)
891
+ The account owner of the repository. The name is not case sensitive.
892
+
893
+ * **`repo`** (string) (required)
894
+ The name of the repository without the .git extension. The name is not case sensitive.
895
+
896
+ ### HTTP response status codes
897
+
898
+ * **200** - OK
899
+
900
+ * **404** - Repository does not have GitHub Advanced Security or secret scanning enabled
901
+
902
+ * **503** - Service unavailable
903
+
904
+ ### Code examples
905
+
906
+ #### Example
907
+
908
+ **Request:**
909
+
910
+ ```curl
911
+ curl -L \
912
+ -X GET \
913
+ https://api.github.com/repos/OWNER/REPO/secret-scanning/scan-history
914
+ ```
915
+
916
+ **Response schema (Status: 200):**
917
+
918
+ * `incremental_scans`: array of objects:
919
+ * `type`: string
920
+ * `status`: string
921
+ * `completed_at`: string or null, format: date-time
922
+ * `started_at`: string or null, format: date-time
923
+ * `pattern_update_scans`: array of objects:
924
+ * `type`: string
925
+ * `status`: string
926
+ * `completed_at`: string or null, format: date-time
927
+ * `started_at`: string or null, format: date-time
928
+ * `backfill_scans`: array of objects:
929
+ * `type`: string
930
+ * `status`: string
931
+ * `completed_at`: string or null, format: date-time
932
+ * `started_at`: string or null, format: date-time
933
+ * `custom_pattern_backfill_scans`: array of items:
934
+ * all of:
935
+ * **object**
936
+ * `type`: string
937
+ * `status`: string
938
+ * `completed_at`: string or null, format: date-time
939
+ * `started_at`: string or null, format: date-time
940
+ * **object**
941
+ * `pattern_name`: string
942
+ * `pattern_scope`: string
943
+ * `generic_secrets_backfill_scans`: array of objects:
944
+ * `type`: string
945
+ * `status`: string
946
+ * `completed_at`: string or null, format: date-time
947
+ * `started_at`: string or null, format: date-time