@vodailoc/kilo-kit-mcp 1.1.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 (816) hide show
  1. package/.mcp/kilo-kit.example.json +8 -0
  2. package/LICENSE +190 -0
  3. package/QUICKSTART.md +298 -0
  4. package/README.md +395 -0
  5. package/mcp/README.md +132 -0
  6. package/mcp/dist/formatters.js +77 -0
  7. package/mcp/dist/frontmatter.js +54 -0
  8. package/mcp/dist/paths.js +22 -0
  9. package/mcp/dist/registry.js +185 -0
  10. package/mcp/dist/router.js +98 -0
  11. package/mcp/dist/server.js +223 -0
  12. package/mcp/dist/smoke.js +57 -0
  13. package/mcp/dist/types.js +1 -0
  14. package/mcp/dist/validator.js +35 -0
  15. package/mcp/package.json +30 -0
  16. package/package.json +57 -0
  17. package/skills/README.md +647 -0
  18. package/skills/SKILLS_INDEX.md +139 -0
  19. package/skills/agent-frameworks/claukit/SKILL.md +61 -0
  20. package/skills/agent-frameworks/claukit/references/guardrails.md +42 -0
  21. package/skills/agent-frameworks/claukit/references/integration-hints.md +67 -0
  22. package/skills/agent-frameworks/claukit/references/mission-briefs.md +38 -0
  23. package/skills/agent-frameworks/claukit/references/skills-directory.md +70 -0
  24. package/skills/ai-media/ai-multimodal/.env.example +97 -0
  25. package/skills/ai-media/ai-multimodal/SKILL.md +357 -0
  26. package/skills/ai-media/ai-multimodal/references/audio-processing.md +373 -0
  27. package/skills/ai-media/ai-multimodal/references/image-generation.md +558 -0
  28. package/skills/ai-media/ai-multimodal/references/video-analysis.md +502 -0
  29. package/skills/ai-media/ai-multimodal/references/vision-understanding.md +483 -0
  30. package/skills/ai-media/ai-multimodal/scripts/document_converter.py +395 -0
  31. package/skills/ai-media/ai-multimodal/scripts/gemini_batch_process.py +480 -0
  32. package/skills/ai-media/ai-multimodal/scripts/media_optimizer.py +506 -0
  33. package/skills/ai-media/ai-multimodal/scripts/requirements.txt +26 -0
  34. package/skills/ai-media/ai-multimodal/scripts/tests/requirements.txt +20 -0
  35. package/skills/ai-media/ai-multimodal/scripts/tests/test_document_converter.py +299 -0
  36. package/skills/ai-media/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -0
  37. package/skills/ai-media/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -0
  38. package/skills/ai-media/geo-fundamentals/SKILL.md +156 -0
  39. package/skills/ai-media/geo-fundamentals/scripts/geo_checker.py +289 -0
  40. package/skills/ai-media/media-processing/SKILL.md +358 -0
  41. package/skills/ai-media/media-processing/references/ffmpeg-encoding.md +358 -0
  42. package/skills/ai-media/media-processing/references/ffmpeg-filters.md +503 -0
  43. package/skills/ai-media/media-processing/references/ffmpeg-streaming.md +403 -0
  44. package/skills/ai-media/media-processing/references/format-compatibility.md +375 -0
  45. package/skills/ai-media/media-processing/references/imagemagick-batch.md +612 -0
  46. package/skills/ai-media/media-processing/references/imagemagick-editing.md +623 -0
  47. package/skills/ai-media/media-processing/scripts/batch_resize.py +342 -0
  48. package/skills/ai-media/media-processing/scripts/media_convert.py +311 -0
  49. package/skills/ai-media/media-processing/scripts/requirements.txt +24 -0
  50. package/skills/ai-media/media-processing/scripts/tests/requirements.txt +2 -0
  51. package/skills/ai-media/media-processing/scripts/tests/test_batch_resize.py +372 -0
  52. package/skills/ai-media/media-processing/scripts/tests/test_media_convert.py +259 -0
  53. package/skills/ai-media/media-processing/scripts/tests/test_video_optimize.py +397 -0
  54. package/skills/ai-media/media-processing/scripts/video_optimize.py +414 -0
  55. package/skills/ai-media/screenshot/LICENSE.txt +201 -0
  56. package/skills/ai-media/screenshot/SKILL.md +267 -0
  57. package/skills/ai-media/screenshot/agents/openai.yaml +6 -0
  58. package/skills/ai-media/screenshot/assets/screenshot-small.svg +5 -0
  59. package/skills/ai-media/screenshot/assets/screenshot.png +0 -0
  60. package/skills/ai-media/screenshot/scripts/ensure_macos_permissions.sh +54 -0
  61. package/skills/ai-media/screenshot/scripts/macos_display_info.swift +22 -0
  62. package/skills/ai-media/screenshot/scripts/macos_permissions.swift +40 -0
  63. package/skills/ai-media/screenshot/scripts/macos_window_info.swift +126 -0
  64. package/skills/ai-media/screenshot/scripts/take_screenshot.ps1 +163 -0
  65. package/skills/ai-media/screenshot/scripts/take_screenshot.py +585 -0
  66. package/skills/ai-media/seo-fundamentals/SKILL.md +129 -0
  67. package/skills/ai-media/seo-fundamentals/scripts/seo_checker.py +219 -0
  68. package/skills/ai-media/sora/LICENSE.txt +201 -0
  69. package/skills/ai-media/sora/SKILL.md +153 -0
  70. package/skills/ai-media/sora/agents/openai.yaml +6 -0
  71. package/skills/ai-media/sora/assets/sora-small.svg +4 -0
  72. package/skills/ai-media/sora/assets/sora.png +0 -0
  73. package/skills/ai-media/sora/references/cinematic-shots.md +53 -0
  74. package/skills/ai-media/sora/references/cli.md +248 -0
  75. package/skills/ai-media/sora/references/codex-network.md +28 -0
  76. package/skills/ai-media/sora/references/prompting.md +137 -0
  77. package/skills/ai-media/sora/references/sample-prompts.md +95 -0
  78. package/skills/ai-media/sora/references/social-ads.md +42 -0
  79. package/skills/ai-media/sora/references/troubleshooting.md +58 -0
  80. package/skills/ai-media/sora/references/video-api.md +45 -0
  81. package/skills/ai-media/sora/scripts/sora.py +970 -0
  82. package/skills/design/aesthetic/SKILL.md +121 -0
  83. package/skills/design/aesthetic/assets/design-guideline-template.md +163 -0
  84. package/skills/design/aesthetic/assets/design-story-template.md +135 -0
  85. package/skills/design/aesthetic/references/design-principles.md +62 -0
  86. package/skills/design/aesthetic/references/design-resources.md +75 -0
  87. package/skills/design/aesthetic/references/micro-interactions.md +53 -0
  88. package/skills/design/aesthetic/references/storytelling-design.md +50 -0
  89. package/skills/design/figma/LICENSE.txt +202 -0
  90. package/skills/design/figma/SKILL.md +42 -0
  91. package/skills/design/figma/agents/openai.yaml +14 -0
  92. package/skills/design/figma/assets/figma-small.svg +3 -0
  93. package/skills/design/figma/assets/figma.png +0 -0
  94. package/skills/design/figma/assets/icon.svg +28 -0
  95. package/skills/design/figma/references/figma-mcp-config.md +35 -0
  96. package/skills/design/figma/references/figma-tools-and-prompts.md +34 -0
  97. package/skills/design/figma-implement-design/LICENSE.txt +202 -0
  98. package/skills/design/figma-implement-design/SKILL.md +264 -0
  99. package/skills/design/figma-implement-design/agents/openai.yaml +14 -0
  100. package/skills/design/figma-implement-design/assets/figma-small.svg +3 -0
  101. package/skills/design/figma-implement-design/assets/figma.png +0 -0
  102. package/skills/design/figma-implement-design/assets/icon.svg +28 -0
  103. package/skills/design/frontend-design/SKILL.md +42 -0
  104. package/skills/design/frontend-design/references/animejs.md +396 -0
  105. package/skills/design/mobile-design/SKILL.md +394 -0
  106. package/skills/design/mobile-design/decision-trees.md +516 -0
  107. package/skills/design/mobile-design/mobile-backend.md +491 -0
  108. package/skills/design/mobile-design/mobile-color-system.md +420 -0
  109. package/skills/design/mobile-design/mobile-debugging.md +122 -0
  110. package/skills/design/mobile-design/mobile-design-thinking.md +357 -0
  111. package/skills/design/mobile-design/mobile-navigation.md +458 -0
  112. package/skills/design/mobile-design/mobile-performance.md +767 -0
  113. package/skills/design/mobile-design/mobile-testing.md +356 -0
  114. package/skills/design/mobile-design/mobile-typography.md +433 -0
  115. package/skills/design/mobile-design/platform-android.md +666 -0
  116. package/skills/design/mobile-design/platform-ios.md +561 -0
  117. package/skills/design/mobile-design/scripts/mobile_audit.py +670 -0
  118. package/skills/design/mobile-design/touch-psychology.md +537 -0
  119. package/skills/design/tailwind-patterns/SKILL.md +269 -0
  120. package/skills/design/ui-styling/LICENSE.txt +202 -0
  121. package/skills/design/ui-styling/SKILL.md +321 -0
  122. package/skills/design/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -0
  123. package/skills/design/ui-styling/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
  124. package/skills/design/ui-styling/canvas-fonts/BigShoulders-Bold.ttf +0 -0
  125. package/skills/design/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -0
  126. package/skills/design/ui-styling/canvas-fonts/BigShoulders-Regular.ttf +0 -0
  127. package/skills/design/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -0
  128. package/skills/design/ui-styling/canvas-fonts/Boldonse-Regular.ttf +0 -0
  129. package/skills/design/ui-styling/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
  130. package/skills/design/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
  131. package/skills/design/ui-styling/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
  132. package/skills/design/ui-styling/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
  133. package/skills/design/ui-styling/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
  134. package/skills/design/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -0
  135. package/skills/design/ui-styling/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
  136. package/skills/design/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -0
  137. package/skills/design/ui-styling/canvas-fonts/DMMono-Regular.ttf +0 -0
  138. package/skills/design/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -0
  139. package/skills/design/ui-styling/canvas-fonts/EricaOne-Regular.ttf +0 -0
  140. package/skills/design/ui-styling/canvas-fonts/GeistMono-Bold.ttf +0 -0
  141. package/skills/design/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -0
  142. package/skills/design/ui-styling/canvas-fonts/GeistMono-Regular.ttf +0 -0
  143. package/skills/design/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -0
  144. package/skills/design/ui-styling/canvas-fonts/Gloock-Regular.ttf +0 -0
  145. package/skills/design/ui-styling/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
  146. package/skills/design/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
  147. package/skills/design/ui-styling/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
  148. package/skills/design/ui-styling/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
  149. package/skills/design/ui-styling/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
  150. package/skills/design/ui-styling/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
  151. package/skills/design/ui-styling/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
  152. package/skills/design/ui-styling/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
  153. package/skills/design/ui-styling/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
  154. package/skills/design/ui-styling/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
  155. package/skills/design/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -0
  156. package/skills/design/ui-styling/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
  157. package/skills/design/ui-styling/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
  158. package/skills/design/ui-styling/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
  159. package/skills/design/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -0
  160. package/skills/design/ui-styling/canvas-fonts/Italiana-Regular.ttf +0 -0
  161. package/skills/design/ui-styling/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
  162. package/skills/design/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
  163. package/skills/design/ui-styling/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
  164. package/skills/design/ui-styling/canvas-fonts/Jura-Light.ttf +0 -0
  165. package/skills/design/ui-styling/canvas-fonts/Jura-Medium.ttf +0 -0
  166. package/skills/design/ui-styling/canvas-fonts/Jura-OFL.txt +93 -0
  167. package/skills/design/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
  168. package/skills/design/ui-styling/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
  169. package/skills/design/ui-styling/canvas-fonts/Lora-Bold.ttf +0 -0
  170. package/skills/design/ui-styling/canvas-fonts/Lora-BoldItalic.ttf +0 -0
  171. package/skills/design/ui-styling/canvas-fonts/Lora-Italic.ttf +0 -0
  172. package/skills/design/ui-styling/canvas-fonts/Lora-OFL.txt +93 -0
  173. package/skills/design/ui-styling/canvas-fonts/Lora-Regular.ttf +0 -0
  174. package/skills/design/ui-styling/canvas-fonts/NationalPark-Bold.ttf +0 -0
  175. package/skills/design/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -0
  176. package/skills/design/ui-styling/canvas-fonts/NationalPark-Regular.ttf +0 -0
  177. package/skills/design/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
  178. package/skills/design/ui-styling/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
  179. package/skills/design/ui-styling/canvas-fonts/Outfit-Bold.ttf +0 -0
  180. package/skills/design/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -0
  181. package/skills/design/ui-styling/canvas-fonts/Outfit-Regular.ttf +0 -0
  182. package/skills/design/ui-styling/canvas-fonts/PixelifySans-Medium.ttf +0 -0
  183. package/skills/design/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -0
  184. package/skills/design/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -0
  185. package/skills/design/ui-styling/canvas-fonts/PoiretOne-Regular.ttf +0 -0
  186. package/skills/design/ui-styling/canvas-fonts/RedHatMono-Bold.ttf +0 -0
  187. package/skills/design/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -0
  188. package/skills/design/ui-styling/canvas-fonts/RedHatMono-Regular.ttf +0 -0
  189. package/skills/design/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -0
  190. package/skills/design/ui-styling/canvas-fonts/Silkscreen-Regular.ttf +0 -0
  191. package/skills/design/ui-styling/canvas-fonts/SmoochSans-Medium.ttf +0 -0
  192. package/skills/design/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -0
  193. package/skills/design/ui-styling/canvas-fonts/Tektur-Medium.ttf +0 -0
  194. package/skills/design/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -0
  195. package/skills/design/ui-styling/canvas-fonts/Tektur-Regular.ttf +0 -0
  196. package/skills/design/ui-styling/canvas-fonts/WorkSans-Bold.ttf +0 -0
  197. package/skills/design/ui-styling/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
  198. package/skills/design/ui-styling/canvas-fonts/WorkSans-Italic.ttf +0 -0
  199. package/skills/design/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -0
  200. package/skills/design/ui-styling/canvas-fonts/WorkSans-Regular.ttf +0 -0
  201. package/skills/design/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -0
  202. package/skills/design/ui-styling/canvas-fonts/YoungSerif-Regular.ttf +0 -0
  203. package/skills/design/ui-styling/references/canvas-design-system.md +320 -0
  204. package/skills/design/ui-styling/references/shadcn-accessibility.md +471 -0
  205. package/skills/design/ui-styling/references/shadcn-components.md +424 -0
  206. package/skills/design/ui-styling/references/shadcn-theming.md +373 -0
  207. package/skills/design/ui-styling/references/tailwind-customization.md +483 -0
  208. package/skills/design/ui-styling/references/tailwind-responsive.md +382 -0
  209. package/skills/design/ui-styling/references/tailwind-utilities.md +455 -0
  210. package/skills/design/ui-styling/scripts/requirements.txt +17 -0
  211. package/skills/design/ui-styling/scripts/shadcn_add.py +292 -0
  212. package/skills/design/ui-styling/scripts/tailwind_config_gen.py +456 -0
  213. package/skills/design/ui-styling/scripts/tests/coverage-ui.json +1 -0
  214. package/skills/design/ui-styling/scripts/tests/requirements.txt +3 -0
  215. package/skills/design/ui-styling/scripts/tests/test_shadcn_add.py +266 -0
  216. package/skills/design/ui-styling/scripts/tests/test_tailwind_config_gen.py +336 -0
  217. package/skills/engineering/api-patterns/SKILL.md +81 -0
  218. package/skills/engineering/api-patterns/api-style.md +42 -0
  219. package/skills/engineering/api-patterns/auth.md +24 -0
  220. package/skills/engineering/api-patterns/documentation.md +26 -0
  221. package/skills/engineering/api-patterns/graphql.md +41 -0
  222. package/skills/engineering/api-patterns/rate-limiting.md +31 -0
  223. package/skills/engineering/api-patterns/response.md +37 -0
  224. package/skills/engineering/api-patterns/rest.md +40 -0
  225. package/skills/engineering/api-patterns/scripts/api_validator.py +211 -0
  226. package/skills/engineering/api-patterns/security-testing.md +122 -0
  227. package/skills/engineering/api-patterns/trpc.md +41 -0
  228. package/skills/engineering/api-patterns/versioning.md +22 -0
  229. package/skills/engineering/app-builder/SKILL.md +75 -0
  230. package/skills/engineering/app-builder/agent-coordination.md +71 -0
  231. package/skills/engineering/app-builder/feature-building.md +53 -0
  232. package/skills/engineering/app-builder/project-detection.md +34 -0
  233. package/skills/engineering/app-builder/scaffolding.md +118 -0
  234. package/skills/engineering/app-builder/tech-stack.md +40 -0
  235. package/skills/engineering/app-builder/templates/SKILL.md +39 -0
  236. package/skills/engineering/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  237. package/skills/engineering/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  238. package/skills/engineering/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  239. package/skills/engineering/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  240. package/skills/engineering/app-builder/templates/express-api/TEMPLATE.md +83 -0
  241. package/skills/engineering/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  242. package/skills/engineering/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  243. package/skills/engineering/app-builder/templates/nextjs-fullstack/TEMPLATE.md +82 -0
  244. package/skills/engineering/app-builder/templates/nextjs-saas/TEMPLATE.md +100 -0
  245. package/skills/engineering/app-builder/templates/nextjs-static/TEMPLATE.md +106 -0
  246. package/skills/engineering/app-builder/templates/nuxt-app/TEMPLATE.md +101 -0
  247. package/skills/engineering/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  248. package/skills/engineering/app-builder/templates/react-native-app/TEMPLATE.md +93 -0
  249. package/skills/engineering/architecture/SKILL.md +55 -0
  250. package/skills/engineering/architecture/context-discovery.md +43 -0
  251. package/skills/engineering/architecture/examples.md +94 -0
  252. package/skills/engineering/architecture/pattern-selection.md +68 -0
  253. package/skills/engineering/architecture/patterns-reference.md +50 -0
  254. package/skills/engineering/architecture/trade-off-analysis.md +77 -0
  255. package/skills/engineering/aspnet-core/LICENSE.txt +202 -0
  256. package/skills/engineering/aspnet-core/SKILL.md +61 -0
  257. package/skills/engineering/aspnet-core/agents/openai.yaml +5 -0
  258. package/skills/engineering/aspnet-core/assets/dotnet-logo.png +0 -0
  259. package/skills/engineering/aspnet-core/references/_sections.md +40 -0
  260. package/skills/engineering/aspnet-core/references/apis-minimal-and-controllers.md +81 -0
  261. package/skills/engineering/aspnet-core/references/data-state-and-services.md +69 -0
  262. package/skills/engineering/aspnet-core/references/program-and-pipeline.md +103 -0
  263. package/skills/engineering/aspnet-core/references/realtime-grpc-and-background-work.md +58 -0
  264. package/skills/engineering/aspnet-core/references/security-and-identity.md +75 -0
  265. package/skills/engineering/aspnet-core/references/source-map.md +43 -0
  266. package/skills/engineering/aspnet-core/references/stack-selection.md +63 -0
  267. package/skills/engineering/aspnet-core/references/testing-performance-and-operations.md +92 -0
  268. package/skills/engineering/aspnet-core/references/ui-blazor.md +53 -0
  269. package/skills/engineering/aspnet-core/references/ui-mvc.md +56 -0
  270. package/skills/engineering/aspnet-core/references/ui-razor-pages.md +55 -0
  271. package/skills/engineering/aspnet-core/references/versioning-and-upgrades.md +51 -0
  272. package/skills/engineering/backend-development/SKILL.md +95 -0
  273. package/skills/engineering/backend-development/references/backend-api-design.md +495 -0
  274. package/skills/engineering/backend-development/references/backend-architecture.md +454 -0
  275. package/skills/engineering/backend-development/references/backend-authentication.md +338 -0
  276. package/skills/engineering/backend-development/references/backend-code-quality.md +659 -0
  277. package/skills/engineering/backend-development/references/backend-debugging.md +904 -0
  278. package/skills/engineering/backend-development/references/backend-devops.md +494 -0
  279. package/skills/engineering/backend-development/references/backend-mindset.md +387 -0
  280. package/skills/engineering/backend-development/references/backend-performance.md +397 -0
  281. package/skills/engineering/backend-development/references/backend-security.md +290 -0
  282. package/skills/engineering/backend-development/references/backend-technologies.md +256 -0
  283. package/skills/engineering/backend-development/references/backend-testing.md +429 -0
  284. package/skills/engineering/better-auth/SKILL.md +204 -0
  285. package/skills/engineering/better-auth/references/advanced-features.md +553 -0
  286. package/skills/engineering/better-auth/references/database-integration.md +577 -0
  287. package/skills/engineering/better-auth/references/email-password-auth.md +416 -0
  288. package/skills/engineering/better-auth/references/oauth-providers.md +430 -0
  289. package/skills/engineering/better-auth/scripts/better_auth_init.py +521 -0
  290. package/skills/engineering/better-auth/scripts/requirements.txt +15 -0
  291. package/skills/engineering/better-auth/scripts/tests/test_better_auth_init.py +421 -0
  292. package/skills/engineering/clean-code/SKILL.md +201 -0
  293. package/skills/engineering/code-review/SKILL.md +140 -0
  294. package/skills/engineering/code-review/references/code-review-reception.md +209 -0
  295. package/skills/engineering/code-review/references/requesting-code-review.md +105 -0
  296. package/skills/engineering/code-review/references/verification-before-completion.md +139 -0
  297. package/skills/engineering/code-review-checklist/SKILL.md +109 -0
  298. package/skills/engineering/context-engineering/SKILL.md +86 -0
  299. package/skills/engineering/context-engineering/references/context-compression.md +84 -0
  300. package/skills/engineering/context-engineering/references/context-degradation.md +93 -0
  301. package/skills/engineering/context-engineering/references/context-fundamentals.md +75 -0
  302. package/skills/engineering/context-engineering/references/context-optimization.md +82 -0
  303. package/skills/engineering/context-engineering/references/evaluation.md +89 -0
  304. package/skills/engineering/context-engineering/references/memory-systems.md +88 -0
  305. package/skills/engineering/context-engineering/references/multi-agent-patterns.md +90 -0
  306. package/skills/engineering/context-engineering/references/project-development.md +97 -0
  307. package/skills/engineering/context-engineering/references/tool-design.md +86 -0
  308. package/skills/engineering/context-engineering/scripts/compression_evaluator.py +329 -0
  309. package/skills/engineering/context-engineering/scripts/context_analyzer.py +294 -0
  310. package/skills/engineering/database-design/SKILL.md +52 -0
  311. package/skills/engineering/database-design/database-selection.md +43 -0
  312. package/skills/engineering/database-design/indexing.md +39 -0
  313. package/skills/engineering/database-design/migrations.md +48 -0
  314. package/skills/engineering/database-design/optimization.md +36 -0
  315. package/skills/engineering/database-design/orm-selection.md +30 -0
  316. package/skills/engineering/database-design/schema-design.md +56 -0
  317. package/skills/engineering/database-design/scripts/schema_validator.py +172 -0
  318. package/skills/engineering/databases/SKILL.md +232 -0
  319. package/skills/engineering/databases/references/mongodb-aggregation.md +447 -0
  320. package/skills/engineering/databases/references/mongodb-atlas.md +465 -0
  321. package/skills/engineering/databases/references/mongodb-crud.md +408 -0
  322. package/skills/engineering/databases/references/mongodb-indexing.md +442 -0
  323. package/skills/engineering/databases/references/postgresql-administration.md +594 -0
  324. package/skills/engineering/databases/references/postgresql-performance.md +527 -0
  325. package/skills/engineering/databases/references/postgresql-psql-cli.md +467 -0
  326. package/skills/engineering/databases/references/postgresql-queries.md +475 -0
  327. package/skills/engineering/databases/scripts/db_backup.py +502 -0
  328. package/skills/engineering/databases/scripts/db_migrate.py +414 -0
  329. package/skills/engineering/databases/scripts/db_performance_check.py +444 -0
  330. package/skills/engineering/databases/scripts/requirements.txt +20 -0
  331. package/skills/engineering/databases/scripts/tests/coverage-db.json +1 -0
  332. package/skills/engineering/databases/scripts/tests/requirements.txt +4 -0
  333. package/skills/engineering/databases/scripts/tests/test_db_backup.py +340 -0
  334. package/skills/engineering/databases/scripts/tests/test_db_migrate.py +277 -0
  335. package/skills/engineering/databases/scripts/tests/test_db_performance_check.py +370 -0
  336. package/skills/engineering/diagnose/SKILL.md +117 -0
  337. package/skills/engineering/diagnose/scripts/hitl-loop.template.sh +41 -0
  338. package/skills/engineering/docs-seeker/SKILL.md +207 -0
  339. package/skills/engineering/docs-seeker/WORKFLOWS.md +505 -0
  340. package/skills/engineering/docs-seeker/references/best-practices.md +632 -0
  341. package/skills/engineering/docs-seeker/references/documentation-sources.md +461 -0
  342. package/skills/engineering/docs-seeker/references/error-handling.md +621 -0
  343. package/skills/engineering/docs-seeker/references/limitations.md +821 -0
  344. package/skills/engineering/docs-seeker/references/performance.md +574 -0
  345. package/skills/engineering/docs-seeker/references/tool-selection.md +262 -0
  346. package/skills/engineering/frontend-development/SKILL.md +399 -0
  347. package/skills/engineering/frontend-development/resources/common-patterns.md +331 -0
  348. package/skills/engineering/frontend-development/resources/complete-examples.md +872 -0
  349. package/skills/engineering/frontend-development/resources/component-patterns.md +502 -0
  350. package/skills/engineering/frontend-development/resources/data-fetching.md +767 -0
  351. package/skills/engineering/frontend-development/resources/file-organization.md +502 -0
  352. package/skills/engineering/frontend-development/resources/loading-and-error-states.md +501 -0
  353. package/skills/engineering/frontend-development/resources/performance.md +406 -0
  354. package/skills/engineering/frontend-development/resources/routing-guide.md +364 -0
  355. package/skills/engineering/frontend-development/resources/styling-guide.md +428 -0
  356. package/skills/engineering/frontend-development/resources/typescript-standards.md +418 -0
  357. package/skills/engineering/i18n-localization/SKILL.md +154 -0
  358. package/skills/engineering/i18n-localization/scripts/i18n_checker.py +241 -0
  359. package/skills/engineering/improve-codebase-architecture/DEEPENING.md +37 -0
  360. package/skills/engineering/improve-codebase-architecture/INTERFACE-DESIGN.md +44 -0
  361. package/skills/engineering/improve-codebase-architecture/LANGUAGE.md +53 -0
  362. package/skills/engineering/improve-codebase-architecture/SKILL.md +71 -0
  363. package/skills/engineering/lint-and-validate/SKILL.md +45 -0
  364. package/skills/engineering/lint-and-validate/scripts/lint_runner.py +172 -0
  365. package/skills/engineering/lint-and-validate/scripts/type_coverage.py +173 -0
  366. package/skills/engineering/nextjs-best-practices/SKILL.md +203 -0
  367. package/skills/engineering/nodejs-best-practices/SKILL.md +333 -0
  368. package/skills/engineering/openai-docs/LICENSE.txt +201 -0
  369. package/skills/engineering/openai-docs/SKILL.md +69 -0
  370. package/skills/engineering/openai-docs/agents/openai.yaml +14 -0
  371. package/skills/engineering/openai-docs/assets/openai-small.svg +3 -0
  372. package/skills/engineering/openai-docs/assets/openai.png +0 -0
  373. package/skills/engineering/openai-docs/references/gpt-5p4-prompting-guide.md +433 -0
  374. package/skills/engineering/openai-docs/references/latest-model.md +35 -0
  375. package/skills/engineering/openai-docs/references/upgrading-to-gpt-5p4.md +164 -0
  376. package/skills/engineering/performance-profiling/SKILL.md +143 -0
  377. package/skills/engineering/performance-profiling/scripts/lighthouse_audit.py +76 -0
  378. package/skills/engineering/playwright/LICENSE.txt +201 -0
  379. package/skills/engineering/playwright/NOTICE.txt +14 -0
  380. package/skills/engineering/playwright/SKILL.md +147 -0
  381. package/skills/engineering/playwright/agents/openai.yaml +6 -0
  382. package/skills/engineering/playwright/assets/playwright-small.svg +3 -0
  383. package/skills/engineering/playwright/assets/playwright.png +0 -0
  384. package/skills/engineering/playwright/references/cli.md +116 -0
  385. package/skills/engineering/playwright/references/workflows.md +95 -0
  386. package/skills/engineering/playwright/scripts/playwright_cli.sh +25 -0
  387. package/skills/engineering/playwright-interactive/LICENSE.txt +201 -0
  388. package/skills/engineering/playwright-interactive/NOTICE.txt +13 -0
  389. package/skills/engineering/playwright-interactive/SKILL.md +689 -0
  390. package/skills/engineering/playwright-interactive/agents/openai.yaml +6 -0
  391. package/skills/engineering/playwright-interactive/assets/playwright-small.svg +3 -0
  392. package/skills/engineering/playwright-interactive/assets/playwright.png +0 -0
  393. package/skills/engineering/python-patterns/SKILL.md +441 -0
  394. package/skills/engineering/react-patterns/SKILL.md +198 -0
  395. package/skills/engineering/render-deploy/LICENSE.txt +201 -0
  396. package/skills/engineering/render-deploy/SKILL.md +479 -0
  397. package/skills/engineering/render-deploy/agents/openai.yaml +14 -0
  398. package/skills/engineering/render-deploy/assets/docker.yaml +62 -0
  399. package/skills/engineering/render-deploy/assets/go-api.yaml +35 -0
  400. package/skills/engineering/render-deploy/assets/nextjs-postgres.yaml +35 -0
  401. package/skills/engineering/render-deploy/assets/node-express.yaml +25 -0
  402. package/skills/engineering/render-deploy/assets/python-django.yaml +89 -0
  403. package/skills/engineering/render-deploy/assets/render-small.svg +3 -0
  404. package/skills/engineering/render-deploy/assets/render.png +0 -0
  405. package/skills/engineering/render-deploy/assets/static-site.yaml +54 -0
  406. package/skills/engineering/render-deploy/references/blueprint-spec.md +718 -0
  407. package/skills/engineering/render-deploy/references/codebase-analysis.md +49 -0
  408. package/skills/engineering/render-deploy/references/configuration-guide.md +603 -0
  409. package/skills/engineering/render-deploy/references/deployment-details.md +224 -0
  410. package/skills/engineering/render-deploy/references/direct-creation.md +113 -0
  411. package/skills/engineering/render-deploy/references/error-patterns.md +13 -0
  412. package/skills/engineering/render-deploy/references/post-deploy-checks.md +36 -0
  413. package/skills/engineering/render-deploy/references/runtimes.md +473 -0
  414. package/skills/engineering/render-deploy/references/service-types.md +450 -0
  415. package/skills/engineering/render-deploy/references/troubleshooting-basics.md +36 -0
  416. package/skills/engineering/repomix/SKILL.md +215 -0
  417. package/skills/engineering/repomix/references/configuration.md +211 -0
  418. package/skills/engineering/repomix/references/usage-patterns.md +232 -0
  419. package/skills/engineering/repomix/scripts/README.md +179 -0
  420. package/skills/engineering/repomix/scripts/repomix_batch.py +455 -0
  421. package/skills/engineering/repomix/scripts/repos.example.json +15 -0
  422. package/skills/engineering/repomix/scripts/requirements.txt +15 -0
  423. package/skills/engineering/repomix/scripts/tests/test_repomix_batch.py +531 -0
  424. package/skills/engineering/setup-matt-pocock-skills/SKILL.md +121 -0
  425. package/skills/engineering/setup-matt-pocock-skills/domain.md +51 -0
  426. package/skills/engineering/setup-matt-pocock-skills/issue-tracker-github.md +22 -0
  427. package/skills/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md +23 -0
  428. package/skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md +19 -0
  429. package/skills/engineering/setup-matt-pocock-skills/triage-labels.md +15 -0
  430. package/skills/engineering/shopify/README.md +66 -0
  431. package/skills/engineering/shopify/SKILL.md +319 -0
  432. package/skills/engineering/shopify/references/app-development.md +470 -0
  433. package/skills/engineering/shopify/references/extensions.md +493 -0
  434. package/skills/engineering/shopify/references/themes.md +498 -0
  435. package/skills/engineering/shopify/scripts/requirements.txt +19 -0
  436. package/skills/engineering/shopify/scripts/shopify_init.py +423 -0
  437. package/skills/engineering/shopify/scripts/tests/test_shopify_init.py +385 -0
  438. package/skills/engineering/tdd/SKILL.md +109 -0
  439. package/skills/engineering/tdd/deep-modules.md +33 -0
  440. package/skills/engineering/tdd/interface-design.md +31 -0
  441. package/skills/engineering/tdd/mocking.md +59 -0
  442. package/skills/engineering/tdd/refactoring.md +10 -0
  443. package/skills/engineering/tdd/tests.md +61 -0
  444. package/skills/engineering/tdd-workflow/SKILL.md +149 -0
  445. package/skills/engineering/testing-patterns/SKILL.md +178 -0
  446. package/skills/engineering/testing-patterns/scripts/test_runner.py +219 -0
  447. package/skills/engineering/to-issues/SKILL.md +81 -0
  448. package/skills/engineering/to-prd/SKILL.md +74 -0
  449. package/skills/engineering/triage/AGENT-BRIEF.md +168 -0
  450. package/skills/engineering/triage/OUT-OF-SCOPE.md +101 -0
  451. package/skills/engineering/triage/SKILL.md +103 -0
  452. package/skills/engineering/vulnerability-scanner/SKILL.md +276 -0
  453. package/skills/engineering/vulnerability-scanner/checklists.md +121 -0
  454. package/skills/engineering/vulnerability-scanner/scripts/security_scan.py +458 -0
  455. package/skills/engineering/web-frameworks/SKILL.md +324 -0
  456. package/skills/engineering/web-frameworks/references/nextjs-app-router.md +465 -0
  457. package/skills/engineering/web-frameworks/references/nextjs-data-fetching.md +459 -0
  458. package/skills/engineering/web-frameworks/references/nextjs-optimization.md +511 -0
  459. package/skills/engineering/web-frameworks/references/nextjs-server-components.md +495 -0
  460. package/skills/engineering/web-frameworks/references/remix-icon-integration.md +603 -0
  461. package/skills/engineering/web-frameworks/references/turborepo-caching.md +551 -0
  462. package/skills/engineering/web-frameworks/references/turborepo-pipelines.md +517 -0
  463. package/skills/engineering/web-frameworks/references/turborepo-setup.md +542 -0
  464. package/skills/engineering/web-frameworks/scripts/__init__.py +0 -0
  465. package/skills/engineering/web-frameworks/scripts/nextjs_init.py +547 -0
  466. package/skills/engineering/web-frameworks/scripts/requirements.txt +16 -0
  467. package/skills/engineering/web-frameworks/scripts/tests/coverage-web.json +1 -0
  468. package/skills/engineering/web-frameworks/scripts/tests/requirements.txt +3 -0
  469. package/skills/engineering/web-frameworks/scripts/tests/test_nextjs_init.py +319 -0
  470. package/skills/engineering/web-frameworks/scripts/tests/test_turborepo_migrate.py +374 -0
  471. package/skills/engineering/web-frameworks/scripts/turborepo_migrate.py +394 -0
  472. package/skills/engineering/webapp-testing/SKILL.md +187 -0
  473. package/skills/engineering/webapp-testing/scripts/playwright_runner.py +173 -0
  474. package/skills/engineering/write-a-skill/SKILL.md +117 -0
  475. package/skills/games/2d-games/SKILL.md +119 -0
  476. package/skills/games/3d-games/SKILL.md +135 -0
  477. package/skills/games/game-art/SKILL.md +185 -0
  478. package/skills/games/game-audio/SKILL.md +190 -0
  479. package/skills/games/game-design/SKILL.md +129 -0
  480. package/skills/games/game-development/2d-games/SKILL.md +119 -0
  481. package/skills/games/game-development/3d-games/SKILL.md +135 -0
  482. package/skills/games/game-development/SKILL.md +167 -0
  483. package/skills/games/game-development/game-art/SKILL.md +185 -0
  484. package/skills/games/game-development/game-audio/SKILL.md +190 -0
  485. package/skills/games/game-development/game-design/SKILL.md +129 -0
  486. package/skills/games/game-development/mobile-games/SKILL.md +108 -0
  487. package/skills/games/game-development/multiplayer/SKILL.md +132 -0
  488. package/skills/games/game-development/pc-games/SKILL.md +144 -0
  489. package/skills/games/game-development/vr-ar/SKILL.md +123 -0
  490. package/skills/games/game-development/web-games/SKILL.md +150 -0
  491. package/skills/games/mobile-games/SKILL.md +108 -0
  492. package/skills/games/multiplayer/SKILL.md +132 -0
  493. package/skills/games/pc-games/SKILL.md +144 -0
  494. package/skills/games/vr-ar/SKILL.md +123 -0
  495. package/skills/games/web-games/SKILL.md +150 -0
  496. package/skills/kilo-kit/SKILL.md +346 -0
  497. package/skills/kilo-kit/_template/SKILL.md +185 -0
  498. package/skills/kilo-kit/debugging/root-cause/SKILL.md +360 -0
  499. package/skills/kilo-kit/debugging/systematic/SKILL.md +339 -0
  500. package/skills/kilo-kit/debugging/verification/SKILL.md +424 -0
  501. package/skills/kilo-kit/development/backend/SKILL.md +540 -0
  502. package/skills/kilo-kit/development/security/SKILL.md +529 -0
  503. package/skills/kilo-kit/quality/code-review/SKILL.md +297 -0
  504. package/skills/kilo-kit/quality/testing/SKILL.md +540 -0
  505. package/skills/kilo-kit/references/output-formats.md +204 -0
  506. package/skills/kilo-kit/references/patterns.md +156 -0
  507. package/skills/kilo-kit/references/performance-benchmarks.md +90 -0
  508. package/skills/operations/bash-linux/SKILL.md +199 -0
  509. package/skills/operations/chrome-devtools/SKILL.md +392 -0
  510. package/skills/operations/chrome-devtools/references/cdp-domains.md +694 -0
  511. package/skills/operations/chrome-devtools/references/performance-guide.md +940 -0
  512. package/skills/operations/chrome-devtools/references/puppeteer-reference.md +953 -0
  513. package/skills/operations/chrome-devtools/scripts/PERSISTENT-BROWSER.md +107 -0
  514. package/skills/operations/chrome-devtools/scripts/README.md +213 -0
  515. package/skills/operations/chrome-devtools/scripts/__tests__/selector.test.js +210 -0
  516. package/skills/operations/chrome-devtools/scripts/click.js +79 -0
  517. package/skills/operations/chrome-devtools/scripts/close-persistent.js +36 -0
  518. package/skills/operations/chrome-devtools/scripts/console.js +75 -0
  519. package/skills/operations/chrome-devtools/scripts/evaluate.js +49 -0
  520. package/skills/operations/chrome-devtools/scripts/fill.js +72 -0
  521. package/skills/operations/chrome-devtools/scripts/install-deps.sh +181 -0
  522. package/skills/operations/chrome-devtools/scripts/install.sh +83 -0
  523. package/skills/operations/chrome-devtools/scripts/launch-persistent.js +71 -0
  524. package/skills/operations/chrome-devtools/scripts/lib/browser.js +144 -0
  525. package/skills/operations/chrome-devtools/scripts/lib/selector.js +178 -0
  526. package/skills/operations/chrome-devtools/scripts/navigate.js +46 -0
  527. package/skills/operations/chrome-devtools/scripts/network.js +102 -0
  528. package/skills/operations/chrome-devtools/scripts/package-lock.json +1206 -0
  529. package/skills/operations/chrome-devtools/scripts/package.json +15 -0
  530. package/skills/operations/chrome-devtools/scripts/performance.js +145 -0
  531. package/skills/operations/chrome-devtools/scripts/screenshot.js +180 -0
  532. package/skills/operations/chrome-devtools/scripts/snapshot.js +131 -0
  533. package/skills/operations/deployment-procedures/SKILL.md +241 -0
  534. package/skills/operations/devops/.env.example +76 -0
  535. package/skills/operations/devops/SKILL.md +285 -0
  536. package/skills/operations/devops/references/browser-rendering.md +305 -0
  537. package/skills/operations/devops/references/cloudflare-d1-kv.md +123 -0
  538. package/skills/operations/devops/references/cloudflare-platform.md +271 -0
  539. package/skills/operations/devops/references/cloudflare-r2-storage.md +280 -0
  540. package/skills/operations/devops/references/cloudflare-workers-advanced.md +312 -0
  541. package/skills/operations/devops/references/cloudflare-workers-apis.md +309 -0
  542. package/skills/operations/devops/references/cloudflare-workers-basics.md +418 -0
  543. package/skills/operations/devops/references/docker-basics.md +297 -0
  544. package/skills/operations/devops/references/docker-compose.md +292 -0
  545. package/skills/operations/devops/references/gcloud-platform.md +297 -0
  546. package/skills/operations/devops/references/gcloud-services.md +304 -0
  547. package/skills/operations/devops/scripts/cloudflare_deploy.py +269 -0
  548. package/skills/operations/devops/scripts/docker_optimize.py +320 -0
  549. package/skills/operations/devops/scripts/requirements.txt +20 -0
  550. package/skills/operations/devops/scripts/tests/requirements.txt +3 -0
  551. package/skills/operations/devops/scripts/tests/test_cloudflare_deploy.py +285 -0
  552. package/skills/operations/devops/scripts/tests/test_docker_optimize.py +436 -0
  553. package/skills/operations/mcp-builder/LICENSE.txt +202 -0
  554. package/skills/operations/mcp-builder/SKILL.md +328 -0
  555. package/skills/operations/mcp-builder/reference/evaluation.md +602 -0
  556. package/skills/operations/mcp-builder/reference/mcp_best_practices.md +915 -0
  557. package/skills/operations/mcp-builder/reference/node_mcp_server.md +916 -0
  558. package/skills/operations/mcp-builder/reference/python_mcp_server.md +752 -0
  559. package/skills/operations/mcp-builder/scripts/connections.py +151 -0
  560. package/skills/operations/mcp-builder/scripts/evaluation.py +373 -0
  561. package/skills/operations/mcp-builder/scripts/example_evaluation.xml +22 -0
  562. package/skills/operations/mcp-builder/scripts/requirements.txt +2 -0
  563. package/skills/operations/mcp-management/README.md +219 -0
  564. package/skills/operations/mcp-management/SKILL.md +176 -0
  565. package/skills/operations/mcp-management/assets/tools.json +3044 -0
  566. package/skills/operations/mcp-management/references/configuration.md +114 -0
  567. package/skills/operations/mcp-management/references/gemini-cli-integration.md +201 -0
  568. package/skills/operations/mcp-management/references/mcp-protocol.md +116 -0
  569. package/skills/operations/mcp-management/scripts/.env.example +10 -0
  570. package/skills/operations/mcp-management/scripts/cli.ts +155 -0
  571. package/skills/operations/mcp-management/scripts/dist/analyze-tools.js +70 -0
  572. package/skills/operations/mcp-management/scripts/dist/cli.js +131 -0
  573. package/skills/operations/mcp-management/scripts/dist/mcp-client.js +115 -0
  574. package/skills/operations/mcp-management/scripts/mcp-client.ts +163 -0
  575. package/skills/operations/mcp-management/scripts/package.json +18 -0
  576. package/skills/operations/mcp-management/scripts/tsconfig.json +15 -0
  577. package/skills/operations/powershell-windows/SKILL.md +167 -0
  578. package/skills/operations/server-management/SKILL.md +161 -0
  579. package/skills/problem-solving/collision-zone-thinking/SKILL.md +62 -0
  580. package/skills/problem-solving/defense-in-depth/SKILL.md +130 -0
  581. package/skills/problem-solving/inversion-exercise/SKILL.md +58 -0
  582. package/skills/problem-solving/meta-pattern-recognition/SKILL.md +54 -0
  583. package/skills/problem-solving/root-cause-tracing/SKILL.md +177 -0
  584. package/skills/problem-solving/root-cause-tracing/find-polluter.sh +63 -0
  585. package/skills/problem-solving/scale-game/SKILL.md +63 -0
  586. package/skills/problem-solving/sequential-thinking/README.md +118 -0
  587. package/skills/problem-solving/sequential-thinking/SKILL.md +93 -0
  588. package/skills/problem-solving/sequential-thinking/references/advanced.md +122 -0
  589. package/skills/problem-solving/sequential-thinking/references/examples.md +274 -0
  590. package/skills/problem-solving/simplification-cascades/SKILL.md +76 -0
  591. package/skills/problem-solving/systematic-debugging/CREATION-LOG.md +119 -0
  592. package/skills/problem-solving/systematic-debugging/SKILL.md +296 -0
  593. package/skills/problem-solving/systematic-debugging/condition-based-waiting-example.ts +158 -0
  594. package/skills/problem-solving/systematic-debugging/condition-based-waiting.md +115 -0
  595. package/skills/problem-solving/systematic-debugging/defense-in-depth.md +122 -0
  596. package/skills/problem-solving/systematic-debugging/find-polluter.sh +63 -0
  597. package/skills/problem-solving/systematic-debugging/root-cause-tracing.md +169 -0
  598. package/skills/problem-solving/systematic-debugging/test-academic.md +14 -0
  599. package/skills/problem-solving/systematic-debugging/test-pressure-1.md +58 -0
  600. package/skills/problem-solving/systematic-debugging/test-pressure-2.md +68 -0
  601. package/skills/problem-solving/systematic-debugging/test-pressure-3.md +69 -0
  602. package/skills/problem-solving/when-stuck/SKILL.md +88 -0
  603. package/skills/productivity/brainstorming/SKILL.md +54 -0
  604. package/skills/productivity/caveman/SKILL.md +49 -0
  605. package/skills/productivity/dispatching-parallel-agents/SKILL.md +180 -0
  606. package/skills/productivity/executing-plans/SKILL.md +85 -0
  607. package/skills/productivity/finishing-a-development-branch/SKILL.md +200 -0
  608. package/skills/productivity/grill-me/SKILL.md +10 -0
  609. package/skills/productivity/grill-with-docs/ADR-FORMAT.md +47 -0
  610. package/skills/productivity/grill-with-docs/CONTEXT-FORMAT.md +77 -0
  611. package/skills/productivity/grill-with-docs/SKILL.md +88 -0
  612. package/skills/productivity/parallel-agents/SKILL.md +175 -0
  613. package/skills/productivity/plan-writing/SKILL.md +152 -0
  614. package/skills/productivity/receiving-code-review/SKILL.md +213 -0
  615. package/skills/productivity/requesting-code-review/SKILL.md +105 -0
  616. package/skills/productivity/requesting-code-review/code-reviewer.md +146 -0
  617. package/skills/productivity/subagent-driven-development/SKILL.md +242 -0
  618. package/skills/productivity/subagent-driven-development/code-quality-reviewer-prompt.md +20 -0
  619. package/skills/productivity/subagent-driven-development/implementer-prompt.md +78 -0
  620. package/skills/productivity/subagent-driven-development/spec-reviewer-prompt.md +61 -0
  621. package/skills/productivity/test-driven-development/SKILL.md +371 -0
  622. package/skills/productivity/test-driven-development/testing-anti-patterns.md +299 -0
  623. package/skills/productivity/using-git-worktrees/SKILL.md +218 -0
  624. package/skills/productivity/using-superpowers/SKILL.md +114 -0
  625. package/skills/productivity/verification-before-completion/SKILL.md +139 -0
  626. package/skills/productivity/writing-plans/SKILL.md +116 -0
  627. package/skills/productivity/writing-skills/SKILL.md +655 -0
  628. package/skills/productivity/writing-skills/anthropic-best-practices.md +1150 -0
  629. package/skills/productivity/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  630. package/skills/productivity/writing-skills/graphviz-conventions.dot +172 -0
  631. package/skills/productivity/writing-skills/persuasion-principles.md +187 -0
  632. package/skills/productivity/writing-skills/render-graphs.js +168 -0
  633. package/skills/productivity/writing-skills/testing-skills-with-subagents.md +384 -0
  634. package/skills/productivity/zoom-out/SKILL.md +7 -0
  635. package/skills/security/red-team-tactics/SKILL.md +199 -0
  636. package/skills/writing-docs/behavioral-modes/SKILL.md +242 -0
  637. package/skills/writing-docs/doc/LICENSE.txt +201 -0
  638. package/skills/writing-docs/doc/SKILL.md +80 -0
  639. package/skills/writing-docs/doc/agents/openai.yaml +6 -0
  640. package/skills/writing-docs/doc/assets/doc-small.svg +3 -0
  641. package/skills/writing-docs/doc/assets/doc.png +0 -0
  642. package/skills/writing-docs/doc/scripts/render_docx.py +296 -0
  643. package/skills/writing-docs/documentation-templates/SKILL.md +194 -0
  644. package/skills/writing-docs/docx/LICENSE.txt +30 -0
  645. package/skills/writing-docs/docx/SKILL.md +197 -0
  646. package/skills/writing-docs/docx/docx-js.md +350 -0
  647. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  648. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  649. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  650. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  651. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  652. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  653. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  654. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  655. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  656. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  657. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  658. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  659. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  660. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  661. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  662. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  663. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  664. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  665. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  666. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  667. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  668. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  669. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  670. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  671. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  672. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  673. package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  674. package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  675. package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  676. package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  677. package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  678. package/skills/writing-docs/docx/ooxml/schemas/mce/mc.xsd +75 -0
  679. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
  680. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
  681. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
  682. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
  683. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
  684. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  685. package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
  686. package/skills/writing-docs/docx/ooxml/scripts/pack.py +159 -0
  687. package/skills/writing-docs/docx/ooxml/scripts/unpack.py +29 -0
  688. package/skills/writing-docs/docx/ooxml/scripts/validate.py +69 -0
  689. package/skills/writing-docs/docx/ooxml/scripts/validation/__init__.py +15 -0
  690. package/skills/writing-docs/docx/ooxml/scripts/validation/base.py +951 -0
  691. package/skills/writing-docs/docx/ooxml/scripts/validation/docx.py +274 -0
  692. package/skills/writing-docs/docx/ooxml/scripts/validation/pptx.py +315 -0
  693. package/skills/writing-docs/docx/ooxml/scripts/validation/redlining.py +279 -0
  694. package/skills/writing-docs/docx/ooxml.md +610 -0
  695. package/skills/writing-docs/docx/scripts/__init__.py +1 -0
  696. package/skills/writing-docs/docx/scripts/document.py +1276 -0
  697. package/skills/writing-docs/docx/scripts/templates/comments.xml +3 -0
  698. package/skills/writing-docs/docx/scripts/templates/commentsExtended.xml +3 -0
  699. package/skills/writing-docs/docx/scripts/templates/commentsExtensible.xml +3 -0
  700. package/skills/writing-docs/docx/scripts/templates/commentsIds.xml +3 -0
  701. package/skills/writing-docs/docx/scripts/templates/people.xml +3 -0
  702. package/skills/writing-docs/docx/scripts/utilities.py +374 -0
  703. package/skills/writing-docs/mermaidjs-v11/SKILL.md +115 -0
  704. package/skills/writing-docs/mermaidjs-v11/references/cli-usage.md +228 -0
  705. package/skills/writing-docs/mermaidjs-v11/references/configuration.md +232 -0
  706. package/skills/writing-docs/mermaidjs-v11/references/diagram-types.md +315 -0
  707. package/skills/writing-docs/mermaidjs-v11/references/examples.md +344 -0
  708. package/skills/writing-docs/mermaidjs-v11/references/integration.md +310 -0
  709. package/skills/writing-docs/pdf/LICENSE.txt +30 -0
  710. package/skills/writing-docs/pdf/SKILL.md +294 -0
  711. package/skills/writing-docs/pdf/forms.md +205 -0
  712. package/skills/writing-docs/pdf/reference.md +612 -0
  713. package/skills/writing-docs/pdf/scripts/check_bounding_boxes.py +70 -0
  714. package/skills/writing-docs/pdf/scripts/check_bounding_boxes_test.py +226 -0
  715. package/skills/writing-docs/pdf/scripts/check_fillable_fields.py +12 -0
  716. package/skills/writing-docs/pdf/scripts/convert_pdf_to_images.py +35 -0
  717. package/skills/writing-docs/pdf/scripts/create_validation_image.py +41 -0
  718. package/skills/writing-docs/pdf/scripts/extract_form_field_info.py +152 -0
  719. package/skills/writing-docs/pdf/scripts/fill_fillable_fields.py +114 -0
  720. package/skills/writing-docs/pdf/scripts/fill_pdf_form_with_annotations.py +108 -0
  721. package/skills/writing-docs/pptx/LICENSE.txt +30 -0
  722. package/skills/writing-docs/pptx/SKILL.md +484 -0
  723. package/skills/writing-docs/pptx/html2pptx.md +625 -0
  724. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  725. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  726. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  727. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  728. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  729. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  730. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  731. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  732. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  733. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  734. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  735. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  736. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  737. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  738. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  739. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  740. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  741. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  742. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  743. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  744. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  745. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  746. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  747. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  748. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  749. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  750. package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  751. package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  752. package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  753. package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  754. package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  755. package/skills/writing-docs/pptx/ooxml/schemas/mce/mc.xsd +75 -0
  756. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
  757. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
  758. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
  759. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
  760. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
  761. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  762. package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
  763. package/skills/writing-docs/pptx/ooxml/scripts/pack.py +159 -0
  764. package/skills/writing-docs/pptx/ooxml/scripts/unpack.py +29 -0
  765. package/skills/writing-docs/pptx/ooxml/scripts/validate.py +69 -0
  766. package/skills/writing-docs/pptx/ooxml/scripts/validation/__init__.py +15 -0
  767. package/skills/writing-docs/pptx/ooxml/scripts/validation/base.py +951 -0
  768. package/skills/writing-docs/pptx/ooxml/scripts/validation/docx.py +274 -0
  769. package/skills/writing-docs/pptx/ooxml/scripts/validation/pptx.py +315 -0
  770. package/skills/writing-docs/pptx/ooxml/scripts/validation/redlining.py +279 -0
  771. package/skills/writing-docs/pptx/ooxml.md +427 -0
  772. package/skills/writing-docs/pptx/scripts/html2pptx.js +979 -0
  773. package/skills/writing-docs/pptx/scripts/inventory.py +1020 -0
  774. package/skills/writing-docs/pptx/scripts/rearrange.py +231 -0
  775. package/skills/writing-docs/pptx/scripts/replace.py +385 -0
  776. package/skills/writing-docs/pptx/scripts/thumbnail.py +450 -0
  777. package/skills/writing-docs/slides/LICENSE.txt +201 -0
  778. package/skills/writing-docs/slides/SKILL.md +71 -0
  779. package/skills/writing-docs/slides/agents/openai.yaml +6 -0
  780. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/code.js +104 -0
  781. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/image.js +333 -0
  782. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/index.js +33 -0
  783. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/latex.js +51 -0
  784. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/layout.js +643 -0
  785. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/layout_builders.js +358 -0
  786. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/svg.js +36 -0
  787. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/text.js +789 -0
  788. package/skills/writing-docs/slides/assets/pptxgenjs_helpers/util.js +24 -0
  789. package/skills/writing-docs/slides/assets/slides-small.svg +3 -0
  790. package/skills/writing-docs/slides/assets/slides.png +0 -0
  791. package/skills/writing-docs/slides/references/pptxgenjs-helpers.md +61 -0
  792. package/skills/writing-docs/slides/scripts/create_montage.py +300 -0
  793. package/skills/writing-docs/slides/scripts/detect_font.py +873 -0
  794. package/skills/writing-docs/slides/scripts/ensure_raster_image.py +202 -0
  795. package/skills/writing-docs/slides/scripts/render_slides.py +273 -0
  796. package/skills/writing-docs/slides/scripts/slides_test.py +201 -0
  797. package/skills/writing-docs/template-skill/SKILL.md +26 -0
  798. package/skills/writing-docs/templates/SKILL.md +39 -0
  799. package/skills/writing-docs/templates/astro-static/TEMPLATE.md +76 -0
  800. package/skills/writing-docs/templates/chrome-extension/TEMPLATE.md +92 -0
  801. package/skills/writing-docs/templates/cli-tool/TEMPLATE.md +88 -0
  802. package/skills/writing-docs/templates/electron-desktop/TEMPLATE.md +88 -0
  803. package/skills/writing-docs/templates/express-api/TEMPLATE.md +83 -0
  804. package/skills/writing-docs/templates/flutter-app/TEMPLATE.md +90 -0
  805. package/skills/writing-docs/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  806. package/skills/writing-docs/templates/nextjs-fullstack/TEMPLATE.md +82 -0
  807. package/skills/writing-docs/templates/nextjs-saas/TEMPLATE.md +100 -0
  808. package/skills/writing-docs/templates/nextjs-static/TEMPLATE.md +106 -0
  809. package/skills/writing-docs/templates/nuxt-app/TEMPLATE.md +101 -0
  810. package/skills/writing-docs/templates/python-fastapi/TEMPLATE.md +83 -0
  811. package/skills/writing-docs/templates/react-native-app/TEMPLATE.md +93 -0
  812. package/skills/writing-docs/xlsx/LICENSE.txt +30 -0
  813. package/skills/writing-docs/xlsx/SKILL.md +289 -0
  814. package/skills/writing-docs/xlsx/recalc.py +178 -0
  815. package/src/core/KILO_MASTER.md +455 -0
  816. package/src/tools/validate-skill.js +465 -0
@@ -0,0 +1,267 @@
1
+ ---
2
+ name: "screenshot"
3
+ description: "Use when the user explicitly asks for a desktop or system screenshot (full screen, specific app or window, or a pixel region), or when tool-specific capture capabilities are unavailable and an OS-level capture is needed."
4
+ ---
5
+
6
+
7
+ # Screenshot Capture
8
+
9
+ Follow these save-location rules every time:
10
+
11
+ 1) If the user specifies a path, save there.
12
+ 2) If the user asks for a screenshot without a path, save to the OS default screenshot location.
13
+ 3) If Codex needs a screenshot for its own inspection, save to the temp directory.
14
+
15
+ ## Tool priority
16
+
17
+ - Prefer tool-specific screenshot capabilities when available (for example: a Figma MCP/skill for Figma files, or Playwright/agent-browser tools for browsers and Electron apps).
18
+ - Use this skill when explicitly asked, for whole-system desktop captures, or when a tool-specific capture cannot get what you need.
19
+ - Otherwise, treat this skill as the default for desktop apps without a better-integrated capture tool.
20
+
21
+ ## macOS permission preflight (reduce repeated prompts)
22
+
23
+ On macOS, run the preflight helper once before window/app capture. It checks
24
+ Screen Recording permission, explains why it is needed, and requests it in one
25
+ place.
26
+
27
+ The helpers route Swift's module cache to `$TMPDIR/codex-swift-module-cache`
28
+ to avoid extra sandbox module-cache prompts.
29
+
30
+ ```bash
31
+ bash <path-to-skill>/scripts/ensure_macos_permissions.sh
32
+ ```
33
+
34
+ To avoid multiple sandbox approval prompts, combine preflight + capture in one
35
+ command when possible:
36
+
37
+ ```bash
38
+ bash <path-to-skill>/scripts/ensure_macos_permissions.sh && \
39
+ python3 <path-to-skill>/scripts/take_screenshot.py --app "Codex"
40
+ ```
41
+
42
+ For Codex inspection runs, keep the output in temp:
43
+
44
+ ```bash
45
+ bash <path-to-skill>/scripts/ensure_macos_permissions.sh && \
46
+ python3 <path-to-skill>/scripts/take_screenshot.py --app "<App>" --mode temp
47
+ ```
48
+
49
+ Use the bundled scripts to avoid re-deriving OS-specific commands.
50
+
51
+ ## macOS and Linux (Python helper)
52
+
53
+ Run the helper from the repo root:
54
+
55
+ ```bash
56
+ python3 <path-to-skill>/scripts/take_screenshot.py
57
+ ```
58
+
59
+ Common patterns:
60
+
61
+ - Default location (user asked for "a screenshot"):
62
+
63
+ ```bash
64
+ python3 <path-to-skill>/scripts/take_screenshot.py
65
+ ```
66
+
67
+ - Temp location (Codex visual check):
68
+
69
+ ```bash
70
+ python3 <path-to-skill>/scripts/take_screenshot.py --mode temp
71
+ ```
72
+
73
+ - Explicit location (user provided a path or filename):
74
+
75
+ ```bash
76
+ python3 <path-to-skill>/scripts/take_screenshot.py --path output/screen.png
77
+ ```
78
+
79
+ - App/window capture by app name (macOS only; substring match is OK; captures all matching windows):
80
+
81
+ ```bash
82
+ python3 <path-to-skill>/scripts/take_screenshot.py --app "Codex"
83
+ ```
84
+
85
+ - Specific window title within an app (macOS only):
86
+
87
+ ```bash
88
+ python3 <path-to-skill>/scripts/take_screenshot.py --app "Codex" --window-name "Settings"
89
+ ```
90
+
91
+ - List matching window ids before capturing (macOS only):
92
+
93
+ ```bash
94
+ python3 <path-to-skill>/scripts/take_screenshot.py --list-windows --app "Codex"
95
+ ```
96
+
97
+ - Pixel region (x,y,w,h):
98
+
99
+ ```bash
100
+ python3 <path-to-skill>/scripts/take_screenshot.py --mode temp --region 100,200,800,600
101
+ ```
102
+
103
+ - Focused/active window (captures only the frontmost window; use `--app` to capture all windows):
104
+
105
+ ```bash
106
+ python3 <path-to-skill>/scripts/take_screenshot.py --mode temp --active-window
107
+ ```
108
+
109
+ - Specific window id (use --list-windows on macOS to discover ids):
110
+
111
+ ```bash
112
+ python3 <path-to-skill>/scripts/take_screenshot.py --window-id 12345
113
+ ```
114
+
115
+ The script prints one path per capture. When multiple windows or displays match, it prints multiple paths (one per line) and adds suffixes like `-w<windowId>` or `-d<display>`. View each path sequentially with the image viewer tool, and only manipulate images if needed or requested.
116
+
117
+ ### Workflow examples
118
+
119
+ - "Take a look at <App> and tell me what you see": capture to temp, then view each printed path in order.
120
+
121
+ ```bash
122
+ bash <path-to-skill>/scripts/ensure_macos_permissions.sh && \
123
+ python3 <path-to-skill>/scripts/take_screenshot.py --app "<App>" --mode temp
124
+ ```
125
+
126
+ - "The design from Figma is not matching what is implemented": use a Figma MCP/skill to capture the design first, then capture the running app with this skill (typically to temp) and compare the raw screenshots before any manipulation.
127
+
128
+ ### Multi-display behavior
129
+
130
+ - On macOS, full-screen captures save one file per display when multiple monitors are connected.
131
+ - On Linux and Windows, full-screen captures use the virtual desktop (all monitors in one image); use `--region` to isolate a single display when needed.
132
+
133
+ ### Linux prerequisites and selection logic
134
+
135
+ The helper automatically selects the first available tool:
136
+
137
+ 1) `scrot`
138
+ 2) `gnome-screenshot`
139
+ 3) ImageMagick `import`
140
+
141
+ If none are available, ask the user to install one of them and retry.
142
+
143
+ Coordinate regions require `scrot` or ImageMagick `import`.
144
+
145
+ `--app`, `--window-name`, and `--list-windows` are macOS-only. On Linux, use
146
+ `--active-window` or provide `--window-id` when available.
147
+
148
+ ## Windows (PowerShell helper)
149
+
150
+ Run the PowerShell helper:
151
+
152
+ ```powershell
153
+ powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1
154
+ ```
155
+
156
+ Common patterns:
157
+
158
+ - Default location:
159
+
160
+ ```powershell
161
+ powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1
162
+ ```
163
+
164
+ - Temp location (Codex visual check):
165
+
166
+ ```powershell
167
+ powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1 -Mode temp
168
+ ```
169
+
170
+ - Explicit path:
171
+
172
+ ```powershell
173
+ powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1 -Path "C:\Temp\screen.png"
174
+ ```
175
+
176
+ - Pixel region (x,y,w,h):
177
+
178
+ ```powershell
179
+ powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1 -Mode temp -Region 100,200,800,600
180
+ ```
181
+
182
+ - Active window (ask the user to focus it first):
183
+
184
+ ```powershell
185
+ powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1 -Mode temp -ActiveWindow
186
+ ```
187
+
188
+ - Specific window handle (only when provided):
189
+
190
+ ```powershell
191
+ powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1 -WindowHandle 123456
192
+ ```
193
+
194
+ ## Direct OS commands (fallbacks)
195
+
196
+ Use these when you cannot run the helpers.
197
+
198
+ ### macOS
199
+
200
+ - Full screen to a specific path:
201
+
202
+ ```bash
203
+ screencapture -x output/screen.png
204
+ ```
205
+
206
+ - Pixel region:
207
+
208
+ ```bash
209
+ screencapture -x -R100,200,800,600 output/region.png
210
+ ```
211
+
212
+ - Specific window id:
213
+
214
+ ```bash
215
+ screencapture -x -l12345 output/window.png
216
+ ```
217
+
218
+ - Interactive selection or window pick:
219
+
220
+ ```bash
221
+ screencapture -x -i output/interactive.png
222
+ ```
223
+
224
+ ### Linux
225
+
226
+ - Full screen:
227
+
228
+ ```bash
229
+ scrot output/screen.png
230
+ ```
231
+
232
+ ```bash
233
+ gnome-screenshot -f output/screen.png
234
+ ```
235
+
236
+ ```bash
237
+ import -window root output/screen.png
238
+ ```
239
+
240
+ - Pixel region:
241
+
242
+ ```bash
243
+ scrot -a 100,200,800,600 output/region.png
244
+ ```
245
+
246
+ ```bash
247
+ import -window root -crop 800x600+100+200 output/region.png
248
+ ```
249
+
250
+ - Active window:
251
+
252
+ ```bash
253
+ scrot -u output/window.png
254
+ ```
255
+
256
+ ```bash
257
+ gnome-screenshot -w -f output/window.png
258
+ ```
259
+
260
+ ## Error handling
261
+
262
+ - On macOS, run `bash <path-to-skill>/scripts/ensure_macos_permissions.sh` first to request Screen Recording in one place.
263
+ - If you see "screen capture checks are blocked in the sandbox", "could not create image from display", or Swift `ModuleCache` permission errors in a sandboxed run, rerun the command with escalated permissions.
264
+ - If macOS app/window capture returns no matches, run `--list-windows --app "AppName"` and retry with `--window-id`, and make sure the app is visible on screen.
265
+ - If Linux region/window capture fails, check tool availability with `command -v scrot`, `command -v gnome-screenshot`, and `command -v import`.
266
+ - If saving to the OS default location fails with permission errors in a sandbox, rerun the command with escalated permissions.
267
+ - Always report the saved file path in the response.
@@ -0,0 +1,6 @@
1
+ interface:
2
+ display_name: "Screenshot Capture"
3
+ short_description: "Capture screenshots"
4
+ icon_small: "./assets/screenshot-small.svg"
5
+ icon_large: "./assets/screenshot.png"
6
+ default_prompt: "Capture the right screenshot for this task (target, area, and output path)."
@@ -0,0 +1,5 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
2
+ <path fill="currentColor" d="M2.666 10.134c.294 0 .532.239.532.532v.667c0 .81.658 1.468 1.468 1.468h.667l.108.01a.533.533 0 0 1 0 1.043l-.108.01h-.667a2.532 2.532 0 0 1-2.532-2.531v-.667c0-.293.239-.532.532-.532Zm10.667 0c.293 0 .532.239.532.532v.667a2.532 2.532 0 0 1-2.532 2.532h-.667a.532.532 0 0 1 0-1.064h.667c.81 0 1.468-.657 1.468-1.468v-.667c0-.293.238-.531.532-.532Z"/>
3
+ <path fill="currentColor" fill-rule="evenodd" d="M8 5.468a2.532 2.532 0 1 1 0 5.064 2.532 2.532 0 0 1 0-5.064Zm0 1.064a1.468 1.468 0 1 0 0 2.936 1.468 1.468 0 0 0 0-2.936Z" clip-rule="evenodd"/>
4
+ <path fill="currentColor" d="M5.44 2.145a.532.532 0 0 1 0 1.043l-.107.01h-.667a1.47 1.47 0 0 0-1.468 1.468v.667a.532.532 0 0 1-1.064 0v-.667a2.532 2.532 0 0 1 2.532-2.532h.667l.108.011Zm5.893-.011a2.532 2.532 0 0 1 2.532 2.532v.667a.532.532 0 0 1-1.064 0v-.667c0-.81-.658-1.468-1.468-1.468h-.667a.532.532 0 0 1 0-1.064h.667Z"/>
5
+ </svg>
@@ -0,0 +1,54 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+
4
+ if [[ "$(uname)" != "Darwin" ]]; then
5
+ echo "ensure_macos_permissions.sh only supports macOS" >&2
6
+ exit 1
7
+ fi
8
+
9
+ if ! command -v swift >/dev/null 2>&1; then
10
+ echo "swift is required to check macOS screen capture permissions" >&2
11
+ exit 1
12
+ fi
13
+
14
+ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
15
+ PERM_SWIFT="$SCRIPT_DIR/macos_permissions.swift"
16
+ MODULE_CACHE="${TMPDIR:-/tmp}/codex-swift-module-cache"
17
+ mkdir -p "$MODULE_CACHE"
18
+
19
+ screen_capture_status() {
20
+ local json
21
+ json="$(swift -module-cache-path "$MODULE_CACHE" "$PERM_SWIFT" "$@")"
22
+ python3 -c 'import json, sys; data=json.loads(sys.argv[1]); print("1" if data.get("screenCapture") else "0")' "$json"
23
+ }
24
+
25
+ if [[ -n "${CODEX_SANDBOX:-}" ]]; then
26
+ echo "Screen capture checks are blocked in the sandbox; rerun with escalated permissions." >&2
27
+ exit 3
28
+ fi
29
+
30
+ if [[ "$(screen_capture_status)" == "1" ]]; then
31
+ echo "Screen Recording permission already granted."
32
+ exit 0
33
+ fi
34
+
35
+ cat <<'MSG'
36
+ This workflow needs macOS Screen Recording permission to capture screenshots.
37
+ macOS will show a single system prompt for Screen Recording. Approve it, then
38
+ return here. If macOS opens System Settings instead of prompting, enable Screen
39
+ Recording for your terminal and rerun the command.
40
+ MSG
41
+
42
+ # Request permission once after explaining why it is needed.
43
+ screen_capture_status --request >/dev/null || true
44
+
45
+ if [[ "$(screen_capture_status)" != "1" ]]; then
46
+ cat <<'MSG'
47
+ Screen Recording is still not granted.
48
+ Open System Settings > Privacy & Security > Screen Recording and enable it for
49
+ your terminal (and Codex if needed), then rerun your screenshot command.
50
+ MSG
51
+ exit 2
52
+ fi
53
+
54
+ echo "Screen Recording permission granted."
@@ -0,0 +1,22 @@
1
+ import AppKit
2
+ import Foundation
3
+
4
+ struct Response: Encodable {
5
+ let count: Int
6
+ let displays: [Int]
7
+ }
8
+
9
+ let count = max(NSScreen.screens.count, 1)
10
+ let displays = Array(1...count)
11
+
12
+ let response = Response(count: count, displays: displays)
13
+ let encoder = JSONEncoder()
14
+ encoder.outputFormatting = [.sortedKeys]
15
+
16
+ if let data = try? encoder.encode(response),
17
+ let json = String(data: data, encoding: .utf8) {
18
+ print(json)
19
+ } else {
20
+ fputs("{\"count\":\(count)}\n", stderr)
21
+ exit(1)
22
+ }
@@ -0,0 +1,40 @@
1
+ import CoreGraphics
2
+ import Foundation
3
+
4
+ struct Status: Encodable {
5
+ let screenCapture: Bool
6
+ let requested: Bool
7
+ }
8
+
9
+ let shouldRequest = CommandLine.arguments.contains("--request")
10
+
11
+ @available(macOS 10.15, *)
12
+ func screenCaptureGranted(request: Bool) -> Bool {
13
+ if CGPreflightScreenCaptureAccess() {
14
+ return true
15
+ }
16
+ if request {
17
+ _ = CGRequestScreenCaptureAccess()
18
+ return CGPreflightScreenCaptureAccess()
19
+ }
20
+ return false
21
+ }
22
+
23
+ let granted: Bool
24
+ if #available(macOS 10.15, *) {
25
+ granted = screenCaptureGranted(request: shouldRequest)
26
+ } else {
27
+ granted = true
28
+ }
29
+
30
+ let status = Status(screenCapture: granted, requested: shouldRequest)
31
+ let encoder = JSONEncoder()
32
+ encoder.outputFormatting = [.sortedKeys]
33
+
34
+ if let data = try? encoder.encode(status),
35
+ let json = String(data: data, encoding: .utf8) {
36
+ print(json)
37
+ } else {
38
+ fputs("{\"requested\":\(shouldRequest),\"screenCapture\":\(granted)}\n", stderr)
39
+ exit(1)
40
+ }
@@ -0,0 +1,126 @@
1
+ import AppKit
2
+ import CoreGraphics
3
+ import Foundation
4
+
5
+ struct Bounds: Encodable {
6
+ let x: Int
7
+ let y: Int
8
+ let width: Int
9
+ let height: Int
10
+ }
11
+
12
+ struct WindowInfo: Encodable {
13
+ let id: Int
14
+ let owner: String
15
+ let name: String
16
+ let layer: Int
17
+ let bounds: Bounds
18
+ let area: Int
19
+ }
20
+
21
+ struct Response: Encodable {
22
+ let count: Int
23
+ let selected: WindowInfo?
24
+ let windows: [WindowInfo]?
25
+ }
26
+
27
+ func value(for flag: String) -> String? {
28
+ guard let idx = CommandLine.arguments.firstIndex(of: flag) else {
29
+ return nil
30
+ }
31
+ let next = CommandLine.arguments.index(after: idx)
32
+ guard next < CommandLine.arguments.endIndex else {
33
+ return nil
34
+ }
35
+ return CommandLine.arguments[next]
36
+ }
37
+
38
+ let frontmostFlag = CommandLine.arguments.contains("--frontmost")
39
+ let explicitApp = value(for: "--app")
40
+ let frontmostName = frontmostFlag ? NSWorkspace.shared.frontmostApplication?.localizedName : nil
41
+ if frontmostFlag && frontmostName == nil {
42
+ fputs("{\"count\":0}\n", stderr)
43
+ exit(1)
44
+ }
45
+ let appFilter = (explicitApp ?? frontmostName)?.lowercased()
46
+ let nameFilter = value(for: "--window-name")?.lowercased()
47
+ let includeList = CommandLine.arguments.contains("--list")
48
+
49
+ let options: CGWindowListOption = [.optionOnScreenOnly, .excludeDesktopElements]
50
+ guard let raw = CGWindowListCopyWindowInfo(options, kCGNullWindowID) as? [[String: Any]] else {
51
+ fputs("{\"count\":0}\n", stderr)
52
+ exit(1)
53
+ }
54
+
55
+ var exactMatches: [WindowInfo] = []
56
+ var partialMatches: [WindowInfo] = []
57
+ exactMatches.reserveCapacity(raw.count)
58
+ partialMatches.reserveCapacity(raw.count)
59
+
60
+ for entry in raw {
61
+ guard let owner = entry[kCGWindowOwnerName as String] as? String else { continue }
62
+ let ownerLower = owner.lowercased()
63
+ if let appFilter, !ownerLower.contains(appFilter) { continue }
64
+
65
+ let name = (entry[kCGWindowName as String] as? String) ?? ""
66
+ if let nameFilter, !name.lowercased().contains(nameFilter) { continue }
67
+
68
+ guard let number = entry[kCGWindowNumber as String] as? Int else { continue }
69
+ let layer = (entry[kCGWindowLayer as String] as? Int) ?? 0
70
+
71
+ guard let boundsDict = entry[kCGWindowBounds as String] as? [String: Any] else { continue }
72
+ let x = Int((boundsDict["X"] as? Double) ?? 0)
73
+ let y = Int((boundsDict["Y"] as? Double) ?? 0)
74
+ let width = Int((boundsDict["Width"] as? Double) ?? 0)
75
+ let height = Int((boundsDict["Height"] as? Double) ?? 0)
76
+ if width <= 0 || height <= 0 { continue }
77
+
78
+ let bounds = Bounds(x: x, y: y, width: width, height: height)
79
+ let area = width * height
80
+ let info = WindowInfo(id: number, owner: owner, name: name, layer: layer, bounds: bounds, area: area)
81
+ if let appFilter, ownerLower == appFilter {
82
+ exactMatches.append(info)
83
+ } else {
84
+ partialMatches.append(info)
85
+ }
86
+ }
87
+
88
+ let windows: [WindowInfo]
89
+ if appFilter != nil && !exactMatches.isEmpty {
90
+ windows = exactMatches
91
+ } else {
92
+ windows = partialMatches
93
+ }
94
+
95
+ func rank(_ window: WindowInfo) -> (Int, Int) {
96
+ // Prefer normal-layer windows, then larger area.
97
+ let layerScore = window.layer == 0 ? 0 : 1
98
+ return (layerScore, -window.area)
99
+ }
100
+
101
+ let ordered: [WindowInfo]
102
+ if frontmostFlag {
103
+ ordered = windows
104
+ } else {
105
+ ordered = windows.sorted { rank($0) < rank($1) }
106
+ }
107
+ let selected = ordered.first
108
+
109
+ let list: [WindowInfo]?
110
+ if includeList {
111
+ list = ordered
112
+ } else {
113
+ list = nil
114
+ }
115
+
116
+ let response = Response(count: windows.count, selected: selected, windows: list)
117
+ let encoder = JSONEncoder()
118
+ encoder.outputFormatting = [.sortedKeys]
119
+
120
+ if let data = try? encoder.encode(response),
121
+ let json = String(data: data, encoding: .utf8) {
122
+ print(json)
123
+ } else {
124
+ fputs("{\"count\":\(windows.count)}\n", stderr)
125
+ exit(1)
126
+ }
@@ -0,0 +1,163 @@
1
+ param(
2
+ [string]$Path,
3
+ [ValidateSet("default", "temp")][string]$Mode = "default",
4
+ [string]$Format = "png",
5
+ [string]$Region,
6
+ [switch]$ActiveWindow,
7
+ [int]$WindowHandle
8
+ )
9
+
10
+ Set-StrictMode -Version Latest
11
+ $ErrorActionPreference = "Stop"
12
+
13
+ function Get-Timestamp {
14
+ Get-Date -Format "yyyy-MM-dd_HH-mm-ss"
15
+ }
16
+
17
+ function Get-DefaultDirectory {
18
+ $home = [Environment]::GetFolderPath("UserProfile")
19
+ $pictures = Join-Path $home "Pictures"
20
+ $screenshots = Join-Path $pictures "Screenshots"
21
+ if (Test-Path $screenshots) { return $screenshots }
22
+ if (Test-Path $pictures) { return $pictures }
23
+ return $home
24
+ }
25
+
26
+ function New-DefaultFilename {
27
+ param([string]$Prefix)
28
+ if (-not $Prefix) { $Prefix = "screenshot" }
29
+ "$Prefix-$(Get-Timestamp).$Format"
30
+ }
31
+
32
+ function Resolve-OutputPath {
33
+ if ($Path) {
34
+ $expanded = [Environment]::ExpandEnvironmentVariables($Path)
35
+ $homeDir = [Environment]::GetFolderPath("UserProfile")
36
+ if ($expanded -eq "~") {
37
+ $expanded = $homeDir
38
+ } elseif ($expanded.StartsWith("~/") -or $expanded.StartsWith("~\\")) {
39
+ $expanded = Join-Path $homeDir $expanded.Substring(2)
40
+ }
41
+ $full = [System.IO.Path]::GetFullPath($expanded)
42
+ if ((Test-Path $full) -and (Get-Item $full).PSIsContainer) {
43
+ $full = Join-Path $full (New-DefaultFilename "")
44
+ } elseif (($expanded.EndsWith("\") -or $expanded.EndsWith("/")) -and -not (Test-Path $full)) {
45
+ New-Item -ItemType Directory -Path $full -Force | Out-Null
46
+ $full = Join-Path $full (New-DefaultFilename "")
47
+ } elseif ([System.IO.Path]::GetExtension($full) -eq "") {
48
+ $full = "$full.$Format"
49
+ }
50
+ $parent = Split-Path -Parent $full
51
+ if ($parent) {
52
+ New-Item -ItemType Directory -Path $parent -Force | Out-Null
53
+ }
54
+ return $full
55
+ }
56
+
57
+ if ($Mode -eq "temp") {
58
+ $tmp = [System.IO.Path]::GetTempPath()
59
+ return Join-Path $tmp (New-DefaultFilename "codex-shot")
60
+ }
61
+
62
+ $dest = Get-DefaultDirectory
63
+ return Join-Path $dest (New-DefaultFilename "")
64
+ }
65
+
66
+ function Parse-Region {
67
+ if (-not $Region) { return $null }
68
+ $parts = $Region.Split(",") | ForEach-Object { $_.Trim() }
69
+ if ($parts.Length -ne 4) {
70
+ throw "Region must be x,y,w,h"
71
+ }
72
+ $values = $parts | ForEach-Object {
73
+ $out = 0
74
+ if (-not [int]::TryParse($_, [ref]$out)) {
75
+ throw "Region values must be integers"
76
+ }
77
+ $out
78
+ }
79
+ if ($values[2] -le 0 -or $values[3] -le 0) {
80
+ throw "Region width and height must be positive"
81
+ }
82
+ return $values
83
+ }
84
+
85
+ if ($Region -and $ActiveWindow) {
86
+ throw "Choose either -Region or -ActiveWindow"
87
+ }
88
+ if ($Region -and $WindowHandle) {
89
+ throw "Choose either -Region or -WindowHandle"
90
+ }
91
+ if ($ActiveWindow -and $WindowHandle) {
92
+ throw "Choose either -ActiveWindow or -WindowHandle"
93
+ }
94
+
95
+ $regionValues = Parse-Region
96
+ $outputPath = Resolve-OutputPath
97
+
98
+ Add-Type -AssemblyName System.Windows.Forms
99
+ Add-Type -AssemblyName System.Drawing
100
+
101
+ $imageFormat = switch ($Format.ToLowerInvariant()) {
102
+ "png" { [System.Drawing.Imaging.ImageFormat]::Png }
103
+ "jpg" { [System.Drawing.Imaging.ImageFormat]::Jpeg }
104
+ "jpeg" { [System.Drawing.Imaging.ImageFormat]::Jpeg }
105
+ "bmp" { [System.Drawing.Imaging.ImageFormat]::Bmp }
106
+ default { throw "Unsupported format: $Format" }
107
+ }
108
+
109
+ Add-Type @"
110
+ using System;
111
+ using System.Runtime.InteropServices;
112
+ public static class NativeMethods {
113
+ [StructLayout(LayoutKind.Sequential)]
114
+ public struct RECT {
115
+ public int Left;
116
+ public int Top;
117
+ public int Right;
118
+ public int Bottom;
119
+ }
120
+
121
+ [DllImport("user32.dll")]
122
+ public static extern IntPtr GetForegroundWindow();
123
+
124
+ [DllImport("user32.dll")]
125
+ public static extern bool GetWindowRect(IntPtr hWnd, out RECT rect);
126
+ }
127
+ "@
128
+
129
+ if ($regionValues) {
130
+ $x = $regionValues[0]
131
+ $y = $regionValues[1]
132
+ $w = $regionValues[2]
133
+ $h = $regionValues[3]
134
+ $bounds = New-Object System.Drawing.Rectangle($x, $y, $w, $h)
135
+ } elseif ($ActiveWindow -or $WindowHandle) {
136
+ $handle = if ($WindowHandle) { [IntPtr]$WindowHandle } else { [NativeMethods]::GetForegroundWindow() }
137
+ $rect = New-Object NativeMethods+RECT
138
+ if (-not [NativeMethods]::GetWindowRect($handle, [ref]$rect)) {
139
+ throw "Failed to get window bounds"
140
+ }
141
+ $width = $rect.Right - $rect.Left
142
+ $height = $rect.Bottom - $rect.Top
143
+ $bounds = New-Object System.Drawing.Rectangle($rect.Left, $rect.Top, $width, $height)
144
+ } else {
145
+ $vs = [System.Windows.Forms.SystemInformation]::VirtualScreen
146
+ $bounds = New-Object System.Drawing.Rectangle($vs.Left, $vs.Top, $vs.Width, $vs.Height)
147
+ }
148
+
149
+ $bitmap = New-Object System.Drawing.Bitmap($bounds.Width, $bounds.Height)
150
+ $graphics = [System.Drawing.Graphics]::FromImage($bitmap)
151
+
152
+ try {
153
+ $source = New-Object System.Drawing.Point($bounds.Left, $bounds.Top)
154
+ $target = [System.Drawing.Point]::Empty
155
+ $size = New-Object System.Drawing.Size($bounds.Width, $bounds.Height)
156
+ $graphics.CopyFromScreen($source, $target, $size)
157
+ $bitmap.Save($outputPath, $imageFormat)
158
+ } finally {
159
+ $graphics.Dispose()
160
+ $bitmap.Dispose()
161
+ }
162
+
163
+ Write-Output $outputPath