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,957 @@
1
+ # REST API endpoints for commits
2
+
3
+ Use the REST API to interact with commits.
4
+
5
+ > [!NOTE]
6
+ > 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.
7
+
8
+ ## List commits
9
+
10
+ ```
11
+ GET /repos/{owner}/{repo}/commits
12
+ ```
13
+
14
+ Signature verification object
15
+ The response will include a verification object that describes the result of verifying the commit's signature. The following fields are included in the verification object:
16
+
17
+ NameTypeDescriptionverifiedbooleanIndicates whether GitHub considers the signature in this commit to be verified.reasonstringThe reason for verified value. Possible values and their meanings are enumerated in table below.signaturestringThe signature that was extracted from the commit.payloadstringThe value that was signed.verified_atstringThe date the signature was verified by GitHub.
18
+ These are the possible values for reason in the verification object:
19
+
20
+ ValueDescriptionexpired_keyThe key that made the signature is expired.not_signing_keyThe "signing" flag is not among the usage flags in the GPG key that made the signature.gpgverify_errorThere was an error communicating with the signature verification service.gpgverify_unavailableThe signature verification service is currently unavailable.unsignedThe object does not include a signature.unknown_signature_typeA non-PGP signature was found in the commit.no_userNo user was associated with the committer email address in the commit.unverified_emailThe committer email address in the commit was associated with a user, but the email address is not verified on their account.bad_emailThe committer email address in the commit is not included in the identities of the PGP key that made the signature.unknown_keyThe key that made the signature has not been registered with any user's account.malformed_signatureThere was an error parsing the signature.invalidThe signature could not be cryptographically verified using the key whose key-id was found in the signature.validNone of the above errors applied, so the signature is considered to be verified.
21
+
22
+ ### Parameters
23
+
24
+ #### Headers
25
+
26
+ - **`accept`** (string)
27
+ Setting to `application/vnd.github+json` is recommended.
28
+
29
+ #### Path and query parameters
30
+
31
+ - **`owner`** (string) (required)
32
+ The account owner of the repository. The name is not case sensitive.
33
+
34
+ - **`repo`** (string) (required)
35
+ The name of the repository without the .git extension. The name is not case sensitive.
36
+
37
+ - **`sha`** (string)
38
+ SHA or branch to start listing commits from. Default: the repository’s default branch (usually main).
39
+
40
+ - **`path`** (string)
41
+ Only commits containing this file path will be returned.
42
+
43
+ - **`author`** (string)
44
+ GitHub username or email address to use to filter by commit author.
45
+
46
+ - **`committer`** (string)
47
+ GitHub username or email address to use to filter by commit committer.
48
+
49
+ - **`since`** (string)
50
+ Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Due to limitations of Git, timestamps must be between 1970-01-01 and 2099-12-31 (inclusive) or unexpected results may be returned.
51
+
52
+ - **`until`** (string)
53
+ Only commits before this date will be returned. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Due to limitations of Git, timestamps must be between 1970-01-01 and 2099-12-31 (inclusive) or unexpected results may be returned.
54
+
55
+ - **`per_page`** (integer)
56
+ The number of results per page (max 100). For more information, see "Using pagination in the REST API."
57
+ Default: `30`
58
+
59
+ - **`page`** (integer)
60
+ The page number of the results to fetch. For more information, see "Using pagination in the REST API."
61
+ Default: `1`
62
+
63
+ ### HTTP response status codes
64
+
65
+ - **200** - OK
66
+
67
+ - **400** - Bad Request
68
+
69
+ - **404** - Resource not found
70
+
71
+ - **409** - Conflict
72
+
73
+ - **422** - Validation failed, or the endpoint has been spammed.
74
+
75
+ - **429** - The request could not be processed due to heavy server load. Please try again.
76
+
77
+ - **500** - Internal Error
78
+
79
+ ### Code examples
80
+
81
+ #### Example
82
+
83
+ **Request:**
84
+
85
+ ```curl
86
+ curl -L \
87
+ -X GET \
88
+ https://api.github.com/repos/OWNER/REPO/commits
89
+ ```
90
+
91
+ **Response schema (Status: 200):**
92
+
93
+ Array of `Commit`:
94
+ * `url`: required, string, format: uri
95
+ * `sha`: required, string
96
+ * `node_id`: required, string
97
+ * `html_url`: required, string, format: uri
98
+ * `comments_url`: required, string, format: uri
99
+ * `commit`: required, object:
100
+ * `url`: required, string, format: uri
101
+ * `author`: required, any of:
102
+ * **null**
103
+ * **Git User**
104
+ * `name`: string
105
+ * `email`: string
106
+ * `date`: string, format: date-time
107
+ * `committer`: required, any of:
108
+ * **null**
109
+ * **Git User** (see above)
110
+ * `message`: required, string
111
+ * `comment_count`: required, integer
112
+ * `tree`: required, object:
113
+ * `sha`: required, string
114
+ * `url`: required, string, format: uri
115
+ * `verification`: `Verification`:
116
+ * `verified`: required, boolean
117
+ * `reason`: required, string
118
+ * `payload`: required, string or null
119
+ * `signature`: required, string or null
120
+ * `verified_at`: required, string or null
121
+ * `author`: required, one of:
122
+ * **Simple User**
123
+ * `name`: string or null
124
+ * `email`: string or null
125
+ * `login`: required, string
126
+ * `id`: required, integer, format: int64
127
+ * `node_id`: required, string
128
+ * `avatar_url`: required, string, format: uri
129
+ * `gravatar_id`: required, string or null
130
+ * `url`: required, string, format: uri
131
+ * `html_url`: required, string, format: uri
132
+ * `followers_url`: required, string, format: uri
133
+ * `following_url`: required, string
134
+ * `gists_url`: required, string
135
+ * `starred_url`: required, string
136
+ * `subscriptions_url`: required, string, format: uri
137
+ * `organizations_url`: required, string, format: uri
138
+ * `repos_url`: required, string, format: uri
139
+ * `events_url`: required, string
140
+ * `received_events_url`: required, string, format: uri
141
+ * `type`: required, string
142
+ * `site_admin`: required, boolean
143
+ * `starred_at`: string
144
+ * `user_view_type`: string
145
+ * **Empty Object**
146
+ * `committer`: required, one of:
147
+ * **Simple User** (see above)
148
+ * **Empty Object** (see above)
149
+ * `parents`: required, array of objects:
150
+ * `sha`: required, string
151
+ * `url`: required, string, format: uri
152
+ * `html_url`: string, format: uri
153
+ * `stats`: object:
154
+ * `additions`: integer
155
+ * `deletions`: integer
156
+ * `total`: integer
157
+ * `files`: array of `Diff Entry`:
158
+ * `sha`: required, string or null
159
+ * `filename`: required, string
160
+ * `status`: required, string, enum: `added`, `removed`, `modified`, `renamed`, `copied`, `changed`, `unchanged`
161
+ * `additions`: required, integer
162
+ * `deletions`: required, integer
163
+ * `changes`: required, integer
164
+ * `blob_url`: required, string, format: uri
165
+ * `raw_url`: required, string, format: uri
166
+ * `contents_url`: required, string, format: uri
167
+ * `patch`: string
168
+ * `previous_filename`: string
169
+
170
+ ## List branches for HEAD commit
171
+
172
+ ```
173
+ GET /repos/{owner}/{repo}/commits/{commit_sha}/branches-where-head
174
+ ```
175
+
176
+ Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see GitHub's products in the GitHub Help documentation.
177
+ Returns all branches where the given commit SHA is the HEAD, or latest commit for the branch.
178
+
179
+ ### Parameters
180
+
181
+ #### Headers
182
+
183
+ - **`accept`** (string)
184
+ Setting to `application/vnd.github+json` is recommended.
185
+
186
+ #### Path and query parameters
187
+
188
+ - **`owner`** (string) (required)
189
+ The account owner of the repository. The name is not case sensitive.
190
+
191
+ - **`repo`** (string) (required)
192
+ The name of the repository without the .git extension. The name is not case sensitive.
193
+
194
+ - **`commit_sha`** (string) (required)
195
+ The SHA of the commit.
196
+
197
+ ### HTTP response status codes
198
+
199
+ - **200** - OK
200
+
201
+ - **409** - Conflict
202
+
203
+ - **422** - Validation failed, or the endpoint has been spammed.
204
+
205
+ ### Code examples
206
+
207
+ #### Example
208
+
209
+ **Request:**
210
+
211
+ ```curl
212
+ curl -L \
213
+ -X GET \
214
+ https://api.github.com/repos/OWNER/REPO/commits/COMMIT_SHA/branches-where-head
215
+ ```
216
+
217
+ **Response schema (Status: 200):**
218
+
219
+ Array of `Branch Short`:
220
+ * `name`: required, string
221
+ * `commit`: required, object:
222
+ * `sha`: required, string
223
+ * `url`: required, string
224
+ * `protected`: required, boolean
225
+
226
+ ## List pull requests associated with a commit
227
+
228
+ ```
229
+ GET /repos/{owner}/{repo}/commits/{commit_sha}/pulls
230
+ ```
231
+
232
+ Lists the merged pull request that introduced the commit to the repository. If the commit is not present in the default branch, it will return merged and open pull requests associated with the commit.
233
+ To list the open or merged pull requests associated with a branch, you can set the commit_sha parameter to the branch name.
234
+
235
+ ### Parameters
236
+
237
+ #### Headers
238
+
239
+ - **`accept`** (string)
240
+ Setting to `application/vnd.github+json` is recommended.
241
+
242
+ #### Path and query parameters
243
+
244
+ - **`owner`** (string) (required)
245
+ The account owner of the repository. The name is not case sensitive.
246
+
247
+ - **`repo`** (string) (required)
248
+ The name of the repository without the .git extension. The name is not case sensitive.
249
+
250
+ - **`commit_sha`** (string) (required)
251
+ The SHA of the commit.
252
+
253
+ - **`per_page`** (integer)
254
+ The number of results per page (max 100). For more information, see "Using pagination in the REST API."
255
+ Default: `30`
256
+
257
+ - **`page`** (integer)
258
+ The page number of the results to fetch. For more information, see "Using pagination in the REST API."
259
+ Default: `1`
260
+
261
+ ### HTTP response status codes
262
+
263
+ - **200** - OK
264
+
265
+ - **409** - Conflict
266
+
267
+ ### Code examples
268
+
269
+ #### Example
270
+
271
+ **Request:**
272
+
273
+ ```curl
274
+ curl -L \
275
+ -X GET \
276
+ https://api.github.com/repos/OWNER/REPO/commits/COMMIT_SHA/pulls
277
+ ```
278
+
279
+ **Response schema (Status: 200):**
280
+
281
+ Array of `Pull Request Simple`:
282
+ * `url`: required, string, format: uri
283
+ * `id`: required, integer, format: int64
284
+ * `node_id`: required, string
285
+ * `html_url`: required, string, format: uri
286
+ * `diff_url`: required, string, format: uri
287
+ * `patch_url`: required, string, format: uri
288
+ * `issue_url`: required, string, format: uri
289
+ * `commits_url`: required, string, format: uri
290
+ * `review_comments_url`: required, string, format: uri
291
+ * `review_comment_url`: required, string
292
+ * `comments_url`: required, string, format: uri
293
+ * `statuses_url`: required, string, format: uri
294
+ * `number`: required, integer
295
+ * `state`: required, string
296
+ * `locked`: required, boolean
297
+ * `title`: required, string
298
+ * `user`: required, any of:
299
+ * **null**
300
+ * **Simple User**
301
+ * `name`: string or null
302
+ * `email`: string or null
303
+ * `login`: required, string
304
+ * `id`: required, integer, format: int64
305
+ * `node_id`: required, string
306
+ * `avatar_url`: required, string, format: uri
307
+ * `gravatar_id`: required, string or null
308
+ * `url`: required, string, format: uri
309
+ * `html_url`: required, string, format: uri
310
+ * `followers_url`: required, string, format: uri
311
+ * `following_url`: required, string
312
+ * `gists_url`: required, string
313
+ * `starred_url`: required, string
314
+ * `subscriptions_url`: required, string, format: uri
315
+ * `organizations_url`: required, string, format: uri
316
+ * `repos_url`: required, string, format: uri
317
+ * `events_url`: required, string
318
+ * `received_events_url`: required, string, format: uri
319
+ * `type`: required, string
320
+ * `site_admin`: required, boolean
321
+ * `starred_at`: string
322
+ * `user_view_type`: string
323
+ * `body`: required, string or null
324
+ * `labels`: required, array of objects:
325
+ * `id`: required, integer, format: int64
326
+ * `node_id`: required, string
327
+ * `url`: required, string
328
+ * `name`: required, string
329
+ * `description`: required, string
330
+ * `color`: required, string
331
+ * `default`: required, boolean
332
+ * `archived_by`: required, all of:
333
+ * **Simple User** (see above)
334
+ * `milestone`: required, any of:
335
+ * **null**
336
+ * **Milestone**
337
+ * `url`: required, string, format: uri
338
+ * `html_url`: required, string, format: uri
339
+ * `labels_url`: required, string, format: uri
340
+ * `id`: required, integer
341
+ * `node_id`: required, string
342
+ * `number`: required, integer
343
+ * `state`: required, string, enum: `open`, `closed`, default: `"open"`
344
+ * `title`: required, string
345
+ * `description`: required, string or null
346
+ * `creator`: required, any of:
347
+ * **null**
348
+ * **Simple User** (see above)
349
+ * `open_issues`: required, integer
350
+ * `closed_issues`: required, integer
351
+ * `created_at`: required, string, format: date-time
352
+ * `updated_at`: required, string, format: date-time
353
+ * `closed_at`: required, string or null, format: date-time
354
+ * `due_on`: required, string or null, format: date-time
355
+ * `active_lock_reason`: string or null
356
+ * `created_at`: required, string, format: date-time
357
+ * `updated_at`: required, string, format: date-time
358
+ * `closed_at`: required, string or null, format: date-time
359
+ * `merged_at`: required, string or null, format: date-time
360
+ * `assignees`: array of `Simple User` (see above)
361
+ * `requested_reviewers`: array of `Simple User` (see above)
362
+ * `requested_teams`: array of `Team`:
363
+ * `id`: required, integer
364
+ * `node_id`: required, string
365
+ * `name`: required, string
366
+ * `slug`: required, string
367
+ * `description`: required, string or null
368
+ * `privacy`: string
369
+ * `notification_setting`: string
370
+ * `permission`: required, string
371
+ * `permissions`: object:
372
+ * `pull`: required, boolean
373
+ * `triage`: required, boolean
374
+ * `push`: required, boolean
375
+ * `maintain`: required, boolean
376
+ * `admin`: required, boolean
377
+ * `url`: required, string, format: uri
378
+ * `html_url`: required, string, format: uri
379
+ * `members_url`: required, string
380
+ * `repositories_url`: required, string, format: uri
381
+ * `type`: required, string, enum: `enterprise`, `organization`
382
+ * `access_source`: string, enum: `direct`, `organization`, `enterprise`
383
+ * `organization_id`: integer
384
+ * `enterprise_id`: integer
385
+ * `parent`: required, any of:
386
+ * **null**
387
+ * **Team Simple**
388
+ * `id`: required, integer
389
+ * `node_id`: required, string
390
+ * `url`: required, string, format: uri
391
+ * `members_url`: required, string
392
+ * `name`: required, string
393
+ * `description`: required, string or null
394
+ * `permission`: required, string
395
+ * `privacy`: string
396
+ * `notification_setting`: string
397
+ * `html_url`: required, string, format: uri
398
+ * `repositories_url`: required, string, format: uri
399
+ * `slug`: required, string
400
+ * `ldap_dn`: string
401
+ * `type`: required, string, enum: `enterprise`, `organization`
402
+ * `organization_id`: integer
403
+ * `enterprise_id`: integer
404
+ * `head`: required, object:
405
+ * `label`: required, string
406
+ * `ref`: required, string
407
+ * `repo`: required, `Repository`:
408
+ * `id`: required, integer, format: int64
409
+ * `node_id`: required, string
410
+ * `name`: required, string
411
+ * `full_name`: required, string
412
+ * `license`: required, any of:
413
+ * **null**
414
+ * **License Simple**
415
+ * `key`: required, string
416
+ * `name`: required, string
417
+ * `url`: required, string or null, format: uri
418
+ * `spdx_id`: required, string or null
419
+ * `node_id`: required, string
420
+ * `html_url`: string, format: uri
421
+ * `forks`: required, integer
422
+ * `permissions`: object:
423
+ * `admin`: required, boolean
424
+ * `pull`: required, boolean
425
+ * `triage`: boolean
426
+ * `push`: required, boolean
427
+ * `maintain`: boolean
428
+ * `owner`: required, `Simple User` (see above)
429
+ * `private`: required, boolean, default: `false`
430
+ * `html_url`: required, string, format: uri
431
+ * `description`: required, string or null
432
+ * `fork`: required, boolean
433
+ * `url`: required, string, format: uri
434
+ * `archive_url`: required, string
435
+ * `assignees_url`: required, string
436
+ * `blobs_url`: required, string
437
+ * `branches_url`: required, string
438
+ * `collaborators_url`: required, string
439
+ * `comments_url`: required, string
440
+ * `commits_url`: required, string
441
+ * `compare_url`: required, string
442
+ * `contents_url`: required, string
443
+ * `contributors_url`: required, string, format: uri
444
+ * `deployments_url`: required, string, format: uri
445
+ * `downloads_url`: required, string, format: uri
446
+ * `events_url`: required, string, format: uri
447
+ * `forks_url`: required, string, format: uri
448
+ * `git_commits_url`: required, string
449
+ * `git_refs_url`: required, string
450
+ * `git_tags_url`: required, string
451
+ * `git_url`: required, string
452
+ * `issue_comment_url`: required, string
453
+ * `issue_events_url`: required, string
454
+ * `issues_url`: required, string
455
+ * `keys_url`: required, string
456
+ * `labels_url`: required, string
457
+ * `languages_url`: required, string, format: uri
458
+ * `merges_url`: required, string, format: uri
459
+ * `milestones_url`: required, string
460
+ * `notifications_url`: required, string
461
+ * `pulls_url`: required, string
462
+ * `releases_url`: required, string
463
+ * `ssh_url`: required, string
464
+ * `stargazers_url`: required, string, format: uri
465
+ * `statuses_url`: required, string
466
+ * `subscribers_url`: required, string, format: uri
467
+ * `subscription_url`: required, string, format: uri
468
+ * `tags_url`: required, string, format: uri
469
+ * `teams_url`: required, string, format: uri
470
+ * `trees_url`: required, string
471
+ * `clone_url`: required, string
472
+ * `mirror_url`: required, string or null, format: uri
473
+ * `hooks_url`: required, string, format: uri
474
+ * `svn_url`: required, string, format: uri
475
+ * `homepage`: required, string or null, format: uri
476
+ * `language`: required, string or null
477
+ * `forks_count`: required, integer
478
+ * `stargazers_count`: required, integer
479
+ * `watchers_count`: required, integer
480
+ * `size`: required, integer
481
+ * `default_branch`: required, string
482
+ * `open_issues_count`: required, integer
483
+ * `is_template`: boolean, default: `false`
484
+ * `topics`: array of string
485
+ * `has_issues`: required, boolean, default: `true`
486
+ * `has_projects`: required, boolean, default: `true`
487
+ * `has_wiki`: required, boolean, default: `true`
488
+ * `has_pages`: required, boolean
489
+ * `has_discussions`: boolean, default: `false`
490
+ * `has_pull_requests`: boolean, default: `true`
491
+ * `pull_request_creation_policy`: string, enum: `all`, `collaborators_only`
492
+ * `archived`: required, boolean, default: `false`
493
+ * `disabled`: required, boolean
494
+ * `visibility`: string, default: `"public"`
495
+ * `pushed_at`: required, string or null, format: date-time
496
+ * `created_at`: required, string or null, format: date-time
497
+ * `updated_at`: required, string or null, format: date-time
498
+ * `allow_rebase_merge`: boolean, default: `true`
499
+ * `temp_clone_token`: string
500
+ * `allow_squash_merge`: boolean, default: `true`
501
+ * `allow_auto_merge`: boolean, default: `false`
502
+ * `delete_branch_on_merge`: boolean, default: `false`
503
+ * `allow_update_branch`: boolean, default: `false`
504
+ * `squash_merge_commit_title`: string, enum: `PR_TITLE`, `COMMIT_OR_PR_TITLE`
505
+ * `squash_merge_commit_message`: string, enum: `PR_BODY`, `COMMIT_MESSAGES`, `BLANK`
506
+ * `merge_commit_title`: string, enum: `PR_TITLE`, `MERGE_MESSAGE`
507
+ * `merge_commit_message`: string, enum: `PR_BODY`, `PR_TITLE`, `BLANK`
508
+ * `allow_merge_commit`: boolean, default: `true`
509
+ * `allow_forking`: boolean
510
+ * `web_commit_signoff_required`: boolean, default: `false`
511
+ * `open_issues`: required, integer
512
+ * `watchers`: required, integer
513
+ * `starred_at`: string
514
+ * `anonymous_access_enabled`: boolean
515
+ * `code_search_index_status`: object:
516
+ * `lexical_search_ok`: boolean
517
+ * `lexical_commit_sha`: string
518
+ * `sha`: required, string
519
+ * `user`: required, any of:
520
+ * **null**
521
+ * **Simple User** (see above)
522
+ * `base`: required, object:
523
+ * `label`: required, string
524
+ * `ref`: required, string
525
+ * `repo`: required, `Repository` (see above)
526
+ * `sha`: required, string
527
+ * `user`: required, any of:
528
+ * **null**
529
+ * **Simple User** (see above)
530
+ * `_links`: required, object:
531
+ * `comments`: required, `Link`:
532
+ * `href`: required, string
533
+ * `commits`: required, `Link` (see above)
534
+ * `statuses`: required, `Link` (see above)
535
+ * `html`: required, `Link` (see above)
536
+ * `issue`: required, `Link` (see above)
537
+ * `review_comments`: required, `Link` (see above)
538
+ * `review_comment`: required, `Link` (see above)
539
+ * `self`: required, `Link` (see above)
540
+ * `author_association`: required, string, enum: `COLLABORATOR`, `CONTRIBUTOR`, `FIRST_TIMER`, `FIRST_TIME_CONTRIBUTOR`, `MANNEQUIN`, `MEMBER`, `NONE`, `OWNER`
541
+ * `auto_merge`: required, `Auto merge`:
542
+ * `enabled_by`: required, `Simple User` (see above)
543
+ * `merge_method`: required, string, enum: `merge`, `squash`, `rebase`
544
+ * `commit_title`: required, string
545
+ * `commit_message`: required, string
546
+ * `stack`: `Pull Request Stack`:
547
+ * `base`: required, object:
548
+ * `ref`: required, string
549
+ * `sha`: required, string
550
+ * `size`: integer
551
+ * `position`: integer
552
+ * `id`: integer
553
+ * `number`: integer
554
+ * `draft`: boolean
555
+
556
+ ## Get a commit
557
+
558
+ ```
559
+ GET /repos/{owner}/{repo}/commits/{ref}
560
+ ```
561
+
562
+ Returns the contents of a single commit reference. You must have read access for the repository to use this endpoint.
563
+ Note
564
+
565
+ If there are more than 300 files in the commit diff and the default JSON media type is requested, the response will include pagination link headers for the remaining files, up to a limit of 3000 files. Each page contains the static commit information, and the only changes are to the file listing.
566
+
567
+ This endpoint supports the following custom media types. For more information, see "Media types." Pagination query parameters are not supported for these media types.
568
+
569
+ application/vnd.github.diff: Returns the diff of the commit. Larger diffs may time out and return a 5xx status code.
570
+ application/vnd.github.patch: Returns the patch of the commit. Diffs with binary data will have no patch property. Larger diffs may time out and return a 5xx status code.
571
+ application/vnd.github.sha: Returns the commit's SHA-1 hash. You can use this endpoint to check if a remote reference's SHA-1 hash is the same as your local reference's SHA-1 hash by providing the local SHA-1 reference as the ETag.
572
+
573
+ Signature verification object
574
+ The response will include a verification object that describes the result of verifying the commit's signature. The following fields are included in the verification object:
575
+
576
+ NameTypeDescriptionverifiedbooleanIndicates whether GitHub considers the signature in this commit to be verified.reasonstringThe reason for verified value. Possible values and their meanings are enumerated in table below.signaturestringThe signature that was extracted from the commit.payloadstringThe value that was signed.verified_atstringThe date the signature was verified by GitHub.
577
+ These are the possible values for reason in the verification object:
578
+
579
+ ValueDescriptionexpired_keyThe key that made the signature is expired.not_signing_keyThe "signing" flag is not among the usage flags in the GPG key that made the signature.gpgverify_errorThere was an error communicating with the signature verification service.gpgverify_unavailableThe signature verification service is currently unavailable.unsignedThe object does not include a signature.unknown_signature_typeA non-PGP signature was found in the commit.no_userNo user was associated with the committer email address in the commit.unverified_emailThe committer email address in the commit was associated with a user, but the email address is not verified on their account.bad_emailThe committer email address in the commit is not included in the identities of the PGP key that made the signature.unknown_keyThe key that made the signature has not been registered with any user's account.malformed_signatureThere was an error parsing the signature.invalidThe signature could not be cryptographically verified using the key whose key-id was found in the signature.validNone of the above errors applied, so the signature is considered to be verified.
580
+
581
+ ### Parameters
582
+
583
+ #### Headers
584
+
585
+ - **`accept`** (string)
586
+ Setting to `application/vnd.github+json` is recommended.
587
+
588
+ #### Path and query parameters
589
+
590
+ - **`owner`** (string) (required)
591
+ The account owner of the repository. The name is not case sensitive.
592
+
593
+ - **`repo`** (string) (required)
594
+ The name of the repository without the .git extension. The name is not case sensitive.
595
+
596
+ - **`page`** (integer)
597
+ The page number of the results to fetch. For more information, see "Using pagination in the REST API."
598
+ Default: `1`
599
+
600
+ - **`per_page`** (integer)
601
+ The number of results per page (max 100). For more information, see "Using pagination in the REST API."
602
+ Default: `30`
603
+
604
+ - **`ref`** (string) (required)
605
+ The commit reference. Can be a commit SHA, branch name (heads/BRANCH_NAME), or tag name (tags/TAG_NAME). For more information, see "Git References" in the Git documentation.
606
+
607
+ ### HTTP response status codes
608
+
609
+ - **200** - OK
610
+
611
+ - **404** - Resource not found
612
+
613
+ - **409** - Conflict
614
+
615
+ - **422** - Validation failed, or the endpoint has been spammed.
616
+
617
+ - **429** - The request could not be processed due to heavy server load. Please try again.
618
+
619
+ - **500** - Internal Error
620
+
621
+ - **503** - Service unavailable
622
+
623
+ ### Code examples
624
+
625
+ #### Example 1: Status Code 200
626
+
627
+ **Request:**
628
+
629
+ ```curl
630
+ curl -L \
631
+ -X GET \
632
+ https://api.github.com/repos/OWNER/REPO/commits/REF
633
+ ```
634
+
635
+ **Response schema (Status: 200):**
636
+
637
+ * `url`: required, string, format: uri
638
+ * `sha`: required, string
639
+ * `node_id`: required, string
640
+ * `html_url`: required, string, format: uri
641
+ * `comments_url`: required, string, format: uri
642
+ * `commit`: required, object:
643
+ * `url`: required, string, format: uri
644
+ * `author`: required, any of:
645
+ * **null**
646
+ * **Git User**
647
+ * `name`: string
648
+ * `email`: string
649
+ * `date`: string, format: date-time
650
+ * `committer`: required, any of:
651
+ * **null**
652
+ * **Git User** (see above)
653
+ * `message`: required, string
654
+ * `comment_count`: required, integer
655
+ * `tree`: required, object:
656
+ * `sha`: required, string
657
+ * `url`: required, string, format: uri
658
+ * `verification`: `Verification`:
659
+ * `verified`: required, boolean
660
+ * `reason`: required, string
661
+ * `payload`: required, string or null
662
+ * `signature`: required, string or null
663
+ * `verified_at`: required, string or null
664
+ * `author`: required, one of:
665
+ * **Simple User**
666
+ * `name`: string or null
667
+ * `email`: string or null
668
+ * `login`: required, string
669
+ * `id`: required, integer, format: int64
670
+ * `node_id`: required, string
671
+ * `avatar_url`: required, string, format: uri
672
+ * `gravatar_id`: required, string or null
673
+ * `url`: required, string, format: uri
674
+ * `html_url`: required, string, format: uri
675
+ * `followers_url`: required, string, format: uri
676
+ * `following_url`: required, string
677
+ * `gists_url`: required, string
678
+ * `starred_url`: required, string
679
+ * `subscriptions_url`: required, string, format: uri
680
+ * `organizations_url`: required, string, format: uri
681
+ * `repos_url`: required, string, format: uri
682
+ * `events_url`: required, string
683
+ * `received_events_url`: required, string, format: uri
684
+ * `type`: required, string
685
+ * `site_admin`: required, boolean
686
+ * `starred_at`: string
687
+ * `user_view_type`: string
688
+ * **Empty Object**
689
+ * `committer`: required, one of:
690
+ * **Simple User** (see above)
691
+ * **Empty Object** (see above)
692
+ * `parents`: required, array of objects:
693
+ * `sha`: required, string
694
+ * `url`: required, string, format: uri
695
+ * `html_url`: string, format: uri
696
+ * `stats`: object:
697
+ * `additions`: integer
698
+ * `deletions`: integer
699
+ * `total`: integer
700
+ * `files`: array of `Diff Entry`:
701
+ * `sha`: required, string or null
702
+ * `filename`: required, string
703
+ * `status`: required, string, enum: `added`, `removed`, `modified`, `renamed`, `copied`, `changed`, `unchanged`
704
+ * `additions`: required, integer
705
+ * `deletions`: required, integer
706
+ * `changes`: required, integer
707
+ * `blob_url`: required, string, format: uri
708
+ * `raw_url`: required, string, format: uri
709
+ * `contents_url`: required, string, format: uri
710
+ * `patch`: string
711
+ * `previous_filename`: string
712
+
713
+ #### Example 2: Status Code 200
714
+
715
+ **Request:**
716
+
717
+ ```curl
718
+ curl -L \
719
+ -X GET \
720
+ https://api.github.com/repos/OWNER/REPO/commits/REF \
721
+ -H "Accept: application/vnd.github.diff"
722
+ ```
723
+
724
+ **Response schema (Status: 200):**
725
+
726
+ string
727
+
728
+ #### Example 3: Status Code 200
729
+
730
+ **Request:**
731
+
732
+ ```curl
733
+ curl -L \
734
+ -X GET \
735
+ https://api.github.com/repos/OWNER/REPO/commits/REF \
736
+ -H "Accept: application/vnd.github.patch"
737
+ ```
738
+
739
+ **Response schema (Status: 200):**
740
+
741
+ string
742
+
743
+ #### Example 4: Status Code 200
744
+
745
+ **Request:**
746
+
747
+ ```curl
748
+ curl -L \
749
+ -X GET \
750
+ https://api.github.com/repos/OWNER/REPO/commits/REF \
751
+ -H "Accept: application/vnd.github.sha"
752
+ ```
753
+
754
+ **Response schema (Status: 200):**
755
+
756
+ string
757
+
758
+ ## Compare two commits
759
+
760
+ ```
761
+ GET /repos/{owner}/{repo}/compare/{basehead}
762
+ ```
763
+
764
+ Compares two commits against one another. You can compare refs (branches or tags) and commit SHAs in the same repository, or you can compare refs and commit SHAs that exist in different repositories within the same repository network, including fork branches. For more information about how to view a repository's network, see "Understanding connections between repositories."
765
+ This endpoint is equivalent to running the git log BASE..HEAD command, but it returns commits in a different order. The git log BASE..HEAD command returns commits in reverse chronological order, whereas the API returns commits in chronological order.
766
+ This endpoint supports the following custom media types. For more information, see "Media types."
767
+
768
+ application/vnd.github.diff: Returns the diff of the commit.
769
+ application/vnd.github.patch: Returns the patch of the commit. Diffs with binary data will have no patch property.
770
+
771
+ The API response includes details about the files that were changed between the two commits. This includes the status of the change (if a file was added, removed, modified, or renamed), and details of the change itself. For example, files with a renamed status have a previous_filename field showing the previous filename of the file, and files with a modified status have a patch field showing the changes made to the file.
772
+ When calling this endpoint without any paging parameter (per_page or page), the returned list is limited to 250 commits, and the last commit in the list is the most recent of the entire comparison.
773
+ Working with large comparisons
774
+ To process a response with a large number of commits, use a query parameter (per_page or page) to paginate the results. When using pagination:
775
+
776
+ The list of changed files is only shown on the first page of results, and it includes up to 300 changed files for the entire comparison.
777
+ The results are returned in chronological order, but the last commit in the returned list may not be the most recent one in the entire set if there are more pages of results.
778
+
779
+ For more information on working with pagination, see "Using pagination in the REST API."
780
+ Signature verification object
781
+ The response will include a verification object that describes the result of verifying the commit's signature. The verification object includes the following fields:
782
+
783
+ NameTypeDescriptionverifiedbooleanIndicates whether GitHub considers the signature in this commit to be verified.reasonstringThe reason for verified value. Possible values and their meanings are enumerated in table below.signaturestringThe signature that was extracted from the commit.payloadstringThe value that was signed.verified_atstringThe date the signature was verified by GitHub.
784
+ These are the possible values for reason in the verification object:
785
+
786
+ ValueDescriptionexpired_keyThe key that made the signature is expired.not_signing_keyThe "signing" flag is not among the usage flags in the GPG key that made the signature.gpgverify_errorThere was an error communicating with the signature verification service.gpgverify_unavailableThe signature verification service is currently unavailable.unsignedThe object does not include a signature.unknown_signature_typeA non-PGP signature was found in the commit.no_userNo user was associated with the committer email address in the commit.unverified_emailThe committer email address in the commit was associated with a user, but the email address is not verified on their account.bad_emailThe committer email address in the commit is not included in the identities of the PGP key that made the signature.unknown_keyThe key that made the signature has not been registered with any user's account.malformed_signatureThere was an error parsing the signature.invalidThe signature could not be cryptographically verified using the key whose key-id was found in the signature.validNone of the above errors applied, so the signature is considered to be verified.
787
+
788
+ ### Parameters
789
+
790
+ #### Headers
791
+
792
+ - **`accept`** (string)
793
+ Setting to `application/vnd.github+json` is recommended.
794
+
795
+ #### Path and query parameters
796
+
797
+ - **`owner`** (string) (required)
798
+ The account owner of the repository. The name is not case sensitive.
799
+
800
+ - **`repo`** (string) (required)
801
+ The name of the repository without the .git extension. The name is not case sensitive.
802
+
803
+ - **`page`** (integer)
804
+ The page number of the results to fetch. For more information, see "Using pagination in the REST API."
805
+ Default: `1`
806
+
807
+ - **`per_page`** (integer)
808
+ The number of results per page (max 100). For more information, see "Using pagination in the REST API."
809
+ Default: `30`
810
+
811
+ - **`basehead`** (string) (required)
812
+ The base branch and head branch to compare. This parameter expects the format BASE...HEAD. Both must be branch names in repo. To compare with a branch that exists in a different repository in the same network as repo, the basehead parameter expects the format USERNAME:BASE...USERNAME:HEAD.
813
+
814
+ ### HTTP response status codes
815
+
816
+ - **200** - OK
817
+
818
+ - **404** - Resource not found
819
+
820
+ - **422** - Validation failed, or the endpoint has been spammed.
821
+
822
+ - **500** - Internal Error
823
+
824
+ - **503** - Service unavailable
825
+
826
+ ### Code examples
827
+
828
+ #### Example 1: Status Code 200
829
+
830
+ **Request:**
831
+
832
+ ```curl
833
+ curl -L \
834
+ -X GET \
835
+ https://api.github.com/repos/OWNER/REPO/compare/BASEHEAD
836
+ ```
837
+
838
+ **Response schema (Status: 200):**
839
+
840
+ * `url`: required, string, format: uri
841
+ * `html_url`: required, string, format: uri
842
+ * `permalink_url`: required, string, format: uri
843
+ * `diff_url`: required, string, format: uri
844
+ * `patch_url`: required, string, format: uri
845
+ * `base_commit`: required, `Commit`:
846
+ * `url`: required, string, format: uri
847
+ * `sha`: required, string
848
+ * `node_id`: required, string
849
+ * `html_url`: required, string, format: uri
850
+ * `comments_url`: required, string, format: uri
851
+ * `commit`: required, object:
852
+ * `url`: required, string, format: uri
853
+ * `author`: required, any of:
854
+ * **null**
855
+ * **Git User**
856
+ * `name`: string
857
+ * `email`: string
858
+ * `date`: string, format: date-time
859
+ * `committer`: required, any of:
860
+ * **null**
861
+ * **Git User** (see above)
862
+ * `message`: required, string
863
+ * `comment_count`: required, integer
864
+ * `tree`: required, object:
865
+ * `sha`: required, string
866
+ * `url`: required, string, format: uri
867
+ * `verification`: `Verification`:
868
+ * `verified`: required, boolean
869
+ * `reason`: required, string
870
+ * `payload`: required, string or null
871
+ * `signature`: required, string or null
872
+ * `verified_at`: required, string or null
873
+ * `author`: required, one of:
874
+ * **Simple User**
875
+ * `name`: string or null
876
+ * `email`: string or null
877
+ * `login`: required, string
878
+ * `id`: required, integer, format: int64
879
+ * `node_id`: required, string
880
+ * `avatar_url`: required, string, format: uri
881
+ * `gravatar_id`: required, string or null
882
+ * `url`: required, string, format: uri
883
+ * `html_url`: required, string, format: uri
884
+ * `followers_url`: required, string, format: uri
885
+ * `following_url`: required, string
886
+ * `gists_url`: required, string
887
+ * `starred_url`: required, string
888
+ * `subscriptions_url`: required, string, format: uri
889
+ * `organizations_url`: required, string, format: uri
890
+ * `repos_url`: required, string, format: uri
891
+ * `events_url`: required, string
892
+ * `received_events_url`: required, string, format: uri
893
+ * `type`: required, string
894
+ * `site_admin`: required, boolean
895
+ * `starred_at`: string
896
+ * `user_view_type`: string
897
+ * **Empty Object**
898
+ * `committer`: required, one of:
899
+ * **Simple User** (see above)
900
+ * **Empty Object** (see above)
901
+ * `parents`: required, array of objects:
902
+ * `sha`: required, string
903
+ * `url`: required, string, format: uri
904
+ * `html_url`: string, format: uri
905
+ * `stats`: object:
906
+ * `additions`: integer
907
+ * `deletions`: integer
908
+ * `total`: integer
909
+ * `files`: array of `Diff Entry`:
910
+ * `sha`: required, string or null
911
+ * `filename`: required, string
912
+ * `status`: required, string, enum: `added`, `removed`, `modified`, `renamed`, `copied`, `changed`, `unchanged`
913
+ * `additions`: required, integer
914
+ * `deletions`: required, integer
915
+ * `changes`: required, integer
916
+ * `blob_url`: required, string, format: uri
917
+ * `raw_url`: required, string, format: uri
918
+ * `contents_url`: required, string, format: uri
919
+ * `patch`: string
920
+ * `previous_filename`: string
921
+ * `merge_base_commit`: required, `Commit` (see above)
922
+ * `status`: required, string, enum: `diverged`, `ahead`, `behind`, `identical`
923
+ * `ahead_by`: required, integer
924
+ * `behind_by`: required, integer
925
+ * `total_commits`: required, integer
926
+ * `commits`: required, array of `Commit` (see above)
927
+ * `files`: array of `Diff Entry` (see above)
928
+
929
+ #### Example 2: Status Code 200
930
+
931
+ **Request:**
932
+
933
+ ```curl
934
+ curl -L \
935
+ -X GET \
936
+ https://api.github.com/repos/OWNER/REPO/compare/BASEHEAD \
937
+ -H "Accept: application/vnd.github.diff"
938
+ ```
939
+
940
+ **Response schema (Status: 200):**
941
+
942
+ Same response schema as [Get a commit](#get-a-commit).
943
+
944
+ #### Example 3: Status Code 200
945
+
946
+ **Request:**
947
+
948
+ ```curl
949
+ curl -L \
950
+ -X GET \
951
+ https://api.github.com/repos/OWNER/REPO/compare/BASEHEAD \
952
+ -H "Accept: application/vnd.github.patch"
953
+ ```
954
+
955
+ **Response schema (Status: 200):**
956
+
957
+ Same response schema as [Get a commit](#get-a-commit).