@trieungoctam/vibekit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (352) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +85 -0
  3. package/agents/debugger.md +158 -0
  4. package/agents/docs-manager.md +220 -0
  5. package/agents/planner.md +129 -0
  6. package/agents/researcher.md +58 -0
  7. package/agents/reviewer.md +152 -0
  8. package/agents/tester.md +126 -0
  9. package/bin/vibekit.js +18 -0
  10. package/hooks/lib/ck-config-utils.cjs +831 -0
  11. package/hooks/lib/colors.cjs +95 -0
  12. package/hooks/lib/config-counter.cjs +103 -0
  13. package/hooks/lib/context-builder.cjs +616 -0
  14. package/hooks/lib/git-info-cache.cjs +143 -0
  15. package/hooks/lib/hook-logger.cjs +92 -0
  16. package/hooks/lib/privacy-checker.cjs +297 -0
  17. package/hooks/lib/project-detector.cjs +474 -0
  18. package/hooks/lib/scout-checker.cjs +263 -0
  19. package/hooks/lib/transcript-parser.cjs +181 -0
  20. package/hooks/post-edit-simplify-reminder.cjs +156 -0
  21. package/hooks/privacy-block.cjs +166 -0
  22. package/hooks/scout-block.cjs +147 -0
  23. package/hooks/session-init.cjs +360 -0
  24. package/package.json +41 -0
  25. package/rules/development-rules.md +52 -0
  26. package/rules/documentation-management.md +121 -0
  27. package/rules/orchestration-protocol.md +43 -0
  28. package/rules/primary-workflow.md +57 -0
  29. package/rules/team-coordination-rules.md +90 -0
  30. package/skills/ai/agent-browser/SKILL.md +294 -0
  31. package/skills/ai/agent-browser/references/.gitkeep +0 -0
  32. package/skills/ai/agent-browser/references/agent-browser-vs-chrome-devtools.md +112 -0
  33. package/skills/ai/agent-browser/references/browserbase-cloud-setup.md +161 -0
  34. package/skills/ai/ai-artist/SKILL.md +122 -0
  35. package/skills/ai/ai-artist/data/awesome-prompts.csv +3592 -0
  36. package/skills/ai/ai-artist/data/lighting.csv +19 -0
  37. package/skills/ai/ai-artist/data/nano-banana-templates.csv +17 -0
  38. package/skills/ai/ai-artist/data/platforms.csv +11 -0
  39. package/skills/ai/ai-artist/data/styles.csv +26 -0
  40. package/skills/ai/ai-artist/data/techniques.csv +19 -0
  41. package/skills/ai/ai-artist/data/use-cases.csv +16 -0
  42. package/skills/ai/ai-artist/references/advanced-techniques.md +184 -0
  43. package/skills/ai/ai-artist/references/awesome-nano-banana-pro-prompts.md +8575 -0
  44. package/skills/ai/ai-artist/references/domain-code.md +66 -0
  45. package/skills/ai/ai-artist/references/domain-data.md +72 -0
  46. package/skills/ai/ai-artist/references/domain-marketing.md +66 -0
  47. package/skills/ai/ai-artist/references/domain-patterns.md +33 -0
  48. package/skills/ai/ai-artist/references/domain-writing.md +68 -0
  49. package/skills/ai/ai-artist/references/image-prompting.md +141 -0
  50. package/skills/ai/ai-artist/references/llm-prompting.md +165 -0
  51. package/skills/ai/ai-artist/references/nano-banana.md +136 -0
  52. package/skills/ai/ai-artist/references/reasoning-techniques.md +201 -0
  53. package/skills/ai/ai-artist/references/validation-workflow.md +117 -0
  54. package/skills/ai/ai-artist/scripts/core.py +197 -0
  55. package/skills/ai/ai-artist/scripts/extract_prompts.py +102 -0
  56. package/skills/ai/ai-artist/scripts/generate.py +370 -0
  57. package/skills/ai/ai-artist/scripts/search.py +147 -0
  58. package/skills/ai/ai-multimodal/.env.example +204 -0
  59. package/skills/ai/ai-multimodal/SKILL.md +110 -0
  60. package/skills/ai/ai-multimodal/references/audio-processing.md +387 -0
  61. package/skills/ai/ai-multimodal/references/image-generation.md +939 -0
  62. package/skills/ai/ai-multimodal/references/music-generation.md +311 -0
  63. package/skills/ai/ai-multimodal/references/video-analysis.md +515 -0
  64. package/skills/ai/ai-multimodal/references/video-generation.md +457 -0
  65. package/skills/ai/ai-multimodal/references/vision-understanding.md +492 -0
  66. package/skills/ai/ai-multimodal/scripts/.coverage +0 -0
  67. package/skills/ai/ai-multimodal/scripts/check_setup.py +315 -0
  68. package/skills/ai/ai-multimodal/scripts/document_converter.py +395 -0
  69. package/skills/ai/ai-multimodal/scripts/gemini_batch_process.py +1185 -0
  70. package/skills/ai/ai-multimodal/scripts/media_optimizer.py +506 -0
  71. package/skills/ai/ai-multimodal/scripts/requirements.txt +26 -0
  72. package/skills/ai/ai-multimodal/scripts/tests/.coverage +0 -0
  73. package/skills/ai/ai-multimodal/scripts/tests/requirements.txt +20 -0
  74. package/skills/ai/ai-multimodal/scripts/tests/test_document_converter.py +74 -0
  75. package/skills/ai/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -0
  76. package/skills/ai/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -0
  77. package/skills/ai/mcp-management/README.md +219 -0
  78. package/skills/ai/mcp-management/SKILL.md +210 -0
  79. package/skills/ai/mcp-management/assets/tools.json +3146 -0
  80. package/skills/ai/mcp-management/references/configuration.md +114 -0
  81. package/skills/ai/mcp-management/references/gemini-cli-integration.md +221 -0
  82. package/skills/ai/mcp-management/references/mcp-protocol.md +116 -0
  83. package/skills/ai/mcp-management/scripts/.env.example +10 -0
  84. package/skills/ai/mcp-management/scripts/cli.ts +195 -0
  85. package/skills/ai/mcp-management/scripts/dist/analyze-tools.js +70 -0
  86. package/skills/ai/mcp-management/scripts/dist/cli.js +160 -0
  87. package/skills/ai/mcp-management/scripts/dist/mcp-client.js +183 -0
  88. package/skills/ai/mcp-management/scripts/mcp-client.ts +230 -0
  89. package/skills/ai/mcp-management/scripts/package.json +20 -0
  90. package/skills/ai/mcp-management/scripts/tsconfig.json +15 -0
  91. package/skills/core/brainstorm/SKILL.md +164 -0
  92. package/skills/core/brainstorm/scripts/frame-template.html +214 -0
  93. package/skills/core/brainstorm/scripts/helper.js +88 -0
  94. package/skills/core/brainstorm/scripts/server.cjs +338 -0
  95. package/skills/core/brainstorm/scripts/start-server.sh +153 -0
  96. package/skills/core/brainstorm/scripts/stop-server.sh +55 -0
  97. package/skills/core/brainstorm/spec-document-reviewer-prompt.md +49 -0
  98. package/skills/core/brainstorm/visual-companion.md +286 -0
  99. package/skills/core/code-review/SKILL.md +147 -0
  100. package/skills/core/code-review/references/code-review-reception.md +113 -0
  101. package/skills/core/code-review/references/codebase-scan-workflow.md +29 -0
  102. package/skills/core/code-review/references/edge-case-scouting.md +119 -0
  103. package/skills/core/code-review/references/parallel-review-workflow.md +69 -0
  104. package/skills/core/code-review/references/requesting-code-review.md +116 -0
  105. package/skills/core/code-review/references/task-management-reviews.md +140 -0
  106. package/skills/core/code-review/references/verification-before-completion.md +139 -0
  107. package/skills/core/cook/README.md +86 -0
  108. package/skills/core/cook/SKILL.md +113 -0
  109. package/skills/core/cook/references/intent-detection.md +101 -0
  110. package/skills/core/cook/references/review-cycle.md +75 -0
  111. package/skills/core/cook/references/subagent-patterns.md +75 -0
  112. package/skills/core/cook/references/workflow-steps.md +172 -0
  113. package/skills/core/debug/SKILL.md +121 -0
  114. package/skills/core/debug/references/defense-in-depth.md +124 -0
  115. package/skills/core/debug/references/frontend-verification.md +103 -0
  116. package/skills/core/debug/references/investigation-methodology.md +101 -0
  117. package/skills/core/debug/references/log-and-ci-analysis.md +97 -0
  118. package/skills/core/debug/references/performance-diagnostics.md +113 -0
  119. package/skills/core/debug/references/reporting-standards.md +122 -0
  120. package/skills/core/debug/references/root-cause-tracing.md +122 -0
  121. package/skills/core/debug/references/systematic-debugging.md +102 -0
  122. package/skills/core/debug/references/task-management-debugging.md +155 -0
  123. package/skills/core/debug/references/verification.md +123 -0
  124. package/skills/core/debug/scripts/find-polluter.sh +63 -0
  125. package/skills/core/debug/scripts/find-polluter.test.md +102 -0
  126. package/skills/core/execute/SKILL.md +70 -0
  127. package/skills/core/fix/SKILL.md +111 -0
  128. package/skills/core/fix/references/complexity-assessment.md +72 -0
  129. package/skills/core/fix/references/mode-selection.md +46 -0
  130. package/skills/core/fix/references/parallel-exploration.md +100 -0
  131. package/skills/core/fix/references/review-cycle.md +77 -0
  132. package/skills/core/fix/references/skill-activation-matrix.md +78 -0
  133. package/skills/core/fix/references/task-orchestration.md +103 -0
  134. package/skills/core/fix/references/workflow-ci.md +28 -0
  135. package/skills/core/fix/references/workflow-deep.md +122 -0
  136. package/skills/core/fix/references/workflow-logs.md +72 -0
  137. package/skills/core/fix/references/workflow-quick.md +59 -0
  138. package/skills/core/fix/references/workflow-standard.md +111 -0
  139. package/skills/core/fix/references/workflow-test.md +75 -0
  140. package/skills/core/fix/references/workflow-types.md +33 -0
  141. package/skills/core/fix/references/workflow-ui.md +75 -0
  142. package/skills/core/plan/SKILL.md +145 -0
  143. package/skills/core/plan/plan-document-reviewer-prompt.md +49 -0
  144. package/skills/core/subagent-dev/SKILL.md +277 -0
  145. package/skills/core/subagent-dev/code-quality-reviewer-prompt.md +26 -0
  146. package/skills/core/subagent-dev/implementer-prompt.md +113 -0
  147. package/skills/core/subagent-dev/spec-reviewer-prompt.md +61 -0
  148. package/skills/core/tdd/SKILL.md +371 -0
  149. package/skills/core/tdd/testing-anti-patterns.md +299 -0
  150. package/skills/core/test/SKILL.md +109 -0
  151. package/skills/core/test/references/report-format.md +58 -0
  152. package/skills/core/test/references/test-execution-workflow.md +103 -0
  153. package/skills/core/test/references/ui-testing-workflow.md +65 -0
  154. package/skills/core/verify/SKILL.md +139 -0
  155. package/skills/dev/backend-dev/SKILL.md +96 -0
  156. package/skills/dev/backend-dev/references/backend-api-design.md +495 -0
  157. package/skills/dev/backend-dev/references/backend-architecture.md +454 -0
  158. package/skills/dev/backend-dev/references/backend-authentication.md +338 -0
  159. package/skills/dev/backend-dev/references/backend-code-quality.md +659 -0
  160. package/skills/dev/backend-dev/references/backend-debugging.md +904 -0
  161. package/skills/dev/backend-dev/references/backend-devops.md +494 -0
  162. package/skills/dev/backend-dev/references/backend-mindset.md +387 -0
  163. package/skills/dev/backend-dev/references/backend-performance.md +397 -0
  164. package/skills/dev/backend-dev/references/backend-security.md +290 -0
  165. package/skills/dev/backend-dev/references/backend-technologies.md +256 -0
  166. package/skills/dev/backend-dev/references/backend-testing.md +429 -0
  167. package/skills/dev/context-engineering/SKILL.md +108 -0
  168. package/skills/dev/context-engineering/references/context-compression.md +84 -0
  169. package/skills/dev/context-engineering/references/context-degradation.md +93 -0
  170. package/skills/dev/context-engineering/references/context-fundamentals.md +75 -0
  171. package/skills/dev/context-engineering/references/context-optimization.md +82 -0
  172. package/skills/dev/context-engineering/references/evaluation.md +89 -0
  173. package/skills/dev/context-engineering/references/memory-systems.md +88 -0
  174. package/skills/dev/context-engineering/references/multi-agent-patterns.md +90 -0
  175. package/skills/dev/context-engineering/references/project-development.md +97 -0
  176. package/skills/dev/context-engineering/references/runtime-awareness.md +202 -0
  177. package/skills/dev/context-engineering/references/tool-design.md +86 -0
  178. package/skills/dev/context-engineering/scripts/compression_evaluator.py +349 -0
  179. package/skills/dev/context-engineering/scripts/context_analyzer.py +317 -0
  180. package/skills/dev/context-engineering/scripts/tests/test_edge_cases.py +246 -0
  181. package/skills/dev/databases/SKILL.md +84 -0
  182. package/skills/dev/databases/analytics.md +198 -0
  183. package/skills/dev/databases/db-design.md +188 -0
  184. package/skills/dev/databases/incremental-etl.md +213 -0
  185. package/skills/dev/databases/references/mongodb-aggregation.md +447 -0
  186. package/skills/dev/databases/references/mongodb-atlas.md +465 -0
  187. package/skills/dev/databases/references/mongodb-crud.md +408 -0
  188. package/skills/dev/databases/references/mongodb-indexing.md +442 -0
  189. package/skills/dev/databases/references/postgresql-administration.md +594 -0
  190. package/skills/dev/databases/references/postgresql-performance.md +527 -0
  191. package/skills/dev/databases/references/postgresql-psql-cli.md +467 -0
  192. package/skills/dev/databases/references/postgresql-queries.md +475 -0
  193. package/skills/dev/databases/scripts/.coverage +0 -0
  194. package/skills/dev/databases/scripts/db_backup.py +502 -0
  195. package/skills/dev/databases/scripts/db_migrate.py +426 -0
  196. package/skills/dev/databases/scripts/db_performance_check.py +457 -0
  197. package/skills/dev/databases/scripts/requirements.txt +20 -0
  198. package/skills/dev/databases/scripts/tests/coverage-db.json +1 -0
  199. package/skills/dev/databases/scripts/tests/requirements.txt +4 -0
  200. package/skills/dev/databases/scripts/tests/test_db_backup.py +340 -0
  201. package/skills/dev/databases/scripts/tests/test_db_migrate.py +277 -0
  202. package/skills/dev/databases/scripts/tests/test_db_performance_check.py +370 -0
  203. package/skills/dev/databases/stacks/bigquery.md +231 -0
  204. package/skills/dev/databases/stacks/d1_cloudflare.md +137 -0
  205. package/skills/dev/databases/stacks/mysql.md +216 -0
  206. package/skills/dev/databases/stacks/postgres.md +235 -0
  207. package/skills/dev/databases/stacks/sqlite.md +244 -0
  208. package/skills/dev/databases/transactional.md +176 -0
  209. package/skills/dev/devops/.env.example +76 -0
  210. package/skills/dev/devops/SKILL.md +97 -0
  211. package/skills/dev/devops/references/browser-rendering.md +305 -0
  212. package/skills/dev/devops/references/cloudflare-d1-kv.md +123 -0
  213. package/skills/dev/devops/references/cloudflare-platform.md +271 -0
  214. package/skills/dev/devops/references/cloudflare-r2-storage.md +280 -0
  215. package/skills/dev/devops/references/cloudflare-workers-advanced.md +312 -0
  216. package/skills/dev/devops/references/cloudflare-workers-apis.md +309 -0
  217. package/skills/dev/devops/references/cloudflare-workers-basics.md +418 -0
  218. package/skills/dev/devops/references/docker-basics.md +297 -0
  219. package/skills/dev/devops/references/docker-compose.md +292 -0
  220. package/skills/dev/devops/references/gcloud-platform.md +297 -0
  221. package/skills/dev/devops/references/gcloud-services.md +304 -0
  222. package/skills/dev/devops/references/kubernetes-basics.md +99 -0
  223. package/skills/dev/devops/references/kubernetes-helm-advanced.md +75 -0
  224. package/skills/dev/devops/references/kubernetes-helm.md +81 -0
  225. package/skills/dev/devops/references/kubernetes-kubectl.md +74 -0
  226. package/skills/dev/devops/references/kubernetes-security-advanced.md +98 -0
  227. package/skills/dev/devops/references/kubernetes-security.md +95 -0
  228. package/skills/dev/devops/references/kubernetes-troubleshooting-advanced.md +74 -0
  229. package/skills/dev/devops/references/kubernetes-troubleshooting.md +49 -0
  230. package/skills/dev/devops/references/kubernetes-workflows-advanced.md +75 -0
  231. package/skills/dev/devops/references/kubernetes-workflows.md +78 -0
  232. package/skills/dev/devops/scripts/cloudflare_deploy.py +269 -0
  233. package/skills/dev/devops/scripts/docker_optimize.py +332 -0
  234. package/skills/dev/devops/scripts/requirements.txt +20 -0
  235. package/skills/dev/devops/scripts/tests/requirements.txt +3 -0
  236. package/skills/dev/devops/scripts/tests/test_cloudflare_deploy.py +285 -0
  237. package/skills/dev/devops/scripts/tests/test_docker_optimize.py +436 -0
  238. package/skills/dev/frontend-design/SKILL.md +78 -0
  239. package/skills/dev/frontend-design/references/ai-multimodal-overview.md +165 -0
  240. package/skills/dev/frontend-design/references/analysis-best-practices.md +80 -0
  241. package/skills/dev/frontend-design/references/analysis-prompts.md +141 -0
  242. package/skills/dev/frontend-design/references/analysis-techniques.md +118 -0
  243. package/skills/dev/frontend-design/references/animejs.md +396 -0
  244. package/skills/dev/frontend-design/references/asset-generation.md +337 -0
  245. package/skills/dev/frontend-design/references/design-extraction-overview.md +71 -0
  246. package/skills/dev/frontend-design/references/extraction-best-practices.md +141 -0
  247. package/skills/dev/frontend-design/references/extraction-output-templates.md +162 -0
  248. package/skills/dev/frontend-design/references/extraction-prompts.md +127 -0
  249. package/skills/dev/frontend-design/references/technical-accessibility.md +119 -0
  250. package/skills/dev/frontend-design/references/technical-best-practices.md +97 -0
  251. package/skills/dev/frontend-design/references/technical-optimization.md +44 -0
  252. package/skills/dev/frontend-design/references/technical-overview.md +90 -0
  253. package/skills/dev/frontend-design/references/technical-workflows.md +150 -0
  254. package/skills/dev/frontend-design/references/visual-analysis-overview.md +95 -0
  255. package/skills/dev/frontend-design/references/workflow-3d.md +102 -0
  256. package/skills/dev/frontend-design/references/workflow-describe.md +87 -0
  257. package/skills/dev/frontend-design/references/workflow-immersive.md +87 -0
  258. package/skills/dev/frontend-design/references/workflow-quick.md +57 -0
  259. package/skills/dev/frontend-design/references/workflow-screenshot.md +63 -0
  260. package/skills/dev/frontend-design/references/workflow-video.md +74 -0
  261. package/skills/dev/frontend-dev/SKILL.md +400 -0
  262. package/skills/dev/frontend-dev/resources/common-patterns.md +331 -0
  263. package/skills/dev/frontend-dev/resources/complete-examples.md +872 -0
  264. package/skills/dev/frontend-dev/resources/component-patterns.md +502 -0
  265. package/skills/dev/frontend-dev/resources/data-fetching.md +767 -0
  266. package/skills/dev/frontend-dev/resources/file-organization.md +502 -0
  267. package/skills/dev/frontend-dev/resources/loading-and-error-states.md +501 -0
  268. package/skills/dev/frontend-dev/resources/performance.md +406 -0
  269. package/skills/dev/frontend-dev/resources/routing-guide.md +364 -0
  270. package/skills/dev/frontend-dev/resources/styling-guide.md +428 -0
  271. package/skills/dev/frontend-dev/resources/typescript-standards.md +418 -0
  272. package/skills/dev/git/SKILL.md +114 -0
  273. package/skills/dev/git/references/branch-management.md +88 -0
  274. package/skills/dev/git/references/commit-standards.md +46 -0
  275. package/skills/dev/git/references/gh-cli-guide.md +109 -0
  276. package/skills/dev/git/references/safety-protocols.md +69 -0
  277. package/skills/dev/git/references/workflow-commit.md +58 -0
  278. package/skills/dev/git/references/workflow-merge.md +48 -0
  279. package/skills/dev/git/references/workflow-pr.md +58 -0
  280. package/skills/dev/git/references/workflow-push.md +52 -0
  281. package/skills/dev/git-worktree/SKILL.md +218 -0
  282. package/skills/utils/ask/SKILL.md +58 -0
  283. package/skills/utils/bootstrap/SKILL.md +101 -0
  284. package/skills/utils/bootstrap/references/shared-phases.md +59 -0
  285. package/skills/utils/bootstrap/references/workflow-auto.md +52 -0
  286. package/skills/utils/bootstrap/references/workflow-fast.md +50 -0
  287. package/skills/utils/bootstrap/references/workflow-full.md +60 -0
  288. package/skills/utils/bootstrap/references/workflow-parallel.md +59 -0
  289. package/skills/utils/ck-help/SKILL.md +102 -0
  290. package/skills/utils/ck-help/scripts/ck-help.py +1321 -0
  291. package/skills/utils/ck-help/scripts/commands_data.yaml +3 -0
  292. package/skills/utils/ck-help/scripts/skills_data.yaml +593 -0
  293. package/skills/utils/copywriting/SKILL.md +94 -0
  294. package/skills/utils/copywriting/references/copy-formulas.md +150 -0
  295. package/skills/utils/copywriting/references/cta-patterns.md +168 -0
  296. package/skills/utils/copywriting/references/email-copy.md +193 -0
  297. package/skills/utils/copywriting/references/headline-templates.md +140 -0
  298. package/skills/utils/copywriting/references/landing-page-copy.md +175 -0
  299. package/skills/utils/copywriting/references/power-words.md +189 -0
  300. package/skills/utils/copywriting/references/social-media-copy.md +222 -0
  301. package/skills/utils/copywriting/references/workflow-cro.md +83 -0
  302. package/skills/utils/copywriting/references/workflow-enhance.md +32 -0
  303. package/skills/utils/copywriting/references/workflow-fast.md +29 -0
  304. package/skills/utils/copywriting/references/workflow-good.md +39 -0
  305. package/skills/utils/copywriting/references/writing-styles.md +247 -0
  306. package/skills/utils/copywriting/scripts/extract-writing-styles.py +308 -0
  307. package/skills/utils/copywriting/templates/copy-brief.md +49 -0
  308. package/skills/utils/docs/SKILL.md +55 -0
  309. package/skills/utils/docs/references/init-workflow.md +32 -0
  310. package/skills/utils/docs/references/summarize-workflow.md +18 -0
  311. package/skills/utils/docs/references/update-workflow.md +59 -0
  312. package/skills/utils/journal/SKILL.md +11 -0
  313. package/skills/utils/kanban/SKILL.md +99 -0
  314. package/skills/utils/preview/SKILL.md +75 -0
  315. package/skills/utils/preview/references/generation-modes.md +95 -0
  316. package/skills/utils/preview/references/view-mode.md +42 -0
  317. package/skills/utils/repomix/SKILL.md +248 -0
  318. package/skills/utils/repomix/references/configuration.md +211 -0
  319. package/skills/utils/repomix/references/usage-patterns.md +232 -0
  320. package/skills/utils/repomix/scripts/.coverage +0 -0
  321. package/skills/utils/repomix/scripts/README.md +179 -0
  322. package/skills/utils/repomix/scripts/repomix_batch.py +455 -0
  323. package/skills/utils/repomix/scripts/repos.example.json +15 -0
  324. package/skills/utils/repomix/scripts/requirements.txt +15 -0
  325. package/skills/utils/repomix/scripts/tests/test_repomix_batch.py +531 -0
  326. package/skills/utils/research/SKILL.md +171 -0
  327. package/skills/utils/scout/SKILL.md +89 -0
  328. package/skills/utils/scout/references/external-scouting.md +140 -0
  329. package/skills/utils/scout/references/internal-scouting.md +119 -0
  330. package/skills/utils/scout/references/task-management-scouting.md +125 -0
  331. package/skills/utils/sequential-thinking/.env.example +8 -0
  332. package/skills/utils/sequential-thinking/README.md +183 -0
  333. package/skills/utils/sequential-thinking/SKILL.md +95 -0
  334. package/skills/utils/sequential-thinking/package.json +31 -0
  335. package/skills/utils/sequential-thinking/references/advanced-strategies.md +79 -0
  336. package/skills/utils/sequential-thinking/references/advanced-techniques.md +76 -0
  337. package/skills/utils/sequential-thinking/references/core-patterns.md +95 -0
  338. package/skills/utils/sequential-thinking/references/examples-api.md +88 -0
  339. package/skills/utils/sequential-thinking/references/examples-architecture.md +94 -0
  340. package/skills/utils/sequential-thinking/references/examples-debug.md +90 -0
  341. package/skills/utils/sequential-thinking/scripts/format-thought.js +159 -0
  342. package/skills/utils/sequential-thinking/scripts/process-thought.js +236 -0
  343. package/skills/utils/sequential-thinking/tests/format-thought.test.js +133 -0
  344. package/skills/utils/sequential-thinking/tests/process-thought.test.js +215 -0
  345. package/skills/utils/write-skill/SKILL.md +655 -0
  346. package/skills/utils/write-skill/anthropic-best-practices.md +1150 -0
  347. package/skills/utils/write-skill/examples/CLAUDE_MD_TESTING.md +189 -0
  348. package/skills/utils/write-skill/graphviz-conventions.dot +172 -0
  349. package/skills/utils/write-skill/persuasion-principles.md +187 -0
  350. package/skills/utils/write-skill/render-graphs.js +168 -0
  351. package/skills/utils/write-skill/testing-skills-with-subagents.md +384 -0
  352. package/src/commands/init.js +238 -0
@@ -0,0 +1,362 @@
1
+ """
2
+ Tests for gemini_batch_process.py
3
+ """
4
+
5
+ import pytest
6
+ import sys
7
+ from pathlib import Path
8
+ from unittest.mock import Mock, patch, MagicMock
9
+
10
+ # Add parent directory to path
11
+ sys.path.insert(0, str(Path(__file__).parent.parent))
12
+
13
+ import gemini_batch_process as gbp
14
+
15
+
16
+ class TestAPIKeyFinder:
17
+ """Test API key detection."""
18
+
19
+ def test_find_api_key_from_env(self, monkeypatch):
20
+ """Test finding API key from environment variable."""
21
+ monkeypatch.setenv('GEMINI_API_KEY', 'test_key_123')
22
+ assert gbp.find_api_key() == 'test_key_123'
23
+
24
+ @patch('gemini_batch_process.load_dotenv')
25
+ def test_find_api_key_not_found(self, mock_load_dotenv, monkeypatch):
26
+ """Test when API key is not found."""
27
+ monkeypatch.delenv('GEMINI_API_KEY', raising=False)
28
+ # Mock load_dotenv to not actually load any files
29
+ mock_load_dotenv.return_value = None
30
+ assert gbp.find_api_key() is None
31
+
32
+
33
+ class TestMimeTypeDetection:
34
+ """Test MIME type detection."""
35
+
36
+ def test_audio_mime_types(self):
37
+ """Test audio file MIME types."""
38
+ assert gbp.get_mime_type('test.mp3') == 'audio/mp3'
39
+ assert gbp.get_mime_type('test.wav') == 'audio/wav'
40
+ assert gbp.get_mime_type('test.aac') == 'audio/aac'
41
+ assert gbp.get_mime_type('test.flac') == 'audio/flac'
42
+
43
+ def test_image_mime_types(self):
44
+ """Test image file MIME types."""
45
+ assert gbp.get_mime_type('test.jpg') == 'image/jpeg'
46
+ assert gbp.get_mime_type('test.jpeg') == 'image/jpeg'
47
+ assert gbp.get_mime_type('test.png') == 'image/png'
48
+ assert gbp.get_mime_type('test.webp') == 'image/webp'
49
+
50
+ def test_video_mime_types(self):
51
+ """Test video file MIME types."""
52
+ assert gbp.get_mime_type('test.mp4') == 'video/mp4'
53
+ assert gbp.get_mime_type('test.mov') == 'video/quicktime'
54
+ assert gbp.get_mime_type('test.avi') == 'video/x-msvideo'
55
+
56
+ def test_document_mime_types(self):
57
+ """Test document file MIME types."""
58
+ assert gbp.get_mime_type('test.pdf') == 'application/pdf'
59
+ assert gbp.get_mime_type('test.txt') == 'text/plain'
60
+
61
+ def test_unknown_mime_type(self):
62
+ """Test unknown file extension."""
63
+ assert gbp.get_mime_type('test.xyz') == 'application/octet-stream'
64
+
65
+ def test_case_insensitive(self):
66
+ """Test case-insensitive extension matching."""
67
+ assert gbp.get_mime_type('TEST.MP3') == 'audio/mp3'
68
+ assert gbp.get_mime_type('Test.JPG') == 'image/jpeg'
69
+
70
+
71
+ class TestFileUpload:
72
+ """Test file upload functionality."""
73
+
74
+ @patch('gemini_batch_process.genai.Client')
75
+ def test_upload_file_success(self, mock_client_class):
76
+ """Test successful file upload."""
77
+ # Mock client and file
78
+ mock_client = Mock()
79
+ mock_file = Mock()
80
+ mock_file.state.name = 'ACTIVE'
81
+ mock_file.name = 'test_file'
82
+ mock_client.files.upload.return_value = mock_file
83
+
84
+ result = gbp.upload_file(mock_client, 'test.jpg', verbose=False)
85
+
86
+ assert result == mock_file
87
+ mock_client.files.upload.assert_called_once_with(file='test.jpg')
88
+
89
+ @patch('gemini_batch_process.genai.Client')
90
+ @patch('gemini_batch_process.time.sleep')
91
+ def test_upload_video_with_processing(self, mock_sleep, mock_client_class):
92
+ """Test video upload with processing wait."""
93
+ mock_client = Mock()
94
+
95
+ # First call: PROCESSING, second call: ACTIVE
96
+ mock_file_processing = Mock()
97
+ mock_file_processing.state.name = 'PROCESSING'
98
+ mock_file_processing.name = 'test_video'
99
+
100
+ mock_file_active = Mock()
101
+ mock_file_active.state.name = 'ACTIVE'
102
+ mock_file_active.name = 'test_video'
103
+
104
+ mock_client.files.upload.return_value = mock_file_processing
105
+ mock_client.files.get.return_value = mock_file_active
106
+
107
+ result = gbp.upload_file(mock_client, 'test.mp4', verbose=False)
108
+
109
+ assert result.state.name == 'ACTIVE'
110
+
111
+ @patch('gemini_batch_process.genai.Client')
112
+ def test_upload_file_failed(self, mock_client_class):
113
+ """Test failed file upload."""
114
+ mock_client = Mock()
115
+ mock_file = Mock()
116
+ mock_file.state.name = 'FAILED'
117
+ mock_client.files.upload.return_value = mock_file
118
+ mock_client.files.get.return_value = mock_file
119
+
120
+ with pytest.raises(ValueError, match="File processing failed"):
121
+ gbp.upload_file(mock_client, 'test.mp4', verbose=False)
122
+
123
+
124
+ class TestProcessFile:
125
+ """Test file processing functionality."""
126
+
127
+ @patch('gemini_batch_process.genai.Client')
128
+ @patch('builtins.open', create=True)
129
+ @patch('pathlib.Path.stat')
130
+ def test_process_small_file_inline(self, mock_stat, mock_open, mock_client_class):
131
+ """Test processing small file with inline data."""
132
+ # Mock small file
133
+ mock_stat.return_value.st_size = 10 * 1024 * 1024 # 10MB
134
+
135
+ # Mock file content
136
+ mock_open.return_value.__enter__.return_value.read.return_value = b'test_data'
137
+
138
+ # Mock client and response
139
+ mock_client = Mock()
140
+ mock_response = Mock()
141
+ mock_response.text = 'Test response'
142
+ mock_client.models.generate_content.return_value = mock_response
143
+
144
+ result = gbp.process_file(
145
+ client=mock_client,
146
+ file_path='test.jpg',
147
+ prompt='Describe this image',
148
+ model='gemini-2.5-flash',
149
+ task='analyze',
150
+ format_output='text',
151
+ verbose=False
152
+ )
153
+
154
+ assert result['status'] == 'success'
155
+ assert result['response'] == 'Test response'
156
+
157
+ @patch('gemini_batch_process.upload_file')
158
+ @patch('gemini_batch_process.genai.Client')
159
+ @patch('pathlib.Path.stat')
160
+ def test_process_large_file_api(self, mock_stat, mock_client_class, mock_upload):
161
+ """Test processing large file with File API."""
162
+ # Mock large file
163
+ mock_stat.return_value.st_size = 50 * 1024 * 1024 # 50MB
164
+
165
+ # Mock upload and response
166
+ mock_file = Mock()
167
+ mock_upload.return_value = mock_file
168
+
169
+ mock_client = Mock()
170
+ mock_response = Mock()
171
+ mock_response.text = 'Test response'
172
+ mock_client.models.generate_content.return_value = mock_response
173
+
174
+ result = gbp.process_file(
175
+ client=mock_client,
176
+ file_path='test.mp4',
177
+ prompt='Summarize this video',
178
+ model='gemini-2.5-flash',
179
+ task='analyze',
180
+ format_output='text',
181
+ verbose=False
182
+ )
183
+
184
+ assert result['status'] == 'success'
185
+ mock_upload.assert_called_once()
186
+
187
+ @patch('gemini_batch_process.genai.Client')
188
+ @patch('builtins.open', create=True)
189
+ @patch('pathlib.Path.stat')
190
+ def test_process_file_error_handling(self, mock_stat, mock_open, mock_client_class):
191
+ """Test error handling in file processing."""
192
+ mock_stat.return_value.st_size = 1024
193
+
194
+ # Mock file read
195
+ mock_file = MagicMock()
196
+ mock_file.__enter__.return_value.read.return_value = b'test_data'
197
+ mock_open.return_value = mock_file
198
+
199
+ mock_client = Mock()
200
+ mock_client.models.generate_content.side_effect = Exception("API Error")
201
+
202
+ result = gbp.process_file(
203
+ client=mock_client,
204
+ file_path='test.jpg',
205
+ prompt='Test',
206
+ model='gemini-2.5-flash',
207
+ task='analyze',
208
+ format_output='text',
209
+ verbose=False,
210
+ max_retries=1
211
+ )
212
+
213
+ assert result['status'] == 'error'
214
+ assert 'API Error' in result['error']
215
+
216
+ @patch('gemini_batch_process.genai.Client')
217
+ @patch('builtins.open', create=True)
218
+ @patch('pathlib.Path.stat')
219
+ def test_image_generation_with_aspect_ratio(self, mock_stat, mock_open, mock_client_class):
220
+ """Test image generation with aspect ratio config."""
221
+ mock_stat.return_value.st_size = 1024
222
+
223
+ # Mock file read
224
+ mock_file = MagicMock()
225
+ mock_file.__enter__.return_value.read.return_value = b'test'
226
+ mock_open.return_value = mock_file
227
+
228
+ mock_client = Mock()
229
+ mock_response = Mock()
230
+ mock_response.candidates = [Mock()]
231
+ mock_response.candidates[0].content.parts = [
232
+ Mock(inline_data=Mock(data=b'fake_image_data'))
233
+ ]
234
+ mock_client.models.generate_content.return_value = mock_response
235
+
236
+ result = gbp.process_file(
237
+ client=mock_client,
238
+ file_path='test.txt',
239
+ prompt='Generate mountain landscape',
240
+ model='gemini-2.5-flash-image',
241
+ task='generate',
242
+ format_output='text',
243
+ aspect_ratio='16:9',
244
+ verbose=False
245
+ )
246
+
247
+ # Verify config was called with correct structure
248
+ call_args = mock_client.models.generate_content.call_args
249
+ config = call_args.kwargs.get('config')
250
+ assert config is not None
251
+ assert result['status'] == 'success'
252
+ assert 'generated_image' in result
253
+
254
+
255
+ class TestBatchProcessing:
256
+ """Test batch processing functionality."""
257
+
258
+ @patch('gemini_batch_process.find_api_key')
259
+ @patch('gemini_batch_process.process_file')
260
+ @patch('gemini_batch_process.genai.Client')
261
+ def test_batch_process_success(self, mock_client_class, mock_process, mock_find_key):
262
+ """Test successful batch processing."""
263
+ mock_find_key.return_value = 'test_key'
264
+ mock_process.return_value = {'status': 'success', 'response': 'Test'}
265
+
266
+ results = gbp.batch_process(
267
+ files=['test1.jpg', 'test2.jpg'],
268
+ prompt='Analyze',
269
+ model='gemini-2.5-flash',
270
+ task='analyze',
271
+ format_output='text',
272
+ verbose=False,
273
+ dry_run=False
274
+ )
275
+
276
+ assert len(results) == 2
277
+ assert all(r['status'] == 'success' for r in results)
278
+
279
+ @patch('gemini_batch_process.find_api_key')
280
+ def test_batch_process_no_api_key(self, mock_find_key):
281
+ """Test batch processing without API key."""
282
+ mock_find_key.return_value = None
283
+
284
+ with pytest.raises(SystemExit):
285
+ gbp.batch_process(
286
+ files=['test.jpg'],
287
+ prompt='Test',
288
+ model='gemini-2.5-flash',
289
+ task='analyze',
290
+ format_output='text',
291
+ verbose=False,
292
+ dry_run=False
293
+ )
294
+
295
+ @patch('gemini_batch_process.find_api_key')
296
+ def test_batch_process_dry_run(self, mock_find_key):
297
+ """Test dry run mode."""
298
+ # API key not needed for dry run, but we mock it to avoid sys.exit
299
+ mock_find_key.return_value = 'test_key'
300
+
301
+ results = gbp.batch_process(
302
+ files=['test1.jpg', 'test2.jpg'],
303
+ prompt='Test',
304
+ model='gemini-2.5-flash',
305
+ task='analyze',
306
+ format_output='text',
307
+ verbose=False,
308
+ dry_run=True
309
+ )
310
+
311
+ assert results == []
312
+
313
+
314
+ class TestResultsSaving:
315
+ """Test results saving functionality."""
316
+
317
+ @patch('builtins.open', create=True)
318
+ @patch('json.dump')
319
+ def test_save_results_json(self, mock_json_dump, mock_open):
320
+ """Test saving results as JSON."""
321
+ results = [
322
+ {'file': 'test1.jpg', 'status': 'success', 'response': 'Test1'},
323
+ {'file': 'test2.jpg', 'status': 'success', 'response': 'Test2'}
324
+ ]
325
+
326
+ gbp.save_results(results, 'output.json', 'json')
327
+
328
+ mock_json_dump.assert_called_once()
329
+
330
+ @patch('builtins.open', create=True)
331
+ @patch('csv.DictWriter')
332
+ def test_save_results_csv(self, mock_csv_writer, mock_open):
333
+ """Test saving results as CSV."""
334
+ results = [
335
+ {'file': 'test1.jpg', 'status': 'success', 'response': 'Test1'},
336
+ {'file': 'test2.jpg', 'status': 'success', 'response': 'Test2'}
337
+ ]
338
+
339
+ gbp.save_results(results, 'output.csv', 'csv')
340
+
341
+ # Verify CSV writer was used
342
+ mock_csv_writer.assert_called_once()
343
+
344
+ @patch('builtins.open', create=True)
345
+ def test_save_results_markdown(self, mock_open):
346
+ """Test saving results as Markdown."""
347
+ mock_file = MagicMock()
348
+ mock_open.return_value.__enter__.return_value = mock_file
349
+
350
+ results = [
351
+ {'file': 'test1.jpg', 'status': 'success', 'response': 'Test1'},
352
+ {'file': 'test2.jpg', 'status': 'error', 'error': 'Failed'}
353
+ ]
354
+
355
+ gbp.save_results(results, 'output.md', 'markdown')
356
+
357
+ # Verify write was called
358
+ assert mock_file.write.call_count > 0
359
+
360
+
361
+ if __name__ == '__main__':
362
+ pytest.main([__file__, '-v', '--cov=gemini_batch_process', '--cov-report=term-missing'])