@vodailoc/kilo-kit-mcp 1.1.0 → 1.1.1

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 (570) hide show
  1. package/.mcp/kilo-kit.codex-windows.toml +5 -0
  2. package/LICENSE +190 -190
  3. package/QUICKSTART.md +265 -255
  4. package/README.md +290 -266
  5. package/mcp/README.md +29 -5
  6. package/mcp/dist/server.js +1 -1
  7. package/mcp/package.json +1 -2
  8. package/package.json +3 -2
  9. package/skills/README.md +647 -647
  10. package/skills/SKILLS_INDEX.md +139 -139
  11. package/skills/ai-media/ai-multimodal/.env.example +97 -97
  12. package/skills/ai-media/ai-multimodal/SKILL.md +357 -357
  13. package/skills/ai-media/ai-multimodal/references/audio-processing.md +373 -373
  14. package/skills/ai-media/ai-multimodal/references/image-generation.md +558 -558
  15. package/skills/ai-media/ai-multimodal/references/video-analysis.md +502 -502
  16. package/skills/ai-media/ai-multimodal/references/vision-understanding.md +483 -483
  17. package/skills/ai-media/ai-multimodal/scripts/document_converter.py +395 -395
  18. package/skills/ai-media/ai-multimodal/scripts/gemini_batch_process.py +480 -480
  19. package/skills/ai-media/ai-multimodal/scripts/media_optimizer.py +506 -506
  20. package/skills/ai-media/ai-multimodal/scripts/requirements.txt +26 -26
  21. package/skills/ai-media/ai-multimodal/scripts/tests/requirements.txt +20 -20
  22. package/skills/ai-media/ai-multimodal/scripts/tests/test_document_converter.py +299 -299
  23. package/skills/ai-media/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -362
  24. package/skills/ai-media/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -373
  25. package/skills/ai-media/media-processing/SKILL.md +358 -358
  26. package/skills/ai-media/media-processing/references/ffmpeg-encoding.md +358 -358
  27. package/skills/ai-media/media-processing/references/ffmpeg-filters.md +503 -503
  28. package/skills/ai-media/media-processing/references/ffmpeg-streaming.md +403 -403
  29. package/skills/ai-media/media-processing/references/format-compatibility.md +375 -375
  30. package/skills/ai-media/media-processing/references/imagemagick-batch.md +612 -612
  31. package/skills/ai-media/media-processing/references/imagemagick-editing.md +623 -623
  32. package/skills/ai-media/media-processing/scripts/batch_resize.py +342 -342
  33. package/skills/ai-media/media-processing/scripts/media_convert.py +311 -311
  34. package/skills/ai-media/media-processing/scripts/requirements.txt +24 -24
  35. package/skills/ai-media/media-processing/scripts/tests/requirements.txt +2 -2
  36. package/skills/ai-media/media-processing/scripts/tests/test_batch_resize.py +372 -372
  37. package/skills/ai-media/media-processing/scripts/tests/test_media_convert.py +259 -259
  38. package/skills/ai-media/media-processing/scripts/tests/test_video_optimize.py +397 -397
  39. package/skills/ai-media/media-processing/scripts/video_optimize.py +414 -414
  40. package/skills/ai-media/screenshot/LICENSE.txt +201 -201
  41. package/skills/ai-media/screenshot/SKILL.md +267 -267
  42. package/skills/ai-media/screenshot/agents/openai.yaml +6 -6
  43. package/skills/ai-media/screenshot/assets/screenshot-small.svg +5 -5
  44. package/skills/ai-media/screenshot/scripts/ensure_macos_permissions.sh +54 -54
  45. package/skills/ai-media/screenshot/scripts/macos_display_info.swift +22 -22
  46. package/skills/ai-media/screenshot/scripts/macos_permissions.swift +40 -40
  47. package/skills/ai-media/screenshot/scripts/macos_window_info.swift +126 -126
  48. package/skills/ai-media/screenshot/scripts/take_screenshot.ps1 +163 -163
  49. package/skills/ai-media/screenshot/scripts/take_screenshot.py +585 -585
  50. package/skills/ai-media/sora/LICENSE.txt +201 -201
  51. package/skills/ai-media/sora/SKILL.md +153 -153
  52. package/skills/ai-media/sora/agents/openai.yaml +6 -6
  53. package/skills/ai-media/sora/assets/sora-small.svg +4 -4
  54. package/skills/ai-media/sora/references/cinematic-shots.md +53 -53
  55. package/skills/ai-media/sora/references/cli.md +248 -248
  56. package/skills/ai-media/sora/references/codex-network.md +28 -28
  57. package/skills/ai-media/sora/references/prompting.md +137 -137
  58. package/skills/ai-media/sora/references/sample-prompts.md +95 -95
  59. package/skills/ai-media/sora/references/social-ads.md +42 -42
  60. package/skills/ai-media/sora/references/troubleshooting.md +58 -58
  61. package/skills/ai-media/sora/references/video-api.md +45 -45
  62. package/skills/ai-media/sora/scripts/sora.py +970 -970
  63. package/skills/design/aesthetic/SKILL.md +121 -121
  64. package/skills/design/aesthetic/assets/design-guideline-template.md +163 -163
  65. package/skills/design/aesthetic/assets/design-story-template.md +135 -135
  66. package/skills/design/aesthetic/references/design-principles.md +62 -62
  67. package/skills/design/aesthetic/references/design-resources.md +75 -75
  68. package/skills/design/aesthetic/references/micro-interactions.md +53 -53
  69. package/skills/design/aesthetic/references/storytelling-design.md +50 -50
  70. package/skills/design/figma/LICENSE.txt +202 -202
  71. package/skills/design/figma/SKILL.md +42 -42
  72. package/skills/design/figma/agents/openai.yaml +14 -14
  73. package/skills/design/figma/assets/figma-small.svg +3 -3
  74. package/skills/design/figma/assets/icon.svg +28 -28
  75. package/skills/design/figma/references/figma-mcp-config.md +35 -35
  76. package/skills/design/figma/references/figma-tools-and-prompts.md +34 -34
  77. package/skills/design/figma-implement-design/LICENSE.txt +202 -202
  78. package/skills/design/figma-implement-design/SKILL.md +264 -264
  79. package/skills/design/figma-implement-design/agents/openai.yaml +14 -14
  80. package/skills/design/figma-implement-design/assets/figma-small.svg +3 -3
  81. package/skills/design/figma-implement-design/assets/icon.svg +28 -28
  82. package/skills/design/frontend-design/SKILL.md +41 -41
  83. package/skills/design/frontend-design/references/animejs.md +395 -395
  84. package/skills/design/ui-styling/LICENSE.txt +201 -201
  85. package/skills/design/ui-styling/SKILL.md +321 -321
  86. package/skills/design/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -93
  87. package/skills/design/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -93
  88. package/skills/design/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -93
  89. package/skills/design/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -93
  90. package/skills/design/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -93
  91. package/skills/design/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -93
  92. package/skills/design/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -94
  93. package/skills/design/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -93
  94. package/skills/design/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -93
  95. package/skills/design/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -93
  96. package/skills/design/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -93
  97. package/skills/design/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -93
  98. package/skills/design/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -93
  99. package/skills/design/ui-styling/canvas-fonts/Jura-OFL.txt +93 -93
  100. package/skills/design/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -93
  101. package/skills/design/ui-styling/canvas-fonts/Lora-OFL.txt +93 -93
  102. package/skills/design/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -93
  103. package/skills/design/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -93
  104. package/skills/design/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -93
  105. package/skills/design/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -93
  106. package/skills/design/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -93
  107. package/skills/design/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -93
  108. package/skills/design/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -93
  109. package/skills/design/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -93
  110. package/skills/design/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -93
  111. package/skills/design/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -93
  112. package/skills/design/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -93
  113. package/skills/design/ui-styling/references/canvas-design-system.md +320 -320
  114. package/skills/design/ui-styling/references/shadcn-accessibility.md +471 -471
  115. package/skills/design/ui-styling/references/shadcn-components.md +424 -424
  116. package/skills/design/ui-styling/references/shadcn-theming.md +373 -373
  117. package/skills/design/ui-styling/references/tailwind-customization.md +483 -483
  118. package/skills/design/ui-styling/references/tailwind-responsive.md +382 -382
  119. package/skills/design/ui-styling/references/tailwind-utilities.md +455 -455
  120. package/skills/design/ui-styling/scripts/requirements.txt +17 -17
  121. package/skills/design/ui-styling/scripts/shadcn_add.py +292 -292
  122. package/skills/design/ui-styling/scripts/tailwind_config_gen.py +456 -456
  123. package/skills/design/ui-styling/scripts/tests/requirements.txt +3 -3
  124. package/skills/design/ui-styling/scripts/tests/test_shadcn_add.py +266 -266
  125. package/skills/design/ui-styling/scripts/tests/test_tailwind_config_gen.py +336 -336
  126. package/skills/engineering/aspnet-core/LICENSE.txt +201 -201
  127. package/skills/engineering/aspnet-core/SKILL.md +61 -61
  128. package/skills/engineering/aspnet-core/agents/openai.yaml +5 -5
  129. package/skills/engineering/aspnet-core/references/_sections.md +40 -40
  130. package/skills/engineering/aspnet-core/references/apis-minimal-and-controllers.md +81 -81
  131. package/skills/engineering/aspnet-core/references/data-state-and-services.md +69 -69
  132. package/skills/engineering/aspnet-core/references/program-and-pipeline.md +103 -103
  133. package/skills/engineering/aspnet-core/references/realtime-grpc-and-background-work.md +58 -58
  134. package/skills/engineering/aspnet-core/references/security-and-identity.md +75 -75
  135. package/skills/engineering/aspnet-core/references/source-map.md +43 -43
  136. package/skills/engineering/aspnet-core/references/stack-selection.md +63 -63
  137. package/skills/engineering/aspnet-core/references/testing-performance-and-operations.md +92 -92
  138. package/skills/engineering/aspnet-core/references/ui-blazor.md +53 -53
  139. package/skills/engineering/aspnet-core/references/ui-mvc.md +56 -56
  140. package/skills/engineering/aspnet-core/references/ui-razor-pages.md +55 -55
  141. package/skills/engineering/aspnet-core/references/versioning-and-upgrades.md +51 -51
  142. package/skills/engineering/backend-development/SKILL.md +95 -95
  143. package/skills/engineering/backend-development/references/backend-api-design.md +495 -495
  144. package/skills/engineering/backend-development/references/backend-architecture.md +454 -454
  145. package/skills/engineering/backend-development/references/backend-authentication.md +338 -338
  146. package/skills/engineering/backend-development/references/backend-code-quality.md +659 -659
  147. package/skills/engineering/backend-development/references/backend-debugging.md +904 -904
  148. package/skills/engineering/backend-development/references/backend-devops.md +494 -494
  149. package/skills/engineering/backend-development/references/backend-mindset.md +387 -387
  150. package/skills/engineering/backend-development/references/backend-performance.md +397 -397
  151. package/skills/engineering/backend-development/references/backend-security.md +290 -290
  152. package/skills/engineering/backend-development/references/backend-technologies.md +256 -256
  153. package/skills/engineering/backend-development/references/backend-testing.md +429 -429
  154. package/skills/engineering/better-auth/SKILL.md +204 -204
  155. package/skills/engineering/better-auth/references/advanced-features.md +553 -553
  156. package/skills/engineering/better-auth/references/database-integration.md +577 -577
  157. package/skills/engineering/better-auth/references/email-password-auth.md +416 -416
  158. package/skills/engineering/better-auth/references/oauth-providers.md +430 -430
  159. package/skills/engineering/better-auth/scripts/better_auth_init.py +521 -521
  160. package/skills/engineering/better-auth/scripts/requirements.txt +15 -15
  161. package/skills/engineering/better-auth/scripts/tests/test_better_auth_init.py +421 -421
  162. package/skills/engineering/code-review/SKILL.md +140 -140
  163. package/skills/engineering/code-review/references/code-review-reception.md +208 -208
  164. package/skills/engineering/code-review/references/requesting-code-review.md +104 -104
  165. package/skills/engineering/code-review/references/verification-before-completion.md +138 -138
  166. package/skills/engineering/context-engineering/SKILL.md +86 -86
  167. package/skills/engineering/context-engineering/references/context-compression.md +84 -84
  168. package/skills/engineering/context-engineering/references/context-degradation.md +93 -93
  169. package/skills/engineering/context-engineering/references/context-fundamentals.md +75 -75
  170. package/skills/engineering/context-engineering/references/context-optimization.md +82 -82
  171. package/skills/engineering/context-engineering/references/evaluation.md +89 -89
  172. package/skills/engineering/context-engineering/references/memory-systems.md +88 -88
  173. package/skills/engineering/context-engineering/references/multi-agent-patterns.md +90 -90
  174. package/skills/engineering/context-engineering/references/project-development.md +97 -97
  175. package/skills/engineering/context-engineering/references/tool-design.md +86 -86
  176. package/skills/engineering/context-engineering/scripts/compression_evaluator.py +329 -329
  177. package/skills/engineering/context-engineering/scripts/context_analyzer.py +294 -294
  178. package/skills/engineering/databases/SKILL.md +232 -232
  179. package/skills/engineering/databases/references/mongodb-aggregation.md +447 -447
  180. package/skills/engineering/databases/references/mongodb-atlas.md +465 -465
  181. package/skills/engineering/databases/references/mongodb-crud.md +408 -408
  182. package/skills/engineering/databases/references/mongodb-indexing.md +442 -442
  183. package/skills/engineering/databases/references/postgresql-administration.md +594 -594
  184. package/skills/engineering/databases/references/postgresql-performance.md +527 -527
  185. package/skills/engineering/databases/references/postgresql-psql-cli.md +467 -467
  186. package/skills/engineering/databases/references/postgresql-queries.md +475 -475
  187. package/skills/engineering/databases/scripts/db_backup.py +502 -502
  188. package/skills/engineering/databases/scripts/db_migrate.py +414 -414
  189. package/skills/engineering/databases/scripts/db_performance_check.py +444 -444
  190. package/skills/engineering/databases/scripts/requirements.txt +20 -20
  191. package/skills/engineering/databases/scripts/tests/requirements.txt +4 -4
  192. package/skills/engineering/databases/scripts/tests/test_db_backup.py +340 -340
  193. package/skills/engineering/databases/scripts/tests/test_db_migrate.py +277 -277
  194. package/skills/engineering/databases/scripts/tests/test_db_performance_check.py +370 -370
  195. package/skills/engineering/diagnose/SKILL.md +117 -117
  196. package/skills/engineering/diagnose/scripts/hitl-loop.template.sh +41 -41
  197. package/skills/engineering/docs-seeker/SKILL.md +207 -207
  198. package/skills/engineering/docs-seeker/WORKFLOWS.md +505 -505
  199. package/skills/engineering/docs-seeker/references/best-practices.md +632 -632
  200. package/skills/engineering/docs-seeker/references/documentation-sources.md +461 -461
  201. package/skills/engineering/docs-seeker/references/error-handling.md +621 -621
  202. package/skills/engineering/docs-seeker/references/limitations.md +821 -821
  203. package/skills/engineering/docs-seeker/references/performance.md +574 -574
  204. package/skills/engineering/docs-seeker/references/tool-selection.md +262 -262
  205. package/skills/engineering/frontend-development/SKILL.md +398 -398
  206. package/skills/engineering/frontend-development/resources/common-patterns.md +330 -330
  207. package/skills/engineering/frontend-development/resources/complete-examples.md +871 -871
  208. package/skills/engineering/frontend-development/resources/component-patterns.md +501 -501
  209. package/skills/engineering/frontend-development/resources/data-fetching.md +766 -766
  210. package/skills/engineering/frontend-development/resources/file-organization.md +501 -501
  211. package/skills/engineering/frontend-development/resources/loading-and-error-states.md +500 -500
  212. package/skills/engineering/frontend-development/resources/performance.md +405 -405
  213. package/skills/engineering/frontend-development/resources/routing-guide.md +363 -363
  214. package/skills/engineering/frontend-development/resources/styling-guide.md +427 -427
  215. package/skills/engineering/frontend-development/resources/typescript-standards.md +417 -417
  216. package/skills/engineering/improve-codebase-architecture/DEEPENING.md +37 -37
  217. package/skills/engineering/improve-codebase-architecture/INTERFACE-DESIGN.md +44 -44
  218. package/skills/engineering/improve-codebase-architecture/LANGUAGE.md +53 -53
  219. package/skills/engineering/improve-codebase-architecture/SKILL.md +71 -71
  220. package/skills/engineering/openai-docs/LICENSE.txt +201 -201
  221. package/skills/engineering/openai-docs/SKILL.md +69 -69
  222. package/skills/engineering/openai-docs/agents/openai.yaml +14 -14
  223. package/skills/engineering/openai-docs/assets/openai-small.svg +3 -3
  224. package/skills/engineering/openai-docs/references/gpt-5p4-prompting-guide.md +433 -433
  225. package/skills/engineering/openai-docs/references/latest-model.md +35 -35
  226. package/skills/engineering/openai-docs/references/upgrading-to-gpt-5p4.md +164 -164
  227. package/skills/engineering/playwright/LICENSE.txt +201 -201
  228. package/skills/engineering/playwright/NOTICE.txt +14 -14
  229. package/skills/engineering/playwright/SKILL.md +147 -147
  230. package/skills/engineering/playwright/agents/openai.yaml +6 -6
  231. package/skills/engineering/playwright/assets/playwright-small.svg +3 -3
  232. package/skills/engineering/playwright/references/cli.md +116 -116
  233. package/skills/engineering/playwright/references/workflows.md +95 -95
  234. package/skills/engineering/playwright/scripts/playwright_cli.sh +25 -25
  235. package/skills/engineering/playwright-interactive/LICENSE.txt +201 -201
  236. package/skills/engineering/playwright-interactive/NOTICE.txt +13 -13
  237. package/skills/engineering/playwright-interactive/SKILL.md +689 -689
  238. package/skills/engineering/playwright-interactive/agents/openai.yaml +6 -6
  239. package/skills/engineering/playwright-interactive/assets/playwright-small.svg +3 -3
  240. package/skills/engineering/render-deploy/LICENSE.txt +201 -201
  241. package/skills/engineering/render-deploy/SKILL.md +479 -479
  242. package/skills/engineering/render-deploy/agents/openai.yaml +14 -14
  243. package/skills/engineering/render-deploy/assets/docker.yaml +62 -62
  244. package/skills/engineering/render-deploy/assets/go-api.yaml +35 -35
  245. package/skills/engineering/render-deploy/assets/nextjs-postgres.yaml +35 -35
  246. package/skills/engineering/render-deploy/assets/node-express.yaml +25 -25
  247. package/skills/engineering/render-deploy/assets/python-django.yaml +89 -89
  248. package/skills/engineering/render-deploy/assets/render-small.svg +3 -3
  249. package/skills/engineering/render-deploy/assets/static-site.yaml +54 -54
  250. package/skills/engineering/render-deploy/references/blueprint-spec.md +718 -718
  251. package/skills/engineering/render-deploy/references/codebase-analysis.md +49 -49
  252. package/skills/engineering/render-deploy/references/configuration-guide.md +603 -603
  253. package/skills/engineering/render-deploy/references/deployment-details.md +224 -224
  254. package/skills/engineering/render-deploy/references/direct-creation.md +113 -113
  255. package/skills/engineering/render-deploy/references/error-patterns.md +13 -13
  256. package/skills/engineering/render-deploy/references/post-deploy-checks.md +36 -36
  257. package/skills/engineering/render-deploy/references/runtimes.md +473 -473
  258. package/skills/engineering/render-deploy/references/service-types.md +450 -450
  259. package/skills/engineering/render-deploy/references/troubleshooting-basics.md +36 -36
  260. package/skills/engineering/repomix/SKILL.md +215 -215
  261. package/skills/engineering/repomix/references/configuration.md +211 -211
  262. package/skills/engineering/repomix/references/usage-patterns.md +232 -232
  263. package/skills/engineering/repomix/scripts/README.md +179 -179
  264. package/skills/engineering/repomix/scripts/repomix_batch.py +455 -455
  265. package/skills/engineering/repomix/scripts/repos.example.json +15 -15
  266. package/skills/engineering/repomix/scripts/requirements.txt +15 -15
  267. package/skills/engineering/repomix/scripts/tests/test_repomix_batch.py +531 -531
  268. package/skills/engineering/setup-matt-pocock-skills/SKILL.md +121 -121
  269. package/skills/engineering/setup-matt-pocock-skills/domain.md +51 -51
  270. package/skills/engineering/setup-matt-pocock-skills/issue-tracker-github.md +22 -22
  271. package/skills/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md +23 -23
  272. package/skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md +19 -19
  273. package/skills/engineering/setup-matt-pocock-skills/triage-labels.md +15 -15
  274. package/skills/engineering/shopify/README.md +66 -66
  275. package/skills/engineering/shopify/SKILL.md +319 -319
  276. package/skills/engineering/shopify/references/app-development.md +470 -470
  277. package/skills/engineering/shopify/references/extensions.md +493 -493
  278. package/skills/engineering/shopify/references/themes.md +498 -498
  279. package/skills/engineering/shopify/scripts/requirements.txt +19 -19
  280. package/skills/engineering/shopify/scripts/shopify_init.py +423 -423
  281. package/skills/engineering/shopify/scripts/tests/test_shopify_init.py +385 -385
  282. package/skills/engineering/tdd/SKILL.md +109 -109
  283. package/skills/engineering/tdd/deep-modules.md +33 -33
  284. package/skills/engineering/tdd/interface-design.md +31 -31
  285. package/skills/engineering/tdd/mocking.md +59 -59
  286. package/skills/engineering/tdd/refactoring.md +10 -10
  287. package/skills/engineering/tdd/tests.md +61 -61
  288. package/skills/engineering/to-issues/SKILL.md +81 -81
  289. package/skills/engineering/to-prd/SKILL.md +74 -74
  290. package/skills/engineering/triage/AGENT-BRIEF.md +168 -168
  291. package/skills/engineering/triage/OUT-OF-SCOPE.md +101 -101
  292. package/skills/engineering/triage/SKILL.md +103 -103
  293. package/skills/engineering/web-frameworks/SKILL.md +324 -324
  294. package/skills/engineering/web-frameworks/references/nextjs-app-router.md +465 -465
  295. package/skills/engineering/web-frameworks/references/nextjs-data-fetching.md +459 -459
  296. package/skills/engineering/web-frameworks/references/nextjs-optimization.md +511 -511
  297. package/skills/engineering/web-frameworks/references/nextjs-server-components.md +495 -495
  298. package/skills/engineering/web-frameworks/references/remix-icon-integration.md +603 -603
  299. package/skills/engineering/web-frameworks/references/turborepo-caching.md +551 -551
  300. package/skills/engineering/web-frameworks/references/turborepo-pipelines.md +517 -517
  301. package/skills/engineering/web-frameworks/references/turborepo-setup.md +542 -542
  302. package/skills/engineering/web-frameworks/scripts/nextjs_init.py +547 -547
  303. package/skills/engineering/web-frameworks/scripts/requirements.txt +16 -16
  304. package/skills/engineering/web-frameworks/scripts/tests/requirements.txt +3 -3
  305. package/skills/engineering/web-frameworks/scripts/tests/test_nextjs_init.py +319 -319
  306. package/skills/engineering/web-frameworks/scripts/tests/test_turborepo_migrate.py +374 -374
  307. package/skills/engineering/web-frameworks/scripts/turborepo_migrate.py +394 -394
  308. package/skills/engineering/write-a-skill/SKILL.md +117 -117
  309. package/skills/kilo-kit/SKILL.md +346 -346
  310. package/skills/kilo-kit/_template/SKILL.md +185 -185
  311. package/skills/kilo-kit/debugging/root-cause/SKILL.md +360 -360
  312. package/skills/kilo-kit/debugging/systematic/SKILL.md +339 -339
  313. package/skills/kilo-kit/debugging/verification/SKILL.md +424 -424
  314. package/skills/kilo-kit/development/backend/SKILL.md +540 -540
  315. package/skills/kilo-kit/development/security/SKILL.md +529 -529
  316. package/skills/kilo-kit/quality/code-review/SKILL.md +297 -297
  317. package/skills/kilo-kit/quality/testing/SKILL.md +540 -540
  318. package/skills/kilo-kit/references/output-formats.md +204 -204
  319. package/skills/kilo-kit/references/patterns.md +156 -156
  320. package/skills/kilo-kit/references/performance-benchmarks.md +90 -90
  321. package/skills/operations/chrome-devtools/SKILL.md +392 -392
  322. package/skills/operations/chrome-devtools/references/cdp-domains.md +694 -694
  323. package/skills/operations/chrome-devtools/references/performance-guide.md +940 -940
  324. package/skills/operations/chrome-devtools/references/puppeteer-reference.md +953 -953
  325. package/skills/operations/chrome-devtools/scripts/PERSISTENT-BROWSER.md +107 -107
  326. package/skills/operations/chrome-devtools/scripts/README.md +213 -213
  327. package/skills/operations/chrome-devtools/scripts/__tests__/selector.test.js +210 -210
  328. package/skills/operations/chrome-devtools/scripts/click.js +79 -79
  329. package/skills/operations/chrome-devtools/scripts/close-persistent.js +36 -36
  330. package/skills/operations/chrome-devtools/scripts/console.js +75 -75
  331. package/skills/operations/chrome-devtools/scripts/evaluate.js +49 -49
  332. package/skills/operations/chrome-devtools/scripts/fill.js +72 -72
  333. package/skills/operations/chrome-devtools/scripts/install-deps.sh +181 -181
  334. package/skills/operations/chrome-devtools/scripts/install.sh +83 -83
  335. package/skills/operations/chrome-devtools/scripts/launch-persistent.js +71 -71
  336. package/skills/operations/chrome-devtools/scripts/lib/browser.js +144 -144
  337. package/skills/operations/chrome-devtools/scripts/lib/selector.js +178 -178
  338. package/skills/operations/chrome-devtools/scripts/navigate.js +46 -46
  339. package/skills/operations/chrome-devtools/scripts/network.js +102 -102
  340. package/skills/operations/chrome-devtools/scripts/package-lock.json +1206 -1206
  341. package/skills/operations/chrome-devtools/scripts/package.json +15 -15
  342. package/skills/operations/chrome-devtools/scripts/performance.js +145 -145
  343. package/skills/operations/chrome-devtools/scripts/screenshot.js +180 -180
  344. package/skills/operations/chrome-devtools/scripts/snapshot.js +131 -131
  345. package/skills/operations/devops/.env.example +76 -76
  346. package/skills/operations/devops/SKILL.md +285 -285
  347. package/skills/operations/devops/references/browser-rendering.md +305 -305
  348. package/skills/operations/devops/references/cloudflare-d1-kv.md +123 -123
  349. package/skills/operations/devops/references/cloudflare-platform.md +271 -271
  350. package/skills/operations/devops/references/cloudflare-r2-storage.md +280 -280
  351. package/skills/operations/devops/references/cloudflare-workers-advanced.md +312 -312
  352. package/skills/operations/devops/references/cloudflare-workers-apis.md +309 -309
  353. package/skills/operations/devops/references/cloudflare-workers-basics.md +418 -418
  354. package/skills/operations/devops/references/docker-basics.md +297 -297
  355. package/skills/operations/devops/references/docker-compose.md +292 -292
  356. package/skills/operations/devops/references/gcloud-platform.md +297 -297
  357. package/skills/operations/devops/references/gcloud-services.md +304 -304
  358. package/skills/operations/devops/scripts/cloudflare_deploy.py +269 -269
  359. package/skills/operations/devops/scripts/docker_optimize.py +320 -320
  360. package/skills/operations/devops/scripts/requirements.txt +20 -20
  361. package/skills/operations/devops/scripts/tests/requirements.txt +3 -3
  362. package/skills/operations/devops/scripts/tests/test_cloudflare_deploy.py +285 -285
  363. package/skills/operations/devops/scripts/tests/test_docker_optimize.py +436 -436
  364. package/skills/operations/mcp-builder/LICENSE.txt +201 -201
  365. package/skills/operations/mcp-builder/SKILL.md +328 -328
  366. package/skills/operations/mcp-builder/reference/evaluation.md +601 -601
  367. package/skills/operations/mcp-builder/reference/mcp_best_practices.md +915 -915
  368. package/skills/operations/mcp-builder/reference/node_mcp_server.md +915 -915
  369. package/skills/operations/mcp-builder/reference/python_mcp_server.md +751 -751
  370. package/skills/operations/mcp-builder/scripts/connections.py +151 -151
  371. package/skills/operations/mcp-builder/scripts/evaluation.py +373 -373
  372. package/skills/operations/mcp-builder/scripts/example_evaluation.xml +22 -22
  373. package/skills/operations/mcp-builder/scripts/requirements.txt +2 -2
  374. package/skills/operations/mcp-management/README.md +219 -219
  375. package/skills/operations/mcp-management/SKILL.md +175 -175
  376. package/skills/operations/mcp-management/assets/tools.json +3043 -3043
  377. package/skills/operations/mcp-management/references/configuration.md +114 -114
  378. package/skills/operations/mcp-management/references/gemini-cli-integration.md +201 -201
  379. package/skills/operations/mcp-management/references/mcp-protocol.md +116 -116
  380. package/skills/operations/mcp-management/scripts/.env.example +10 -10
  381. package/skills/operations/mcp-management/scripts/cli.ts +155 -155
  382. package/skills/operations/mcp-management/scripts/dist/analyze-tools.js +70 -70
  383. package/skills/operations/mcp-management/scripts/dist/cli.js +131 -131
  384. package/skills/operations/mcp-management/scripts/dist/mcp-client.js +115 -115
  385. package/skills/operations/mcp-management/scripts/mcp-client.ts +163 -163
  386. package/skills/operations/mcp-management/scripts/package.json +18 -18
  387. package/skills/operations/mcp-management/scripts/tsconfig.json +15 -15
  388. package/skills/problem-solving/collision-zone-thinking/SKILL.md +62 -62
  389. package/skills/problem-solving/defense-in-depth/SKILL.md +130 -130
  390. package/skills/problem-solving/inversion-exercise/SKILL.md +58 -58
  391. package/skills/problem-solving/meta-pattern-recognition/SKILL.md +54 -54
  392. package/skills/problem-solving/root-cause-tracing/SKILL.md +177 -177
  393. package/skills/problem-solving/root-cause-tracing/find-polluter.sh +63 -63
  394. package/skills/problem-solving/scale-game/SKILL.md +63 -63
  395. package/skills/problem-solving/sequential-thinking/README.md +118 -118
  396. package/skills/problem-solving/sequential-thinking/SKILL.md +93 -93
  397. package/skills/problem-solving/sequential-thinking/references/advanced.md +122 -122
  398. package/skills/problem-solving/sequential-thinking/references/examples.md +274 -274
  399. package/skills/problem-solving/simplification-cascades/SKILL.md +76 -76
  400. package/skills/problem-solving/when-stuck/SKILL.md +88 -88
  401. package/skills/productivity/caveman/SKILL.md +49 -49
  402. package/skills/productivity/grill-me/SKILL.md +10 -10
  403. package/skills/productivity/grill-with-docs/ADR-FORMAT.md +47 -47
  404. package/skills/productivity/grill-with-docs/CONTEXT-FORMAT.md +77 -77
  405. package/skills/productivity/grill-with-docs/SKILL.md +88 -88
  406. package/skills/productivity/writing-skills/graphviz-conventions.dot +171 -171
  407. package/skills/productivity/zoom-out/SKILL.md +7 -7
  408. package/skills/writing-docs/doc/LICENSE.txt +201 -201
  409. package/skills/writing-docs/doc/SKILL.md +80 -80
  410. package/skills/writing-docs/doc/agents/openai.yaml +6 -6
  411. package/skills/writing-docs/doc/assets/doc-small.svg +3 -3
  412. package/skills/writing-docs/doc/scripts/render_docx.py +296 -296
  413. package/skills/writing-docs/docx/LICENSE.txt +30 -30
  414. package/skills/writing-docs/docx/SKILL.md +196 -196
  415. package/skills/writing-docs/docx/docx-js.md +349 -349
  416. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -1499
  417. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -146
  418. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -1085
  419. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -11
  420. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -3081
  421. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -23
  422. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -185
  423. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -287
  424. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -1676
  425. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -28
  426. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -144
  427. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -174
  428. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -25
  429. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -18
  430. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -59
  431. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -56
  432. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -195
  433. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -582
  434. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -25
  435. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -4439
  436. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -570
  437. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -509
  438. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -12
  439. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -108
  440. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -96
  441. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -3646
  442. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -116
  443. package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -42
  444. package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -50
  445. package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -49
  446. package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -33
  447. package/skills/writing-docs/docx/ooxml/schemas/mce/mc.xsd +75 -75
  448. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2010.xsd +560 -560
  449. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2012.xsd +67 -67
  450. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2018.xsd +14 -14
  451. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -20
  452. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -13
  453. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -4
  454. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -8
  455. package/skills/writing-docs/docx/ooxml/scripts/pack.py +159 -159
  456. package/skills/writing-docs/docx/ooxml/scripts/unpack.py +29 -29
  457. package/skills/writing-docs/docx/ooxml/scripts/validate.py +69 -69
  458. package/skills/writing-docs/docx/ooxml/scripts/validation/__init__.py +15 -15
  459. package/skills/writing-docs/docx/ooxml/scripts/validation/base.py +951 -951
  460. package/skills/writing-docs/docx/ooxml/scripts/validation/docx.py +274 -274
  461. package/skills/writing-docs/docx/ooxml/scripts/validation/pptx.py +315 -315
  462. package/skills/writing-docs/docx/ooxml/scripts/validation/redlining.py +279 -279
  463. package/skills/writing-docs/docx/ooxml.md +609 -609
  464. package/skills/writing-docs/docx/scripts/__init__.py +1 -1
  465. package/skills/writing-docs/docx/scripts/document.py +1276 -1276
  466. package/skills/writing-docs/docx/scripts/templates/comments.xml +2 -2
  467. package/skills/writing-docs/docx/scripts/templates/commentsExtended.xml +2 -2
  468. package/skills/writing-docs/docx/scripts/templates/commentsExtensible.xml +2 -2
  469. package/skills/writing-docs/docx/scripts/templates/commentsIds.xml +2 -2
  470. package/skills/writing-docs/docx/scripts/templates/people.xml +2 -2
  471. package/skills/writing-docs/docx/scripts/utilities.py +374 -374
  472. package/skills/writing-docs/mermaidjs-v11/SKILL.md +115 -115
  473. package/skills/writing-docs/mermaidjs-v11/references/cli-usage.md +228 -228
  474. package/skills/writing-docs/mermaidjs-v11/references/configuration.md +232 -232
  475. package/skills/writing-docs/mermaidjs-v11/references/diagram-types.md +315 -315
  476. package/skills/writing-docs/mermaidjs-v11/references/examples.md +344 -344
  477. package/skills/writing-docs/mermaidjs-v11/references/integration.md +310 -310
  478. package/skills/writing-docs/pdf/LICENSE.txt +30 -30
  479. package/skills/writing-docs/pdf/SKILL.md +294 -294
  480. package/skills/writing-docs/pdf/forms.md +205 -205
  481. package/skills/writing-docs/pdf/reference.md +611 -611
  482. package/skills/writing-docs/pdf/scripts/check_bounding_boxes.py +70 -70
  483. package/skills/writing-docs/pdf/scripts/check_bounding_boxes_test.py +226 -226
  484. package/skills/writing-docs/pdf/scripts/check_fillable_fields.py +12 -12
  485. package/skills/writing-docs/pdf/scripts/convert_pdf_to_images.py +35 -35
  486. package/skills/writing-docs/pdf/scripts/create_validation_image.py +41 -41
  487. package/skills/writing-docs/pdf/scripts/extract_form_field_info.py +152 -152
  488. package/skills/writing-docs/pdf/scripts/fill_fillable_fields.py +114 -114
  489. package/skills/writing-docs/pdf/scripts/fill_pdf_form_with_annotations.py +107 -107
  490. package/skills/writing-docs/pptx/LICENSE.txt +30 -30
  491. package/skills/writing-docs/pptx/SKILL.md +483 -483
  492. package/skills/writing-docs/pptx/html2pptx.md +624 -624
  493. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -1499
  494. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -146
  495. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -1085
  496. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -11
  497. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -3081
  498. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -23
  499. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -185
  500. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -287
  501. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -1676
  502. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -28
  503. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -144
  504. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -174
  505. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -25
  506. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -18
  507. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -59
  508. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -56
  509. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -195
  510. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -582
  511. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -25
  512. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -4439
  513. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -570
  514. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -509
  515. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -12
  516. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -108
  517. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -96
  518. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -3646
  519. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -116
  520. package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -42
  521. package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -50
  522. package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -49
  523. package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -33
  524. package/skills/writing-docs/pptx/ooxml/schemas/mce/mc.xsd +75 -75
  525. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2010.xsd +560 -560
  526. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2012.xsd +67 -67
  527. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2018.xsd +14 -14
  528. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -20
  529. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -13
  530. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -4
  531. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -8
  532. package/skills/writing-docs/pptx/ooxml/scripts/pack.py +159 -159
  533. package/skills/writing-docs/pptx/ooxml/scripts/unpack.py +29 -29
  534. package/skills/writing-docs/pptx/ooxml/scripts/validate.py +69 -69
  535. package/skills/writing-docs/pptx/ooxml/scripts/validation/__init__.py +15 -15
  536. package/skills/writing-docs/pptx/ooxml/scripts/validation/base.py +951 -951
  537. package/skills/writing-docs/pptx/ooxml/scripts/validation/docx.py +274 -274
  538. package/skills/writing-docs/pptx/ooxml/scripts/validation/pptx.py +315 -315
  539. package/skills/writing-docs/pptx/ooxml/scripts/validation/redlining.py +279 -279
  540. package/skills/writing-docs/pptx/ooxml.md +426 -426
  541. package/skills/writing-docs/pptx/scripts/html2pptx.js +978 -978
  542. package/skills/writing-docs/pptx/scripts/inventory.py +1020 -1020
  543. package/skills/writing-docs/pptx/scripts/rearrange.py +231 -231
  544. package/skills/writing-docs/pptx/scripts/replace.py +385 -385
  545. package/skills/writing-docs/pptx/scripts/thumbnail.py +450 -450
  546. package/skills/writing-docs/slides/LICENSE.txt +201 -201
  547. package/skills/writing-docs/slides/SKILL.md +71 -71
  548. package/skills/writing-docs/slides/agents/openai.yaml +6 -6
  549. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/code.js +104 -104
  550. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/image.js +333 -333
  551. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/index.js +33 -33
  552. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/latex.js +51 -51
  553. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/layout.js +643 -643
  554. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/layout_builders.js +358 -358
  555. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/svg.js +36 -36
  556. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/text.js +789 -789
  557. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/util.js +24 -24
  558. package/skills/writing-docs/slides/assets/slides-small.svg +3 -3
  559. package/skills/writing-docs/slides/references/pptxgenjs-helpers.md +61 -61
  560. package/skills/writing-docs/slides/scripts/create_montage.py +300 -300
  561. package/skills/writing-docs/slides/scripts/detect_font.py +873 -873
  562. package/skills/writing-docs/slides/scripts/ensure_raster_image.py +202 -202
  563. package/skills/writing-docs/slides/scripts/render_slides.py +273 -273
  564. package/skills/writing-docs/slides/scripts/slides_test.py +201 -201
  565. package/skills/writing-docs/template-skill/SKILL.md +26 -26
  566. package/skills/writing-docs/xlsx/LICENSE.txt +30 -30
  567. package/skills/writing-docs/xlsx/SKILL.md +288 -288
  568. package/skills/writing-docs/xlsx/recalc.py +177 -177
  569. package/src/core/KILO_MASTER.md +448 -448
  570. package/src/tools/validate-skill.js +421 -421
@@ -1,475 +1,475 @@
1
- # PostgreSQL SQL Queries
2
-
3
- SQL queries in PostgreSQL: SELECT, JOINs, subqueries, CTEs, window functions, and advanced patterns.
4
-
5
- ## Basic SELECT
6
-
7
- ### Simple Queries
8
- ```sql
9
- -- Select all columns
10
- SELECT * FROM users;
11
-
12
- -- Select specific columns
13
- SELECT id, name, email FROM users;
14
-
15
- -- With alias
16
- SELECT name AS full_name, email AS contact_email FROM users;
17
-
18
- -- Distinct values
19
- SELECT DISTINCT status FROM orders;
20
-
21
- -- Count rows
22
- SELECT COUNT(*) FROM users;
23
- SELECT COUNT(DISTINCT status) FROM orders;
24
- ```
25
-
26
- ### WHERE Clause
27
- ```sql
28
- -- Equality
29
- SELECT * FROM users WHERE status = 'active';
30
-
31
- -- Comparison
32
- SELECT * FROM products WHERE price > 100;
33
- SELECT * FROM orders WHERE total BETWEEN 100 AND 500;
34
-
35
- -- Pattern matching
36
- SELECT * FROM users WHERE email LIKE '%@example.com';
37
- SELECT * FROM users WHERE name ILIKE 'john%'; -- case-insensitive
38
-
39
- -- IN operator
40
- SELECT * FROM orders WHERE status IN ('pending', 'processing');
41
-
42
- -- NULL checks
43
- SELECT * FROM users WHERE deleted_at IS NULL;
44
- SELECT * FROM users WHERE phone_number IS NOT NULL;
45
-
46
- -- Logical operators
47
- SELECT * FROM products WHERE price > 100 AND stock > 0;
48
- SELECT * FROM users WHERE status = 'active' OR verified = true;
49
- SELECT * FROM products WHERE NOT (price > 1000);
50
- ```
51
-
52
- ### ORDER BY
53
- ```sql
54
- -- Ascending (default)
55
- SELECT * FROM users ORDER BY created_at;
56
-
57
- -- Descending
58
- SELECT * FROM users ORDER BY created_at DESC;
59
-
60
- -- Multiple columns
61
- SELECT * FROM orders ORDER BY status ASC, created_at DESC;
62
-
63
- -- NULL handling
64
- SELECT * FROM users ORDER BY last_login NULLS FIRST;
65
- SELECT * FROM users ORDER BY last_login NULLS LAST;
66
- ```
67
-
68
- ### LIMIT and OFFSET
69
- ```sql
70
- -- Limit results
71
- SELECT * FROM users LIMIT 10;
72
-
73
- -- Pagination
74
- SELECT * FROM users ORDER BY id LIMIT 10 OFFSET 20;
75
-
76
- -- Alternative: FETCH
77
- SELECT * FROM users OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY;
78
- ```
79
-
80
- ## JOINs
81
-
82
- ### INNER JOIN
83
- ```sql
84
- -- Match rows from both tables
85
- SELECT orders.id, orders.total, customers.name
86
- FROM orders
87
- INNER JOIN customers ON orders.customer_id = customers.id;
88
-
89
- -- Short syntax
90
- SELECT o.id, o.total, c.name
91
- FROM orders o
92
- JOIN customers c ON o.customer_id = c.id;
93
-
94
- -- Multiple joins
95
- SELECT o.id, c.name, p.name AS product
96
- FROM orders o
97
- JOIN customers c ON o.customer_id = c.id
98
- JOIN order_items oi ON oi.order_id = o.id
99
- JOIN products p ON oi.product_id = p.id;
100
- ```
101
-
102
- ### LEFT JOIN (LEFT OUTER JOIN)
103
- ```sql
104
- -- All rows from left table, matching rows from right
105
- SELECT c.name, o.id AS order_id
106
- FROM customers c
107
- LEFT JOIN orders o ON c.id = o.customer_id;
108
-
109
- -- Find customers without orders
110
- SELECT c.name
111
- FROM customers c
112
- LEFT JOIN orders o ON c.id = o.customer_id
113
- WHERE o.id IS NULL;
114
- ```
115
-
116
- ### RIGHT JOIN (RIGHT OUTER JOIN)
117
- ```sql
118
- -- All rows from right table, matching rows from left
119
- SELECT c.name, o.id AS order_id
120
- FROM orders o
121
- RIGHT JOIN customers c ON o.customer_id = c.id;
122
- ```
123
-
124
- ### FULL OUTER JOIN
125
- ```sql
126
- -- All rows from both tables
127
- SELECT c.name, o.id AS order_id
128
- FROM customers c
129
- FULL OUTER JOIN orders o ON c.id = o.customer_id;
130
- ```
131
-
132
- ### CROSS JOIN
133
- ```sql
134
- -- Cartesian product (all combinations)
135
- SELECT c.name, p.name
136
- FROM colors c
137
- CROSS JOIN products p;
138
- ```
139
-
140
- ### Self Join
141
- ```sql
142
- -- Join table to itself
143
- SELECT e1.name AS employee, e2.name AS manager
144
- FROM employees e1
145
- LEFT JOIN employees e2 ON e1.manager_id = e2.id;
146
- ```
147
-
148
- ## Subqueries
149
-
150
- ### Scalar Subquery
151
- ```sql
152
- -- Return single value
153
- SELECT name, salary,
154
- (SELECT AVG(salary) FROM employees) AS avg_salary
155
- FROM employees;
156
- ```
157
-
158
- ### IN Subquery
159
- ```sql
160
- -- Match against set of values
161
- SELECT name FROM customers
162
- WHERE id IN (
163
- SELECT customer_id FROM orders WHERE total > 1000
164
- );
165
- ```
166
-
167
- ### EXISTS Subquery
168
- ```sql
169
- -- Check if subquery returns any rows
170
- SELECT name FROM customers c
171
- WHERE EXISTS (
172
- SELECT 1 FROM orders o WHERE o.customer_id = c.id
173
- );
174
-
175
- -- NOT EXISTS
176
- SELECT name FROM customers c
177
- WHERE NOT EXISTS (
178
- SELECT 1 FROM orders o WHERE o.customer_id = c.id
179
- );
180
- ```
181
-
182
- ### Correlated Subquery
183
- ```sql
184
- -- Subquery references outer query
185
- SELECT name, salary FROM employees e1
186
- WHERE salary > (
187
- SELECT AVG(salary) FROM employees e2
188
- WHERE e2.department_id = e1.department_id
189
- );
190
- ```
191
-
192
- ## Common Table Expressions (CTEs)
193
-
194
- ### Simple CTE
195
- ```sql
196
- -- Named temporary result set
197
- WITH active_users AS (
198
- SELECT id, name, email FROM users WHERE status = 'active'
199
- )
200
- SELECT * FROM active_users WHERE created_at > '2024-01-01';
201
- ```
202
-
203
- ### Multiple CTEs
204
- ```sql
205
- WITH
206
- active_customers AS (
207
- SELECT id, name FROM customers WHERE active = true
208
- ),
209
- recent_orders AS (
210
- SELECT customer_id, SUM(total) AS total_spent
211
- FROM orders
212
- WHERE order_date > CURRENT_DATE - INTERVAL '30 days'
213
- GROUP BY customer_id
214
- )
215
- SELECT c.name, COALESCE(o.total_spent, 0) AS spent
216
- FROM active_customers c
217
- LEFT JOIN recent_orders o ON c.id = o.customer_id;
218
- ```
219
-
220
- ### Recursive CTE
221
- ```sql
222
- -- Tree traversal, hierarchical data
223
- WITH RECURSIVE category_tree AS (
224
- -- Base case: root categories
225
- SELECT id, name, parent_id, 0 AS level
226
- FROM categories
227
- WHERE parent_id IS NULL
228
-
229
- UNION ALL
230
-
231
- -- Recursive case: child categories
232
- SELECT c.id, c.name, c.parent_id, ct.level + 1
233
- FROM categories c
234
- JOIN category_tree ct ON c.parent_id = ct.id
235
- )
236
- SELECT * FROM category_tree ORDER BY level, name;
237
-
238
- -- Employee hierarchy
239
- WITH RECURSIVE org_chart AS (
240
- SELECT id, name, manager_id, 1 AS level
241
- FROM employees
242
- WHERE manager_id IS NULL
243
-
244
- UNION ALL
245
-
246
- SELECT e.id, e.name, e.manager_id, oc.level + 1
247
- FROM employees e
248
- JOIN org_chart oc ON e.manager_id = oc.id
249
- )
250
- SELECT * FROM org_chart;
251
- ```
252
-
253
- ## Aggregate Functions
254
-
255
- ### Basic Aggregates
256
- ```sql
257
- -- COUNT, SUM, AVG, MIN, MAX
258
- SELECT
259
- COUNT(*) AS total_orders,
260
- SUM(total) AS total_revenue,
261
- AVG(total) AS avg_order_value,
262
- MIN(total) AS min_order,
263
- MAX(total) AS max_order
264
- FROM orders;
265
-
266
- -- COUNT variations
267
- SELECT COUNT(*) FROM users; -- All rows
268
- SELECT COUNT(phone_number) FROM users; -- Non-NULL values
269
- SELECT COUNT(DISTINCT status) FROM orders; -- Unique values
270
- ```
271
-
272
- ### GROUP BY
273
- ```sql
274
- -- Aggregate by groups
275
- SELECT status, COUNT(*) AS count
276
- FROM orders
277
- GROUP BY status;
278
-
279
- -- Multiple grouping columns
280
- SELECT customer_id, status, COUNT(*) AS count
281
- FROM orders
282
- GROUP BY customer_id, status;
283
-
284
- -- With aggregate functions
285
- SELECT customer_id,
286
- COUNT(*) AS order_count,
287
- SUM(total) AS total_spent,
288
- AVG(total) AS avg_order
289
- FROM orders
290
- GROUP BY customer_id;
291
- ```
292
-
293
- ### HAVING
294
- ```sql
295
- -- Filter after aggregation
296
- SELECT customer_id, SUM(total) AS total_spent
297
- FROM orders
298
- GROUP BY customer_id
299
- HAVING SUM(total) > 1000;
300
-
301
- -- Multiple conditions
302
- SELECT status, COUNT(*) AS count
303
- FROM orders
304
- GROUP BY status
305
- HAVING COUNT(*) > 10;
306
- ```
307
-
308
- ## Window Functions
309
-
310
- ### ROW_NUMBER
311
- ```sql
312
- -- Assign unique number to each row
313
- SELECT id, name, salary,
314
- ROW_NUMBER() OVER (ORDER BY salary DESC) AS rank
315
- FROM employees;
316
-
317
- -- Partition by group
318
- SELECT id, department, salary,
319
- ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) AS dept_rank
320
- FROM employees;
321
- ```
322
-
323
- ### RANK / DENSE_RANK
324
- ```sql
325
- -- RANK: gaps in ranking for ties
326
- -- DENSE_RANK: no gaps
327
- SELECT id, name, salary,
328
- RANK() OVER (ORDER BY salary DESC) AS rank,
329
- DENSE_RANK() OVER (ORDER BY salary DESC) AS dense_rank
330
- FROM employees;
331
- ```
332
-
333
- ### LAG / LEAD
334
- ```sql
335
- -- Access previous/next row
336
- SELECT date, revenue,
337
- LAG(revenue) OVER (ORDER BY date) AS prev_revenue,
338
- LEAD(revenue) OVER (ORDER BY date) AS next_revenue,
339
- revenue - LAG(revenue) OVER (ORDER BY date) AS change
340
- FROM daily_sales;
341
- ```
342
-
343
- ### Running Totals
344
- ```sql
345
- -- Cumulative sum
346
- SELECT date, amount,
347
- SUM(amount) OVER (ORDER BY date ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) AS running_total
348
- FROM transactions;
349
-
350
- -- Simpler syntax
351
- SELECT date, amount,
352
- SUM(amount) OVER (ORDER BY date) AS running_total
353
- FROM transactions;
354
- ```
355
-
356
- ### Moving Averages
357
- ```sql
358
- -- 7-day moving average
359
- SELECT date, value,
360
- AVG(value) OVER (
361
- ORDER BY date
362
- ROWS BETWEEN 6 PRECEDING AND CURRENT ROW
363
- ) AS moving_avg_7d
364
- FROM metrics;
365
- ```
366
-
367
- ## Advanced Patterns
368
-
369
- ### CASE Expressions
370
- ```sql
371
- -- Simple CASE
372
- SELECT name,
373
- CASE status
374
- WHEN 'active' THEN 'Active User'
375
- WHEN 'pending' THEN 'Pending Verification'
376
- ELSE 'Inactive'
377
- END AS status_label
378
- FROM users;
379
-
380
- -- Searched CASE
381
- SELECT name, age,
382
- CASE
383
- WHEN age < 18 THEN 'Minor'
384
- WHEN age BETWEEN 18 AND 65 THEN 'Adult'
385
- ELSE 'Senior'
386
- END AS age_group
387
- FROM users;
388
- ```
389
-
390
- ### COALESCE
391
- ```sql
392
- -- Return first non-NULL value
393
- SELECT name, COALESCE(phone_number, email, 'No contact') AS contact
394
- FROM users;
395
- ```
396
-
397
- ### NULLIF
398
- ```sql
399
- -- Return NULL if values equal
400
- SELECT name, NULLIF(status, 'deleted') AS active_status
401
- FROM users;
402
- ```
403
-
404
- ### Array Operations
405
- ```sql
406
- -- Array aggregate
407
- SELECT customer_id, ARRAY_AGG(product_id) AS products
408
- FROM order_items
409
- GROUP BY customer_id;
410
-
411
- -- Unnest array
412
- SELECT unnest(ARRAY[1, 2, 3, 4, 5]);
413
-
414
- -- Array contains
415
- SELECT * FROM products WHERE tags @> ARRAY['featured'];
416
- ```
417
-
418
- ### JSON Operations
419
- ```sql
420
- -- Query JSON/JSONB
421
- SELECT data->>'name' AS name FROM documents;
422
- SELECT data->'address'->>'city' AS city FROM documents;
423
-
424
- -- Check key exists
425
- SELECT * FROM documents WHERE data ? 'email';
426
-
427
- -- JSONB operators
428
- SELECT * FROM documents WHERE data @> '{"status": "active"}';
429
-
430
- -- JSON aggregation
431
- SELECT json_agg(name) FROM users;
432
- SELECT json_object_agg(id, name) FROM users;
433
- ```
434
-
435
- ## Set Operations
436
-
437
- ### UNION
438
- ```sql
439
- -- Combine results (removes duplicates)
440
- SELECT name FROM customers
441
- UNION
442
- SELECT name FROM suppliers;
443
-
444
- -- Keep duplicates
445
- SELECT name FROM customers
446
- UNION ALL
447
- SELECT name FROM suppliers;
448
- ```
449
-
450
- ### INTERSECT
451
- ```sql
452
- -- Common rows
453
- SELECT email FROM users
454
- INTERSECT
455
- SELECT email FROM subscribers;
456
- ```
457
-
458
- ### EXCEPT
459
- ```sql
460
- -- Rows in first query but not second
461
- SELECT email FROM users
462
- EXCEPT
463
- SELECT email FROM unsubscribed;
464
- ```
465
-
466
- ## Best Practices
467
-
468
- 1. **Use indexes** on WHERE, JOIN, ORDER BY columns
469
- 2. **Avoid SELECT *** - specify needed columns
470
- 3. **Use EXISTS** instead of IN for large subqueries
471
- 4. **Filter early** - WHERE before JOIN when possible
472
- 5. **Use CTEs** for readability over nested subqueries
473
- 6. **Parameterize queries** - prevent SQL injection
474
- 7. **Use window functions** instead of self-joins
475
- 8. **Test with EXPLAIN** - analyze query plans
1
+ # PostgreSQL SQL Queries
2
+
3
+ SQL queries in PostgreSQL: SELECT, JOINs, subqueries, CTEs, window functions, and advanced patterns.
4
+
5
+ ## Basic SELECT
6
+
7
+ ### Simple Queries
8
+ ```sql
9
+ -- Select all columns
10
+ SELECT * FROM users;
11
+
12
+ -- Select specific columns
13
+ SELECT id, name, email FROM users;
14
+
15
+ -- With alias
16
+ SELECT name AS full_name, email AS contact_email FROM users;
17
+
18
+ -- Distinct values
19
+ SELECT DISTINCT status FROM orders;
20
+
21
+ -- Count rows
22
+ SELECT COUNT(*) FROM users;
23
+ SELECT COUNT(DISTINCT status) FROM orders;
24
+ ```
25
+
26
+ ### WHERE Clause
27
+ ```sql
28
+ -- Equality
29
+ SELECT * FROM users WHERE status = 'active';
30
+
31
+ -- Comparison
32
+ SELECT * FROM products WHERE price > 100;
33
+ SELECT * FROM orders WHERE total BETWEEN 100 AND 500;
34
+
35
+ -- Pattern matching
36
+ SELECT * FROM users WHERE email LIKE '%@example.com';
37
+ SELECT * FROM users WHERE name ILIKE 'john%'; -- case-insensitive
38
+
39
+ -- IN operator
40
+ SELECT * FROM orders WHERE status IN ('pending', 'processing');
41
+
42
+ -- NULL checks
43
+ SELECT * FROM users WHERE deleted_at IS NULL;
44
+ SELECT * FROM users WHERE phone_number IS NOT NULL;
45
+
46
+ -- Logical operators
47
+ SELECT * FROM products WHERE price > 100 AND stock > 0;
48
+ SELECT * FROM users WHERE status = 'active' OR verified = true;
49
+ SELECT * FROM products WHERE NOT (price > 1000);
50
+ ```
51
+
52
+ ### ORDER BY
53
+ ```sql
54
+ -- Ascending (default)
55
+ SELECT * FROM users ORDER BY created_at;
56
+
57
+ -- Descending
58
+ SELECT * FROM users ORDER BY created_at DESC;
59
+
60
+ -- Multiple columns
61
+ SELECT * FROM orders ORDER BY status ASC, created_at DESC;
62
+
63
+ -- NULL handling
64
+ SELECT * FROM users ORDER BY last_login NULLS FIRST;
65
+ SELECT * FROM users ORDER BY last_login NULLS LAST;
66
+ ```
67
+
68
+ ### LIMIT and OFFSET
69
+ ```sql
70
+ -- Limit results
71
+ SELECT * FROM users LIMIT 10;
72
+
73
+ -- Pagination
74
+ SELECT * FROM users ORDER BY id LIMIT 10 OFFSET 20;
75
+
76
+ -- Alternative: FETCH
77
+ SELECT * FROM users OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY;
78
+ ```
79
+
80
+ ## JOINs
81
+
82
+ ### INNER JOIN
83
+ ```sql
84
+ -- Match rows from both tables
85
+ SELECT orders.id, orders.total, customers.name
86
+ FROM orders
87
+ INNER JOIN customers ON orders.customer_id = customers.id;
88
+
89
+ -- Short syntax
90
+ SELECT o.id, o.total, c.name
91
+ FROM orders o
92
+ JOIN customers c ON o.customer_id = c.id;
93
+
94
+ -- Multiple joins
95
+ SELECT o.id, c.name, p.name AS product
96
+ FROM orders o
97
+ JOIN customers c ON o.customer_id = c.id
98
+ JOIN order_items oi ON oi.order_id = o.id
99
+ JOIN products p ON oi.product_id = p.id;
100
+ ```
101
+
102
+ ### LEFT JOIN (LEFT OUTER JOIN)
103
+ ```sql
104
+ -- All rows from left table, matching rows from right
105
+ SELECT c.name, o.id AS order_id
106
+ FROM customers c
107
+ LEFT JOIN orders o ON c.id = o.customer_id;
108
+
109
+ -- Find customers without orders
110
+ SELECT c.name
111
+ FROM customers c
112
+ LEFT JOIN orders o ON c.id = o.customer_id
113
+ WHERE o.id IS NULL;
114
+ ```
115
+
116
+ ### RIGHT JOIN (RIGHT OUTER JOIN)
117
+ ```sql
118
+ -- All rows from right table, matching rows from left
119
+ SELECT c.name, o.id AS order_id
120
+ FROM orders o
121
+ RIGHT JOIN customers c ON o.customer_id = c.id;
122
+ ```
123
+
124
+ ### FULL OUTER JOIN
125
+ ```sql
126
+ -- All rows from both tables
127
+ SELECT c.name, o.id AS order_id
128
+ FROM customers c
129
+ FULL OUTER JOIN orders o ON c.id = o.customer_id;
130
+ ```
131
+
132
+ ### CROSS JOIN
133
+ ```sql
134
+ -- Cartesian product (all combinations)
135
+ SELECT c.name, p.name
136
+ FROM colors c
137
+ CROSS JOIN products p;
138
+ ```
139
+
140
+ ### Self Join
141
+ ```sql
142
+ -- Join table to itself
143
+ SELECT e1.name AS employee, e2.name AS manager
144
+ FROM employees e1
145
+ LEFT JOIN employees e2 ON e1.manager_id = e2.id;
146
+ ```
147
+
148
+ ## Subqueries
149
+
150
+ ### Scalar Subquery
151
+ ```sql
152
+ -- Return single value
153
+ SELECT name, salary,
154
+ (SELECT AVG(salary) FROM employees) AS avg_salary
155
+ FROM employees;
156
+ ```
157
+
158
+ ### IN Subquery
159
+ ```sql
160
+ -- Match against set of values
161
+ SELECT name FROM customers
162
+ WHERE id IN (
163
+ SELECT customer_id FROM orders WHERE total > 1000
164
+ );
165
+ ```
166
+
167
+ ### EXISTS Subquery
168
+ ```sql
169
+ -- Check if subquery returns any rows
170
+ SELECT name FROM customers c
171
+ WHERE EXISTS (
172
+ SELECT 1 FROM orders o WHERE o.customer_id = c.id
173
+ );
174
+
175
+ -- NOT EXISTS
176
+ SELECT name FROM customers c
177
+ WHERE NOT EXISTS (
178
+ SELECT 1 FROM orders o WHERE o.customer_id = c.id
179
+ );
180
+ ```
181
+
182
+ ### Correlated Subquery
183
+ ```sql
184
+ -- Subquery references outer query
185
+ SELECT name, salary FROM employees e1
186
+ WHERE salary > (
187
+ SELECT AVG(salary) FROM employees e2
188
+ WHERE e2.department_id = e1.department_id
189
+ );
190
+ ```
191
+
192
+ ## Common Table Expressions (CTEs)
193
+
194
+ ### Simple CTE
195
+ ```sql
196
+ -- Named temporary result set
197
+ WITH active_users AS (
198
+ SELECT id, name, email FROM users WHERE status = 'active'
199
+ )
200
+ SELECT * FROM active_users WHERE created_at > '2024-01-01';
201
+ ```
202
+
203
+ ### Multiple CTEs
204
+ ```sql
205
+ WITH
206
+ active_customers AS (
207
+ SELECT id, name FROM customers WHERE active = true
208
+ ),
209
+ recent_orders AS (
210
+ SELECT customer_id, SUM(total) AS total_spent
211
+ FROM orders
212
+ WHERE order_date > CURRENT_DATE - INTERVAL '30 days'
213
+ GROUP BY customer_id
214
+ )
215
+ SELECT c.name, COALESCE(o.total_spent, 0) AS spent
216
+ FROM active_customers c
217
+ LEFT JOIN recent_orders o ON c.id = o.customer_id;
218
+ ```
219
+
220
+ ### Recursive CTE
221
+ ```sql
222
+ -- Tree traversal, hierarchical data
223
+ WITH RECURSIVE category_tree AS (
224
+ -- Base case: root categories
225
+ SELECT id, name, parent_id, 0 AS level
226
+ FROM categories
227
+ WHERE parent_id IS NULL
228
+
229
+ UNION ALL
230
+
231
+ -- Recursive case: child categories
232
+ SELECT c.id, c.name, c.parent_id, ct.level + 1
233
+ FROM categories c
234
+ JOIN category_tree ct ON c.parent_id = ct.id
235
+ )
236
+ SELECT * FROM category_tree ORDER BY level, name;
237
+
238
+ -- Employee hierarchy
239
+ WITH RECURSIVE org_chart AS (
240
+ SELECT id, name, manager_id, 1 AS level
241
+ FROM employees
242
+ WHERE manager_id IS NULL
243
+
244
+ UNION ALL
245
+
246
+ SELECT e.id, e.name, e.manager_id, oc.level + 1
247
+ FROM employees e
248
+ JOIN org_chart oc ON e.manager_id = oc.id
249
+ )
250
+ SELECT * FROM org_chart;
251
+ ```
252
+
253
+ ## Aggregate Functions
254
+
255
+ ### Basic Aggregates
256
+ ```sql
257
+ -- COUNT, SUM, AVG, MIN, MAX
258
+ SELECT
259
+ COUNT(*) AS total_orders,
260
+ SUM(total) AS total_revenue,
261
+ AVG(total) AS avg_order_value,
262
+ MIN(total) AS min_order,
263
+ MAX(total) AS max_order
264
+ FROM orders;
265
+
266
+ -- COUNT variations
267
+ SELECT COUNT(*) FROM users; -- All rows
268
+ SELECT COUNT(phone_number) FROM users; -- Non-NULL values
269
+ SELECT COUNT(DISTINCT status) FROM orders; -- Unique values
270
+ ```
271
+
272
+ ### GROUP BY
273
+ ```sql
274
+ -- Aggregate by groups
275
+ SELECT status, COUNT(*) AS count
276
+ FROM orders
277
+ GROUP BY status;
278
+
279
+ -- Multiple grouping columns
280
+ SELECT customer_id, status, COUNT(*) AS count
281
+ FROM orders
282
+ GROUP BY customer_id, status;
283
+
284
+ -- With aggregate functions
285
+ SELECT customer_id,
286
+ COUNT(*) AS order_count,
287
+ SUM(total) AS total_spent,
288
+ AVG(total) AS avg_order
289
+ FROM orders
290
+ GROUP BY customer_id;
291
+ ```
292
+
293
+ ### HAVING
294
+ ```sql
295
+ -- Filter after aggregation
296
+ SELECT customer_id, SUM(total) AS total_spent
297
+ FROM orders
298
+ GROUP BY customer_id
299
+ HAVING SUM(total) > 1000;
300
+
301
+ -- Multiple conditions
302
+ SELECT status, COUNT(*) AS count
303
+ FROM orders
304
+ GROUP BY status
305
+ HAVING COUNT(*) > 10;
306
+ ```
307
+
308
+ ## Window Functions
309
+
310
+ ### ROW_NUMBER
311
+ ```sql
312
+ -- Assign unique number to each row
313
+ SELECT id, name, salary,
314
+ ROW_NUMBER() OVER (ORDER BY salary DESC) AS rank
315
+ FROM employees;
316
+
317
+ -- Partition by group
318
+ SELECT id, department, salary,
319
+ ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) AS dept_rank
320
+ FROM employees;
321
+ ```
322
+
323
+ ### RANK / DENSE_RANK
324
+ ```sql
325
+ -- RANK: gaps in ranking for ties
326
+ -- DENSE_RANK: no gaps
327
+ SELECT id, name, salary,
328
+ RANK() OVER (ORDER BY salary DESC) AS rank,
329
+ DENSE_RANK() OVER (ORDER BY salary DESC) AS dense_rank
330
+ FROM employees;
331
+ ```
332
+
333
+ ### LAG / LEAD
334
+ ```sql
335
+ -- Access previous/next row
336
+ SELECT date, revenue,
337
+ LAG(revenue) OVER (ORDER BY date) AS prev_revenue,
338
+ LEAD(revenue) OVER (ORDER BY date) AS next_revenue,
339
+ revenue - LAG(revenue) OVER (ORDER BY date) AS change
340
+ FROM daily_sales;
341
+ ```
342
+
343
+ ### Running Totals
344
+ ```sql
345
+ -- Cumulative sum
346
+ SELECT date, amount,
347
+ SUM(amount) OVER (ORDER BY date ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) AS running_total
348
+ FROM transactions;
349
+
350
+ -- Simpler syntax
351
+ SELECT date, amount,
352
+ SUM(amount) OVER (ORDER BY date) AS running_total
353
+ FROM transactions;
354
+ ```
355
+
356
+ ### Moving Averages
357
+ ```sql
358
+ -- 7-day moving average
359
+ SELECT date, value,
360
+ AVG(value) OVER (
361
+ ORDER BY date
362
+ ROWS BETWEEN 6 PRECEDING AND CURRENT ROW
363
+ ) AS moving_avg_7d
364
+ FROM metrics;
365
+ ```
366
+
367
+ ## Advanced Patterns
368
+
369
+ ### CASE Expressions
370
+ ```sql
371
+ -- Simple CASE
372
+ SELECT name,
373
+ CASE status
374
+ WHEN 'active' THEN 'Active User'
375
+ WHEN 'pending' THEN 'Pending Verification'
376
+ ELSE 'Inactive'
377
+ END AS status_label
378
+ FROM users;
379
+
380
+ -- Searched CASE
381
+ SELECT name, age,
382
+ CASE
383
+ WHEN age < 18 THEN 'Minor'
384
+ WHEN age BETWEEN 18 AND 65 THEN 'Adult'
385
+ ELSE 'Senior'
386
+ END AS age_group
387
+ FROM users;
388
+ ```
389
+
390
+ ### COALESCE
391
+ ```sql
392
+ -- Return first non-NULL value
393
+ SELECT name, COALESCE(phone_number, email, 'No contact') AS contact
394
+ FROM users;
395
+ ```
396
+
397
+ ### NULLIF
398
+ ```sql
399
+ -- Return NULL if values equal
400
+ SELECT name, NULLIF(status, 'deleted') AS active_status
401
+ FROM users;
402
+ ```
403
+
404
+ ### Array Operations
405
+ ```sql
406
+ -- Array aggregate
407
+ SELECT customer_id, ARRAY_AGG(product_id) AS products
408
+ FROM order_items
409
+ GROUP BY customer_id;
410
+
411
+ -- Unnest array
412
+ SELECT unnest(ARRAY[1, 2, 3, 4, 5]);
413
+
414
+ -- Array contains
415
+ SELECT * FROM products WHERE tags @> ARRAY['featured'];
416
+ ```
417
+
418
+ ### JSON Operations
419
+ ```sql
420
+ -- Query JSON/JSONB
421
+ SELECT data->>'name' AS name FROM documents;
422
+ SELECT data->'address'->>'city' AS city FROM documents;
423
+
424
+ -- Check key exists
425
+ SELECT * FROM documents WHERE data ? 'email';
426
+
427
+ -- JSONB operators
428
+ SELECT * FROM documents WHERE data @> '{"status": "active"}';
429
+
430
+ -- JSON aggregation
431
+ SELECT json_agg(name) FROM users;
432
+ SELECT json_object_agg(id, name) FROM users;
433
+ ```
434
+
435
+ ## Set Operations
436
+
437
+ ### UNION
438
+ ```sql
439
+ -- Combine results (removes duplicates)
440
+ SELECT name FROM customers
441
+ UNION
442
+ SELECT name FROM suppliers;
443
+
444
+ -- Keep duplicates
445
+ SELECT name FROM customers
446
+ UNION ALL
447
+ SELECT name FROM suppliers;
448
+ ```
449
+
450
+ ### INTERSECT
451
+ ```sql
452
+ -- Common rows
453
+ SELECT email FROM users
454
+ INTERSECT
455
+ SELECT email FROM subscribers;
456
+ ```
457
+
458
+ ### EXCEPT
459
+ ```sql
460
+ -- Rows in first query but not second
461
+ SELECT email FROM users
462
+ EXCEPT
463
+ SELECT email FROM unsubscribed;
464
+ ```
465
+
466
+ ## Best Practices
467
+
468
+ 1. **Use indexes** on WHERE, JOIN, ORDER BY columns
469
+ 2. **Avoid SELECT *** - specify needed columns
470
+ 3. **Use EXISTS** instead of IN for large subqueries
471
+ 4. **Filter early** - WHERE before JOIN when possible
472
+ 5. **Use CTEs** for readability over nested subqueries
473
+ 6. **Parameterize queries** - prevent SQL injection
474
+ 7. **Use window functions** instead of self-joins
475
+ 8. **Test with EXPLAIN** - analyze query plans