codexkit 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 (655) hide show
  1. package/.codex/.env.example +27 -0
  2. package/.codex/.template-manifest.json +631 -0
  3. package/.codex/.version +1 -0
  4. package/.codex/agents/builder.toml +104 -0
  5. package/.codex/agents/debugger.toml +67 -0
  6. package/.codex/agents/general.toml +41 -0
  7. package/.codex/agents/painter.toml +40 -0
  8. package/.codex/agents/planner.toml +60 -0
  9. package/.codex/agents/refactorer.toml +76 -0
  10. package/.codex/agents/reviewer.toml +60 -0
  11. package/.codex/agents/runner.toml +40 -0
  12. package/.codex/agents/scout.toml +133 -0
  13. package/.codex/agents/shipper.toml +69 -0
  14. package/.codex/agents/vision.toml +69 -0
  15. package/.codex/config.toml +146 -0
  16. package/.codex/context/architecture.md +66 -0
  17. package/.codex/context/conventions.md +98 -0
  18. package/.codex/context/current-priorities.md +33 -0
  19. package/.codex/context/decision-log.md +93 -0
  20. package/.codex/context/gotchas.md +42 -0
  21. package/.codex/context/index.md +21 -0
  22. package/.codex/context/session-context.md +11 -0
  23. package/.codex/context/worklog.md +9 -0
  24. package/.codex/hooks/README.md +17 -0
  25. package/.codex/hooks/after_agent.sh +11 -0
  26. package/.codex/hooks/after_tool_use.sh +10 -0
  27. package/.codex/hooks/post_commit.sh +10 -0
  28. package/.codex/hooks/pre_commit.sh +6 -0
  29. package/.codex/hooks/session_start.sh +18 -0
  30. package/.codex/hooks/stop.sh +10 -0
  31. package/.codex/mcp/README.md +143 -0
  32. package/.codex/mcp/basic-memory.toml.example +10 -0
  33. package/.codex/mcp/context7.toml.example +13 -0
  34. package/.codex/mcp/exa.toml.example +12 -0
  35. package/.codex/mcp/memory-bridge.toml.example +15 -0
  36. package/.codex/mcp/memory.toml.example +6 -0
  37. package/.codex/mcp/ref.toml.example +13 -0
  38. package/.codex/mcp/tilth.toml.example +10 -0
  39. package/.codex/memory/README.md +29 -0
  40. package/.codex/memory/_templates/README.md +26 -0
  41. package/.codex/memory/_templates/design.md +15 -0
  42. package/.codex/memory/_templates/gotcha.md +9 -0
  43. package/.codex/memory/_templates/handoff.md +9 -0
  44. package/.codex/memory/_templates/prd.md +13 -0
  45. package/.codex/memory/_templates/project.md +9 -0
  46. package/.codex/memory/_templates/proposal.md +13 -0
  47. package/.codex/memory/_templates/research.md +9 -0
  48. package/.codex/memory/_templates/roadmap.md +11 -0
  49. package/.codex/memory/_templates/session-context.md +7 -0
  50. package/.codex/memory/_templates/state.md +11 -0
  51. package/.codex/memory/_templates/tasks.md +9 -0
  52. package/.codex/memory/_templates/tech-stack.md +9 -0
  53. package/.codex/memory/_templates/user.md +7 -0
  54. package/.codex/memory/project/gotchas.md +5 -0
  55. package/.codex/memory/project/project.md +12 -0
  56. package/.codex/memory/project/roadmap.md +15 -0
  57. package/.codex/memory/project/state.md +22 -0
  58. package/.codex/memory/project/tech-stack.md +19 -0
  59. package/.codex/memory/project/user.md +10 -0
  60. package/.codex/memory/research/.gitkeep +1 -0
  61. package/.codex/memory/session-context.md +18 -0
  62. package/.codex/plans/README.md +7 -0
  63. package/.codex/prompts/compound.md +154 -0
  64. package/.codex/prompts/create.md +238 -0
  65. package/.codex/prompts/design.md +90 -0
  66. package/.codex/prompts/handoff.md +184 -0
  67. package/.codex/prompts/init-context.md +185 -0
  68. package/.codex/prompts/init-user.md +93 -0
  69. package/.codex/prompts/init.md +103 -0
  70. package/.codex/prompts/lfg.md +140 -0
  71. package/.codex/prompts/plan.md +140 -0
  72. package/.codex/prompts/pr.md +150 -0
  73. package/.codex/prompts/research.md +137 -0
  74. package/.codex/prompts/resume.md +105 -0
  75. package/.codex/prompts/review-codebase.md +147 -0
  76. package/.codex/prompts/ship.md +334 -0
  77. package/.codex/prompts/start.md +141 -0
  78. package/.codex/prompts/status.md +102 -0
  79. package/.codex/prompts/ui-inspire.md +151 -0
  80. package/.codex/prompts/ui-review.md +86 -0
  81. package/.codex/prompts/verify.md +181 -0
  82. package/.codex/scripts/append_worklog.sh +20 -0
  83. package/.codex/scripts/apply_worklog_archive.sh +48 -0
  84. package/.codex/scripts/audit_memory_hygiene.sh +102 -0
  85. package/.codex/scripts/build_memory_index.sh +167 -0
  86. package/.codex/scripts/build_prior_related_work.sh +127 -0
  87. package/.codex/scripts/build_startup_brief.sh +52 -0
  88. package/.codex/scripts/close_bead.sh +103 -0
  89. package/.codex/scripts/detect_changed_files.sh +38 -0
  90. package/.codex/scripts/ensure_beads.sh +14 -0
  91. package/.codex/scripts/memory_search.sh +292 -0
  92. package/.codex/scripts/prepare_worklog_archive.sh +115 -0
  93. package/.codex/scripts/search_bead_context.sh +214 -0
  94. package/.codex/scripts/start_bead.sh +129 -0
  95. package/.codex/scripts/sync_bead_context.sh +288 -0
  96. package/.codex/scripts/validate_memory_docs.sh +44 -0
  97. package/.codex/scripts/verify_bead.sh +154 -0
  98. package/.codex/skills/accessibility-audit/SKILL.md +191 -0
  99. package/.codex/skills/agent-browser/SKILL.md +413 -0
  100. package/.codex/skills/agent-teams/SKILL.md +268 -0
  101. package/.codex/skills/augment-context-engine/SKILL.md +115 -0
  102. package/.codex/skills/augment-context-engine/mcp.json +6 -0
  103. package/.codex/skills/beads/SKILL.md +181 -0
  104. package/.codex/skills/beads/references/BEST_PRACTICES.md +27 -0
  105. package/.codex/skills/beads/references/BOUNDARIES.md +219 -0
  106. package/.codex/skills/beads/references/DEPENDENCIES.md +124 -0
  107. package/.codex/skills/beads/references/EXAMPLES.md +45 -0
  108. package/.codex/skills/beads/references/FILE_CLAIMING.md +101 -0
  109. package/.codex/skills/beads/references/GIT_SYNC.md +25 -0
  110. package/.codex/skills/beads/references/HIERARCHY.md +71 -0
  111. package/.codex/skills/beads/references/MULTI_AGENT.md +40 -0
  112. package/.codex/skills/beads/references/RESUMABILITY.md +177 -0
  113. package/.codex/skills/beads/references/SESSION_PROTOCOL.md +61 -0
  114. package/.codex/skills/beads/references/TASK_CREATION.md +38 -0
  115. package/.codex/skills/beads/references/TROUBLESHOOTING.md +38 -0
  116. package/.codex/skills/beads/references/WORKFLOWS.md +226 -0
  117. package/.codex/skills/beads-bridge/SKILL.md +321 -0
  118. package/.codex/skills/brainstorming/SKILL.md +114 -0
  119. package/.codex/skills/bug-triage/SKILL.md +191 -0
  120. package/.codex/skills/chrome-devtools/SKILL.md +76 -0
  121. package/.codex/skills/chrome-devtools/mcp.json +19 -0
  122. package/.codex/skills/cloudflare/SKILL.md +253 -0
  123. package/.codex/skills/cloudflare/references/agents-sdk/README.md +35 -0
  124. package/.codex/skills/cloudflare/references/agents-sdk/api.md +100 -0
  125. package/.codex/skills/cloudflare/references/agents-sdk/configuration.md +99 -0
  126. package/.codex/skills/cloudflare/references/agents-sdk/gotchas.md +59 -0
  127. package/.codex/skills/cloudflare/references/agents-sdk/patterns.md +89 -0
  128. package/.codex/skills/cloudflare/references/ai-gateway/README.md +695 -0
  129. package/.codex/skills/cloudflare/references/ai-search/README.md +14 -0
  130. package/.codex/skills/cloudflare/references/ai-search/api.md +38 -0
  131. package/.codex/skills/cloudflare/references/ai-search/configuration.md +52 -0
  132. package/.codex/skills/cloudflare/references/ai-search/gotchas.md +41 -0
  133. package/.codex/skills/cloudflare/references/ai-search/patterns.md +45 -0
  134. package/.codex/skills/cloudflare/references/analytics-engine/README.md +14 -0
  135. package/.codex/skills/cloudflare/references/analytics-engine/api.md +27 -0
  136. package/.codex/skills/cloudflare/references/analytics-engine/configuration.md +45 -0
  137. package/.codex/skills/cloudflare/references/analytics-engine/gotchas.md +3 -0
  138. package/.codex/skills/cloudflare/references/analytics-engine/patterns.md +36 -0
  139. package/.codex/skills/cloudflare/references/api/README.md +21 -0
  140. package/.codex/skills/cloudflare/references/api/api.md +31 -0
  141. package/.codex/skills/cloudflare/references/api/configuration.md +20 -0
  142. package/.codex/skills/cloudflare/references/api/gotchas.md +28 -0
  143. package/.codex/skills/cloudflare/references/api/patterns.md +47 -0
  144. package/.codex/skills/cloudflare/references/api-shield/README.md +20 -0
  145. package/.codex/skills/cloudflare/references/api-shield/api.md +78 -0
  146. package/.codex/skills/cloudflare/references/api-shield/configuration.md +128 -0
  147. package/.codex/skills/cloudflare/references/api-shield/gotchas.md +51 -0
  148. package/.codex/skills/cloudflare/references/api-shield/patterns.md +145 -0
  149. package/.codex/skills/cloudflare/references/argo-smart-routing/README.md +16 -0
  150. package/.codex/skills/cloudflare/references/argo-smart-routing/api.md +50 -0
  151. package/.codex/skills/cloudflare/references/argo-smart-routing/configuration.md +53 -0
  152. package/.codex/skills/cloudflare/references/argo-smart-routing/gotchas.md +16 -0
  153. package/.codex/skills/cloudflare/references/argo-smart-routing/patterns.md +45 -0
  154. package/.codex/skills/cloudflare/references/bindings/README.md +14 -0
  155. package/.codex/skills/cloudflare/references/bindings/api.md +3 -0
  156. package/.codex/skills/cloudflare/references/bindings/configuration.md +58 -0
  157. package/.codex/skills/cloudflare/references/bindings/gotchas.md +35 -0
  158. package/.codex/skills/cloudflare/references/bindings/patterns.md +37 -0
  159. package/.codex/skills/cloudflare/references/bot-management/README.md +71 -0
  160. package/.codex/skills/cloudflare/references/bot-management/api.md +168 -0
  161. package/.codex/skills/cloudflare/references/bot-management/configuration.md +114 -0
  162. package/.codex/skills/cloudflare/references/bot-management/gotchas.md +99 -0
  163. package/.codex/skills/cloudflare/references/bot-management/patterns.md +125 -0
  164. package/.codex/skills/cloudflare/references/browser-rendering/README.md +16 -0
  165. package/.codex/skills/cloudflare/references/browser-rendering/api.md +54 -0
  166. package/.codex/skills/cloudflare/references/browser-rendering/configuration.md +47 -0
  167. package/.codex/skills/cloudflare/references/browser-rendering/gotchas.md +29 -0
  168. package/.codex/skills/cloudflare/references/browser-rendering/patterns.md +29 -0
  169. package/.codex/skills/cloudflare/references/c3/README.md +264 -0
  170. package/.codex/skills/cloudflare/references/cache-reserve/README.md +93 -0
  171. package/.codex/skills/cloudflare/references/cache-reserve/api.md +176 -0
  172. package/.codex/skills/cloudflare/references/cache-reserve/configuration.md +164 -0
  173. package/.codex/skills/cloudflare/references/cache-reserve/gotchas.md +203 -0
  174. package/.codex/skills/cloudflare/references/cache-reserve/patterns.md +180 -0
  175. package/.codex/skills/cloudflare/references/containers/README.md +16 -0
  176. package/.codex/skills/cloudflare/references/containers/api.md +43 -0
  177. package/.codex/skills/cloudflare/references/containers/configuration.md +56 -0
  178. package/.codex/skills/cloudflare/references/containers/gotchas.md +21 -0
  179. package/.codex/skills/cloudflare/references/containers/patterns.md +40 -0
  180. package/.codex/skills/cloudflare/references/cron-triggers/README.md +85 -0
  181. package/.codex/skills/cloudflare/references/cron-triggers/api.md +198 -0
  182. package/.codex/skills/cloudflare/references/cron-triggers/configuration.md +151 -0
  183. package/.codex/skills/cloudflare/references/cron-triggers/gotchas.md +129 -0
  184. package/.codex/skills/cloudflare/references/cron-triggers/patterns.md +122 -0
  185. package/.codex/skills/cloudflare/references/d1/README.md +92 -0
  186. package/.codex/skills/cloudflare/references/d1/api.md +141 -0
  187. package/.codex/skills/cloudflare/references/d1/configuration.md +127 -0
  188. package/.codex/skills/cloudflare/references/d1/gotchas.md +70 -0
  189. package/.codex/skills/cloudflare/references/d1/patterns.md +144 -0
  190. package/.codex/skills/cloudflare/references/ddos/README.md +34 -0
  191. package/.codex/skills/cloudflare/references/ddos/api.md +136 -0
  192. package/.codex/skills/cloudflare/references/ddos/configuration.md +67 -0
  193. package/.codex/skills/cloudflare/references/ddos/gotchas.md +114 -0
  194. package/.codex/skills/cloudflare/references/ddos/patterns.md +158 -0
  195. package/.codex/skills/cloudflare/references/do-storage/README.md +62 -0
  196. package/.codex/skills/cloudflare/references/do-storage/api.md +89 -0
  197. package/.codex/skills/cloudflare/references/do-storage/configuration.md +116 -0
  198. package/.codex/skills/cloudflare/references/do-storage/gotchas.md +93 -0
  199. package/.codex/skills/cloudflare/references/do-storage/patterns.md +112 -0
  200. package/.codex/skills/cloudflare/references/durable-objects/README.md +125 -0
  201. package/.codex/skills/cloudflare/references/durable-objects/api.md +152 -0
  202. package/.codex/skills/cloudflare/references/durable-objects/configuration.md +148 -0
  203. package/.codex/skills/cloudflare/references/durable-objects/gotchas.md +158 -0
  204. package/.codex/skills/cloudflare/references/durable-objects/patterns.md +255 -0
  205. package/.codex/skills/cloudflare/references/email-routing/README.md +18 -0
  206. package/.codex/skills/cloudflare/references/email-routing/api.md +46 -0
  207. package/.codex/skills/cloudflare/references/email-routing/configuration.md +63 -0
  208. package/.codex/skills/cloudflare/references/email-routing/gotchas.md +16 -0
  209. package/.codex/skills/cloudflare/references/email-routing/patterns.md +46 -0
  210. package/.codex/skills/cloudflare/references/email-workers/README.md +598 -0
  211. package/.codex/skills/cloudflare/references/hyperdrive/README.md +62 -0
  212. package/.codex/skills/cloudflare/references/hyperdrive/api.md +137 -0
  213. package/.codex/skills/cloudflare/references/hyperdrive/configuration.md +133 -0
  214. package/.codex/skills/cloudflare/references/hyperdrive/gotchas.md +184 -0
  215. package/.codex/skills/cloudflare/references/hyperdrive/patterns.md +176 -0
  216. package/.codex/skills/cloudflare/references/images/README.md +14 -0
  217. package/.codex/skills/cloudflare/references/images/api.md +3 -0
  218. package/.codex/skills/cloudflare/references/images/configuration.md +45 -0
  219. package/.codex/skills/cloudflare/references/images/gotchas.md +23 -0
  220. package/.codex/skills/cloudflare/references/images/patterns.md +31 -0
  221. package/.codex/skills/cloudflare/references/kv/README.md +60 -0
  222. package/.codex/skills/cloudflare/references/kv/api.md +114 -0
  223. package/.codex/skills/cloudflare/references/kv/configuration.md +92 -0
  224. package/.codex/skills/cloudflare/references/kv/gotchas.md +117 -0
  225. package/.codex/skills/cloudflare/references/kv/patterns.md +139 -0
  226. package/.codex/skills/cloudflare/references/miniflare/README.md +64 -0
  227. package/.codex/skills/cloudflare/references/miniflare/api.md +144 -0
  228. package/.codex/skills/cloudflare/references/miniflare/configuration.md +203 -0
  229. package/.codex/skills/cloudflare/references/miniflare/gotchas.md +187 -0
  230. package/.codex/skills/cloudflare/references/miniflare/patterns.md +211 -0
  231. package/.codex/skills/cloudflare/references/network-interconnect/README.md +60 -0
  232. package/.codex/skills/cloudflare/references/network-interconnect/api.md +240 -0
  233. package/.codex/skills/cloudflare/references/network-interconnect/configuration.md +127 -0
  234. package/.codex/skills/cloudflare/references/network-interconnect/gotchas.md +171 -0
  235. package/.codex/skills/cloudflare/references/network-interconnect/patterns.md +171 -0
  236. package/.codex/skills/cloudflare/references/observability/README.md +18 -0
  237. package/.codex/skills/cloudflare/references/observability/api.md +51 -0
  238. package/.codex/skills/cloudflare/references/observability/configuration.md +60 -0
  239. package/.codex/skills/cloudflare/references/observability/gotchas.md +36 -0
  240. package/.codex/skills/cloudflare/references/observability/patterns.md +42 -0
  241. package/.codex/skills/cloudflare/references/pages/README.md +76 -0
  242. package/.codex/skills/cloudflare/references/pages/api.md +200 -0
  243. package/.codex/skills/cloudflare/references/pages/configuration.md +228 -0
  244. package/.codex/skills/cloudflare/references/pages/gotchas.md +161 -0
  245. package/.codex/skills/cloudflare/references/pages/patterns.md +145 -0
  246. package/.codex/skills/cloudflare/references/pages-functions/README.md +57 -0
  247. package/.codex/skills/cloudflare/references/pages-functions/api.md +201 -0
  248. package/.codex/skills/cloudflare/references/pages-functions/configuration.md +159 -0
  249. package/.codex/skills/cloudflare/references/pages-functions/gotchas.md +151 -0
  250. package/.codex/skills/cloudflare/references/pages-functions/patterns.md +190 -0
  251. package/.codex/skills/cloudflare/references/pipelines/README.md +664 -0
  252. package/.codex/skills/cloudflare/references/pulumi/README.md +107 -0
  253. package/.codex/skills/cloudflare/references/pulumi/api.md +194 -0
  254. package/.codex/skills/cloudflare/references/pulumi/configuration.md +216 -0
  255. package/.codex/skills/cloudflare/references/pulumi/gotchas.md +223 -0
  256. package/.codex/skills/cloudflare/references/pulumi/patterns.md +139 -0
  257. package/.codex/skills/cloudflare/references/queues/README.md +69 -0
  258. package/.codex/skills/cloudflare/references/queues/api.md +138 -0
  259. package/.codex/skills/cloudflare/references/queues/configuration.md +125 -0
  260. package/.codex/skills/cloudflare/references/queues/gotchas.md +112 -0
  261. package/.codex/skills/cloudflare/references/queues/patterns.md +155 -0
  262. package/.codex/skills/cloudflare/references/r2/README.md +61 -0
  263. package/.codex/skills/cloudflare/references/r2/api.md +127 -0
  264. package/.codex/skills/cloudflare/references/r2/configuration.md +76 -0
  265. package/.codex/skills/cloudflare/references/r2/gotchas.md +94 -0
  266. package/.codex/skills/cloudflare/references/r2/patterns.md +127 -0
  267. package/.codex/skills/cloudflare/references/r2-data-catalog/README.md +18 -0
  268. package/.codex/skills/cloudflare/references/r2-data-catalog/api.md +29 -0
  269. package/.codex/skills/cloudflare/references/r2-data-catalog/configuration.md +39 -0
  270. package/.codex/skills/cloudflare/references/r2-data-catalog/gotchas.md +20 -0
  271. package/.codex/skills/cloudflare/references/r2-data-catalog/patterns.md +46 -0
  272. package/.codex/skills/cloudflare/references/r2-sql/README.md +512 -0
  273. package/.codex/skills/cloudflare/references/realtime-sfu/README.md +21 -0
  274. package/.codex/skills/cloudflare/references/realtime-sfu/api.md +135 -0
  275. package/.codex/skills/cloudflare/references/realtime-sfu/configuration.md +63 -0
  276. package/.codex/skills/cloudflare/references/realtime-sfu/gotchas.md +75 -0
  277. package/.codex/skills/cloudflare/references/realtime-sfu/patterns.md +102 -0
  278. package/.codex/skills/cloudflare/references/realtimekit/README.md +81 -0
  279. package/.codex/skills/cloudflare/references/realtimekit/api.md +164 -0
  280. package/.codex/skills/cloudflare/references/realtimekit/configuration.md +147 -0
  281. package/.codex/skills/cloudflare/references/realtimekit/gotchas.md +172 -0
  282. package/.codex/skills/cloudflare/references/realtimekit/patterns.md +155 -0
  283. package/.codex/skills/cloudflare/references/sandbox/README.md +90 -0
  284. package/.codex/skills/cloudflare/references/sandbox/api.md +178 -0
  285. package/.codex/skills/cloudflare/references/sandbox/configuration.md +131 -0
  286. package/.codex/skills/cloudflare/references/sandbox/gotchas.md +156 -0
  287. package/.codex/skills/cloudflare/references/sandbox/patterns.md +203 -0
  288. package/.codex/skills/cloudflare/references/secrets-store/README.md +58 -0
  289. package/.codex/skills/cloudflare/references/secrets-store/api.md +182 -0
  290. package/.codex/skills/cloudflare/references/secrets-store/configuration.md +140 -0
  291. package/.codex/skills/cloudflare/references/secrets-store/gotchas.md +129 -0
  292. package/.codex/skills/cloudflare/references/secrets-store/patterns.md +218 -0
  293. package/.codex/skills/cloudflare/references/smart-placement/README.md +91 -0
  294. package/.codex/skills/cloudflare/references/smart-placement/api.md +139 -0
  295. package/.codex/skills/cloudflare/references/smart-placement/configuration.md +129 -0
  296. package/.codex/skills/cloudflare/references/smart-placement/gotchas.md +87 -0
  297. package/.codex/skills/cloudflare/references/smart-placement/patterns.md +135 -0
  298. package/.codex/skills/cloudflare/references/snippets/README.md +15 -0
  299. package/.codex/skills/cloudflare/references/snippets/api.md +47 -0
  300. package/.codex/skills/cloudflare/references/snippets/configuration.md +33 -0
  301. package/.codex/skills/cloudflare/references/snippets/gotchas.md +21 -0
  302. package/.codex/skills/cloudflare/references/snippets/patterns.md +34 -0
  303. package/.codex/skills/cloudflare/references/spectrum/README.md +16 -0
  304. package/.codex/skills/cloudflare/references/spectrum/api.md +24 -0
  305. package/.codex/skills/cloudflare/references/spectrum/configuration.md +43 -0
  306. package/.codex/skills/cloudflare/references/spectrum/gotchas.md +42 -0
  307. package/.codex/skills/cloudflare/references/spectrum/patterns.md +40 -0
  308. package/.codex/skills/cloudflare/references/static-assets/README.md +14 -0
  309. package/.codex/skills/cloudflare/references/static-assets/api.md +3 -0
  310. package/.codex/skills/cloudflare/references/static-assets/configuration.md +47 -0
  311. package/.codex/skills/cloudflare/references/static-assets/gotchas.md +44 -0
  312. package/.codex/skills/cloudflare/references/static-assets/patterns.md +42 -0
  313. package/.codex/skills/cloudflare/references/stream/README.md +103 -0
  314. package/.codex/skills/cloudflare/references/stream/api.md +204 -0
  315. package/.codex/skills/cloudflare/references/stream/configuration.md +127 -0
  316. package/.codex/skills/cloudflare/references/stream/gotchas.md +131 -0
  317. package/.codex/skills/cloudflare/references/stream/patterns.md +152 -0
  318. package/.codex/skills/cloudflare/references/tail-workers/README.md +640 -0
  319. package/.codex/skills/cloudflare/references/terraform/README.md +76 -0
  320. package/.codex/skills/cloudflare/references/terraform/api.md +159 -0
  321. package/.codex/skills/cloudflare/references/terraform/configuration.md +156 -0
  322. package/.codex/skills/cloudflare/references/terraform/gotchas.md +207 -0
  323. package/.codex/skills/cloudflare/references/terraform/patterns.md +135 -0
  324. package/.codex/skills/cloudflare/references/tunnel/README.md +82 -0
  325. package/.codex/skills/cloudflare/references/tunnel/api.md +105 -0
  326. package/.codex/skills/cloudflare/references/tunnel/configuration.md +113 -0
  327. package/.codex/skills/cloudflare/references/tunnel/gotchas.md +115 -0
  328. package/.codex/skills/cloudflare/references/tunnel/patterns.md +157 -0
  329. package/.codex/skills/cloudflare/references/turn/README.md +699 -0
  330. package/.codex/skills/cloudflare/references/turnstile/README.md +14 -0
  331. package/.codex/skills/cloudflare/references/turnstile/api.md +3 -0
  332. package/.codex/skills/cloudflare/references/turnstile/configuration.md +19 -0
  333. package/.codex/skills/cloudflare/references/turnstile/gotchas.md +27 -0
  334. package/.codex/skills/cloudflare/references/turnstile/patterns.md +41 -0
  335. package/.codex/skills/cloudflare/references/vectorize/README.md +682 -0
  336. package/.codex/skills/cloudflare/references/waf/README.md +14 -0
  337. package/.codex/skills/cloudflare/references/waf/api.md +3 -0
  338. package/.codex/skills/cloudflare/references/waf/configuration.md +44 -0
  339. package/.codex/skills/cloudflare/references/waf/gotchas.md +24 -0
  340. package/.codex/skills/cloudflare/references/waf/patterns.md +29 -0
  341. package/.codex/skills/cloudflare/references/web-analytics/README.md +19 -0
  342. package/.codex/skills/cloudflare/references/web-analytics/api.md +52 -0
  343. package/.codex/skills/cloudflare/references/web-analytics/configuration.md +31 -0
  344. package/.codex/skills/cloudflare/references/web-analytics/gotchas.md +28 -0
  345. package/.codex/skills/cloudflare/references/web-analytics/patterns.md +52 -0
  346. package/.codex/skills/cloudflare/references/workerd/README.md +47 -0
  347. package/.codex/skills/cloudflare/references/workerd/api.md +199 -0
  348. package/.codex/skills/cloudflare/references/workerd/configuration.md +185 -0
  349. package/.codex/skills/cloudflare/references/workerd/gotchas.md +203 -0
  350. package/.codex/skills/cloudflare/references/workerd/patterns.md +216 -0
  351. package/.codex/skills/cloudflare/references/workers/README.md +96 -0
  352. package/.codex/skills/cloudflare/references/workers/api.md +137 -0
  353. package/.codex/skills/cloudflare/references/workers/configuration.md +147 -0
  354. package/.codex/skills/cloudflare/references/workers/gotchas.md +99 -0
  355. package/.codex/skills/cloudflare/references/workers/patterns.md +149 -0
  356. package/.codex/skills/cloudflare/references/workers-ai/README.md +116 -0
  357. package/.codex/skills/cloudflare/references/workers-for-platforms/README.md +48 -0
  358. package/.codex/skills/cloudflare/references/workers-for-platforms/api.md +169 -0
  359. package/.codex/skills/cloudflare/references/workers-for-platforms/configuration.md +136 -0
  360. package/.codex/skills/cloudflare/references/workers-for-platforms/gotchas.md +130 -0
  361. package/.codex/skills/cloudflare/references/workers-for-platforms/patterns.md +170 -0
  362. package/.codex/skills/cloudflare/references/workers-playground/README.md +16 -0
  363. package/.codex/skills/cloudflare/references/workers-playground/api.md +20 -0
  364. package/.codex/skills/cloudflare/references/workers-playground/configuration.md +3 -0
  365. package/.codex/skills/cloudflare/references/workers-playground/gotchas.md +35 -0
  366. package/.codex/skills/cloudflare/references/workers-playground/patterns.md +42 -0
  367. package/.codex/skills/cloudflare/references/workers-vpc/README.md +579 -0
  368. package/.codex/skills/cloudflare/references/workflows/README.md +62 -0
  369. package/.codex/skills/cloudflare/references/workflows/api.md +125 -0
  370. package/.codex/skills/cloudflare/references/workflows/configuration.md +177 -0
  371. package/.codex/skills/cloudflare/references/workflows/gotchas.md +136 -0
  372. package/.codex/skills/cloudflare/references/workflows/patterns.md +132 -0
  373. package/.codex/skills/cloudflare/references/wrangler/README.md +90 -0
  374. package/.codex/skills/cloudflare/references/wrangler/api.md +140 -0
  375. package/.codex/skills/cloudflare/references/wrangler/configuration.md +128 -0
  376. package/.codex/skills/cloudflare/references/wrangler/gotchas.md +93 -0
  377. package/.codex/skills/cloudflare/references/wrangler/patterns.md +150 -0
  378. package/.codex/skills/cloudflare/references/zaraz/README.md +360 -0
  379. package/.codex/skills/code-navigation/SKILL.md +130 -0
  380. package/.codex/skills/code-review/SKILL.md +208 -0
  381. package/.codex/skills/compaction/SKILL.md +317 -0
  382. package/.codex/skills/condition-based-waiting/SKILL.md +123 -0
  383. package/.codex/skills/condition-based-waiting/example.ts +158 -0
  384. package/.codex/skills/context-engineering/SKILL.md +176 -0
  385. package/.codex/skills/context-initialization/SKILL.md +70 -0
  386. package/.codex/skills/context-management/SKILL.md +163 -0
  387. package/.codex/skills/core-data-expert/SKILL.md +93 -0
  388. package/.codex/skills/core-data-expert/references/batch-operations.md +543 -0
  389. package/.codex/skills/core-data-expert/references/cloudkit-integration.md +259 -0
  390. package/.codex/skills/core-data-expert/references/concurrency.md +522 -0
  391. package/.codex/skills/core-data-expert/references/fetch-requests.md +643 -0
  392. package/.codex/skills/core-data-expert/references/glossary.md +233 -0
  393. package/.codex/skills/core-data-expert/references/migration.md +393 -0
  394. package/.codex/skills/core-data-expert/references/model-configuration.md +597 -0
  395. package/.codex/skills/core-data-expert/references/performance.md +300 -0
  396. package/.codex/skills/core-data-expert/references/persistent-history.md +553 -0
  397. package/.codex/skills/core-data-expert/references/project-audit.md +60 -0
  398. package/.codex/skills/core-data-expert/references/saving.md +574 -0
  399. package/.codex/skills/core-data-expert/references/stack-setup.md +625 -0
  400. package/.codex/skills/core-data-expert/references/testing.md +300 -0
  401. package/.codex/skills/core-data-expert/references/threading.md +589 -0
  402. package/.codex/skills/debugging/SKILL.md +203 -0
  403. package/.codex/skills/deep-research/SKILL.md +384 -0
  404. package/.codex/skills/defense-in-depth/SKILL.md +166 -0
  405. package/.codex/skills/dependency-upgrades/SKILL.md +198 -0
  406. package/.codex/skills/design-system-audit/SKILL.md +153 -0
  407. package/.codex/skills/development-lifecycle/SKILL.md +356 -0
  408. package/.codex/skills/dispatching-parallel-agents/SKILL.md +191 -0
  409. package/.codex/skills/docs-handoff/SKILL.md +175 -0
  410. package/.codex/skills/executing-plans/SKILL.md +247 -0
  411. package/.codex/skills/figma/SKILL.md +224 -0
  412. package/.codex/skills/figma/mcp.json +6 -0
  413. package/.codex/skills/finishing-a-development-branch/SKILL.md +357 -0
  414. package/.codex/skills/frontend-design/SKILL.md +176 -0
  415. package/.codex/skills/gemini-large-context/SKILL.md +216 -0
  416. package/.codex/skills/git-pr-prep/SKILL.md +179 -0
  417. package/.codex/skills/index-knowledge/SKILL.md +413 -0
  418. package/.codex/skills/jira/SKILL.md +283 -0
  419. package/.codex/skills/jira/mcp.json +6 -0
  420. package/.codex/skills/memory-system/SKILL.md +93 -0
  421. package/.codex/skills/mockup-to-code/SKILL.md +184 -0
  422. package/.codex/skills/mqdh/SKILL.md +171 -0
  423. package/.codex/skills/obsidian/SKILL.md +187 -0
  424. package/.codex/skills/obsidian/mcp.json +22 -0
  425. package/.codex/skills/opensrc/SKILL.md +127 -0
  426. package/.codex/skills/opensrc/references/architecture.md +176 -0
  427. package/.codex/skills/opensrc/references/cli-usage.md +176 -0
  428. package/.codex/skills/opensrc/references/registry-support.md +137 -0
  429. package/.codex/skills/pdf-extract/SKILL.md +438 -0
  430. package/.codex/skills/playwright/SKILL.md +320 -0
  431. package/.codex/skills/playwright/mcp.json +16 -0
  432. package/.codex/skills/playwriter/SKILL.md +158 -0
  433. package/.codex/skills/polar/SKILL.md +102 -0
  434. package/.codex/skills/prd/SKILL.md +146 -0
  435. package/.codex/skills/prd-task/SKILL.md +182 -0
  436. package/.codex/skills/prd-task/references/prd-schema.json +124 -0
  437. package/.codex/skills/prompt-leverage/SKILL.md +69 -0
  438. package/.codex/skills/prompt-leverage/agents/openai.yaml +4 -0
  439. package/.codex/skills/prompt-leverage/references/framework.md +91 -0
  440. package/.codex/skills/prompt-leverage/scripts/augment_prompt.py +114 -0
  441. package/.codex/skills/ralph/SKILL.md +296 -0
  442. package/.codex/skills/react-best-practices/AGENTS.md +2410 -0
  443. package/.codex/skills/react-best-practices/README.md +123 -0
  444. package/.codex/skills/react-best-practices/SKILL.md +133 -0
  445. package/.codex/skills/react-best-practices/metadata.json +15 -0
  446. package/.codex/skills/react-best-practices/rules/_sections.md +46 -0
  447. package/.codex/skills/react-best-practices/rules/_template.md +28 -0
  448. package/.codex/skills/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  449. package/.codex/skills/react-best-practices/rules/advanced-use-latest.md +49 -0
  450. package/.codex/skills/react-best-practices/rules/async-api-routes.md +38 -0
  451. package/.codex/skills/react-best-practices/rules/async-defer-await.md +80 -0
  452. package/.codex/skills/react-best-practices/rules/async-dependencies.md +36 -0
  453. package/.codex/skills/react-best-practices/rules/async-parallel.md +28 -0
  454. package/.codex/skills/react-best-practices/rules/async-suspense-boundaries.md +99 -0
  455. package/.codex/skills/react-best-practices/rules/bundle-barrel-imports.md +59 -0
  456. package/.codex/skills/react-best-practices/rules/bundle-conditional.md +31 -0
  457. package/.codex/skills/react-best-practices/rules/bundle-defer-third-party.md +49 -0
  458. package/.codex/skills/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  459. package/.codex/skills/react-best-practices/rules/bundle-preload.md +50 -0
  460. package/.codex/skills/react-best-practices/rules/client-event-listeners.md +74 -0
  461. package/.codex/skills/react-best-practices/rules/client-localstorage-schema.md +71 -0
  462. package/.codex/skills/react-best-practices/rules/client-passive-event-listeners.md +48 -0
  463. package/.codex/skills/react-best-practices/rules/client-swr-dedup.md +56 -0
  464. package/.codex/skills/react-best-practices/rules/js-batch-dom-css.md +82 -0
  465. package/.codex/skills/react-best-practices/rules/js-cache-function-results.md +80 -0
  466. package/.codex/skills/react-best-practices/rules/js-cache-property-access.md +28 -0
  467. package/.codex/skills/react-best-practices/rules/js-cache-storage.md +70 -0
  468. package/.codex/skills/react-best-practices/rules/js-combine-iterations.md +32 -0
  469. package/.codex/skills/react-best-practices/rules/js-early-exit.md +50 -0
  470. package/.codex/skills/react-best-practices/rules/js-hoist-regexp.md +45 -0
  471. package/.codex/skills/react-best-practices/rules/js-index-maps.md +37 -0
  472. package/.codex/skills/react-best-practices/rules/js-length-check-first.md +49 -0
  473. package/.codex/skills/react-best-practices/rules/js-min-max-loop.md +82 -0
  474. package/.codex/skills/react-best-practices/rules/js-set-map-lookups.md +24 -0
  475. package/.codex/skills/react-best-practices/rules/js-tosorted-immutable.md +57 -0
  476. package/.codex/skills/react-best-practices/rules/rendering-activity.md +26 -0
  477. package/.codex/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  478. package/.codex/skills/react-best-practices/rules/rendering-conditional-render.md +40 -0
  479. package/.codex/skills/react-best-practices/rules/rendering-content-visibility.md +38 -0
  480. package/.codex/skills/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  481. package/.codex/skills/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  482. package/.codex/skills/react-best-practices/rules/rendering-svg-precision.md +28 -0
  483. package/.codex/skills/react-best-practices/rules/rerender-defer-reads.md +39 -0
  484. package/.codex/skills/react-best-practices/rules/rerender-dependencies.md +45 -0
  485. package/.codex/skills/react-best-practices/rules/rerender-derived-state.md +29 -0
  486. package/.codex/skills/react-best-practices/rules/rerender-functional-setstate.md +74 -0
  487. package/.codex/skills/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  488. package/.codex/skills/react-best-practices/rules/rerender-memo.md +44 -0
  489. package/.codex/skills/react-best-practices/rules/rerender-transitions.md +40 -0
  490. package/.codex/skills/react-best-practices/rules/server-after-nonblocking.md +73 -0
  491. package/.codex/skills/react-best-practices/rules/server-cache-lru.md +41 -0
  492. package/.codex/skills/react-best-practices/rules/server-cache-react.md +76 -0
  493. package/.codex/skills/react-best-practices/rules/server-parallel-fetching.md +83 -0
  494. package/.codex/skills/react-best-practices/rules/server-serialization.md +38 -0
  495. package/.codex/skills/receiving-code-review/SKILL.md +252 -0
  496. package/.codex/skills/refactoring/SKILL.md +217 -0
  497. package/.codex/skills/repo-orientation/SKILL.md +156 -0
  498. package/.codex/skills/requesting-code-review/SKILL.md +397 -0
  499. package/.codex/skills/resend/SKILL.md +177 -0
  500. package/.codex/skills/resend/references/react-email.md +287 -0
  501. package/.codex/skills/resend/references/receive-email.md +248 -0
  502. package/.codex/skills/resend/references/send-email.md +318 -0
  503. package/.codex/skills/root-cause-tracing/SKILL.md +192 -0
  504. package/.codex/skills/root-cause-tracing/find-polluter.sh +63 -0
  505. package/.codex/skills/safe-implementation/SKILL.md +205 -0
  506. package/.codex/skills/session-management/SKILL.md +10 -0
  507. package/.codex/skills/sharing-skills/SKILL.md +214 -0
  508. package/.codex/skills/skill-creator/SKILL.md +156 -0
  509. package/.codex/skills/source-code-research/SKILL.md +293 -0
  510. package/.codex/skills/source-code-research/references/analysis-tips.md +43 -0
  511. package/.codex/skills/source-code-research/references/anti-patterns.md +36 -0
  512. package/.codex/skills/source-code-research/references/common-patterns.md +57 -0
  513. package/.codex/skills/source-code-research/references/example-workflow.md +60 -0
  514. package/.codex/skills/source-code-research/references/further-reading.md +5 -0
  515. package/.codex/skills/source-code-research/references/source-structure.md +45 -0
  516. package/.codex/skills/stitch/SKILL.md +147 -0
  517. package/.codex/skills/stitch/mcp.json +9 -0
  518. package/.codex/skills/structured-edit/SKILL.md +181 -0
  519. package/.codex/skills/subagent-driven-development/SKILL.md +237 -0
  520. package/.codex/skills/supabase/SKILL.md +130 -0
  521. package/.codex/skills/supabase/mcp.json +27 -0
  522. package/.codex/skills/supabase-postgres-best-practices/AGENTS.md +1490 -0
  523. package/.codex/skills/supabase-postgres-best-practices/SKILL.md +65 -0
  524. package/.codex/skills/supabase-postgres-best-practices/rules/advanced-full-text-search.md +55 -0
  525. package/.codex/skills/supabase-postgres-best-practices/rules/advanced-jsonb-indexing.md +49 -0
  526. package/.codex/skills/supabase-postgres-best-practices/rules/conn-idle-timeout.md +46 -0
  527. package/.codex/skills/supabase-postgres-best-practices/rules/conn-limits.md +44 -0
  528. package/.codex/skills/supabase-postgres-best-practices/rules/conn-pooling.md +41 -0
  529. package/.codex/skills/supabase-postgres-best-practices/rules/conn-prepared-statements.md +46 -0
  530. package/.codex/skills/supabase-postgres-best-practices/rules/data-batch-inserts.md +54 -0
  531. package/.codex/skills/supabase-postgres-best-practices/rules/data-n-plus-one.md +53 -0
  532. package/.codex/skills/supabase-postgres-best-practices/rules/data-pagination.md +50 -0
  533. package/.codex/skills/supabase-postgres-best-practices/rules/data-upsert.md +50 -0
  534. package/.codex/skills/supabase-postgres-best-practices/rules/lock-advisory.md +56 -0
  535. package/.codex/skills/supabase-postgres-best-practices/rules/lock-deadlock-prevention.md +68 -0
  536. package/.codex/skills/supabase-postgres-best-practices/rules/lock-short-transactions.md +50 -0
  537. package/.codex/skills/supabase-postgres-best-practices/rules/lock-skip-locked.md +54 -0
  538. package/.codex/skills/supabase-postgres-best-practices/rules/monitor-explain-analyze.md +45 -0
  539. package/.codex/skills/supabase-postgres-best-practices/rules/monitor-pg-stat-statements.md +55 -0
  540. package/.codex/skills/supabase-postgres-best-practices/rules/monitor-vacuum-analyze.md +55 -0
  541. package/.codex/skills/supabase-postgres-best-practices/rules/query-composite-indexes.md +44 -0
  542. package/.codex/skills/supabase-postgres-best-practices/rules/query-covering-indexes.md +40 -0
  543. package/.codex/skills/supabase-postgres-best-practices/rules/query-index-types.md +45 -0
  544. package/.codex/skills/supabase-postgres-best-practices/rules/query-missing-indexes.md +43 -0
  545. package/.codex/skills/supabase-postgres-best-practices/rules/query-partial-indexes.md +45 -0
  546. package/.codex/skills/supabase-postgres-best-practices/rules/schema-data-types.md +46 -0
  547. package/.codex/skills/supabase-postgres-best-practices/rules/schema-foreign-key-indexes.md +59 -0
  548. package/.codex/skills/supabase-postgres-best-practices/rules/schema-lowercase-identifiers.md +55 -0
  549. package/.codex/skills/supabase-postgres-best-practices/rules/schema-partitioning.md +55 -0
  550. package/.codex/skills/supabase-postgres-best-practices/rules/schema-primary-keys.md +61 -0
  551. package/.codex/skills/supabase-postgres-best-practices/rules/security-privileges.md +54 -0
  552. package/.codex/skills/supabase-postgres-best-practices/rules/security-rls-basics.md +50 -0
  553. package/.codex/skills/supabase-postgres-best-practices/rules/security-rls-performance.md +57 -0
  554. package/.codex/skills/swarm-coordination/SKILL.md +179 -0
  555. package/.codex/skills/swarm-coordination/references/architecture.md +39 -0
  556. package/.codex/skills/swarm-coordination/references/delegation-worker-protocol.md +145 -0
  557. package/.codex/skills/swarm-coordination/references/dependency-graph.md +50 -0
  558. package/.codex/skills/swarm-coordination/references/drift-check.md +90 -0
  559. package/.codex/skills/swarm-coordination/references/integration-beads.md +20 -0
  560. package/.codex/skills/swarm-coordination/references/launch-flow.md +186 -0
  561. package/.codex/skills/swarm-coordination/references/reconciler.md +172 -0
  562. package/.codex/skills/swarm-coordination/references/tier-enforcement.md +78 -0
  563. package/.codex/skills/swarm-coordination/references/tmux-integration.md +134 -0
  564. package/.codex/skills/swift-concurrency/SKILL.md +266 -0
  565. package/.codex/skills/swift-concurrency/references/actors.md +640 -0
  566. package/.codex/skills/swift-concurrency/references/async-algorithms.md +822 -0
  567. package/.codex/skills/swift-concurrency/references/async-await-basics.md +249 -0
  568. package/.codex/skills/swift-concurrency/references/async-sequences.md +670 -0
  569. package/.codex/skills/swift-concurrency/references/core-data.md +533 -0
  570. package/.codex/skills/swift-concurrency/references/glossary.md +128 -0
  571. package/.codex/skills/swift-concurrency/references/linting.md +142 -0
  572. package/.codex/skills/swift-concurrency/references/memory-management.md +542 -0
  573. package/.codex/skills/swift-concurrency/references/migration.md +1076 -0
  574. package/.codex/skills/swift-concurrency/references/performance.md +574 -0
  575. package/.codex/skills/swift-concurrency/references/sendable.md +578 -0
  576. package/.codex/skills/swift-concurrency/references/tasks.md +604 -0
  577. package/.codex/skills/swift-concurrency/references/testing.md +565 -0
  578. package/.codex/skills/swift-concurrency/references/threading.md +452 -0
  579. package/.codex/skills/swiftui-expert-skill/SKILL.md +329 -0
  580. package/.codex/skills/swiftui-expert-skill/references/animation-advanced.md +351 -0
  581. package/.codex/skills/swiftui-expert-skill/references/animation-basics.md +284 -0
  582. package/.codex/skills/swiftui-expert-skill/references/animation-transitions.md +326 -0
  583. package/.codex/skills/swiftui-expert-skill/references/image-optimization.md +286 -0
  584. package/.codex/skills/swiftui-expert-skill/references/layout-best-practices.md +312 -0
  585. package/.codex/skills/swiftui-expert-skill/references/liquid-glass.md +377 -0
  586. package/.codex/skills/swiftui-expert-skill/references/list-patterns.md +153 -0
  587. package/.codex/skills/swiftui-expert-skill/references/modern-apis.md +400 -0
  588. package/.codex/skills/swiftui-expert-skill/references/performance-patterns.md +377 -0
  589. package/.codex/skills/swiftui-expert-skill/references/scroll-patterns.md +305 -0
  590. package/.codex/skills/swiftui-expert-skill/references/sheet-navigation-patterns.md +292 -0
  591. package/.codex/skills/swiftui-expert-skill/references/state-management.md +447 -0
  592. package/.codex/skills/swiftui-expert-skill/references/text-formatting.md +285 -0
  593. package/.codex/skills/swiftui-expert-skill/references/view-structure.md +276 -0
  594. package/.codex/skills/systematic-debugging/SKILL.md +402 -0
  595. package/.codex/skills/task-planning/SKILL.md +205 -0
  596. package/.codex/skills/test-driven-development/SKILL.md +388 -0
  597. package/.codex/skills/test-strategy/SKILL.md +186 -0
  598. package/.codex/skills/testing-anti-patterns/SKILL.md +320 -0
  599. package/.codex/skills/testing-skills-with-subagents/SKILL.md +405 -0
  600. package/.codex/skills/tilth-cli/SKILL.md +180 -0
  601. package/.codex/skills/tool-priority/SKILL.md +299 -0
  602. package/.codex/skills/ui-inspiration-scout/SKILL.md +203 -0
  603. package/.codex/skills/ui-ux-research/SKILL.md +35 -0
  604. package/.codex/skills/using-git-worktrees/SKILL.md +259 -0
  605. package/.codex/skills/using-skills/SKILL.md +117 -0
  606. package/.codex/skills/v0/SKILL.md +158 -0
  607. package/.codex/skills/v0/mcp.json +6 -0
  608. package/.codex/skills/v1-run/SKILL.md +175 -0
  609. package/.codex/skills/v1-run/mcp.json +6 -0
  610. package/.codex/skills/vercel-deploy-claimable/SKILL.md +124 -0
  611. package/.codex/skills/vercel-deploy-claimable/scripts/deploy.sh +249 -0
  612. package/.codex/skills/verification/SKILL.md +191 -0
  613. package/.codex/skills/verification-before-completion/SKILL.md +236 -0
  614. package/.codex/skills/visual-analysis/SKILL.md +154 -0
  615. package/.codex/skills/web-design-guidelines/SKILL.md +46 -0
  616. package/.codex/skills/writing-plans/SKILL.md +320 -0
  617. package/.codex/skills/writing-skills/SKILL.md +287 -0
  618. package/.codex/skills/writing-skills/anthropic-best-practices.md +1173 -0
  619. package/.codex/skills/writing-skills/graphviz-conventions.dot +172 -0
  620. package/.codex/skills/writing-skills/persuasion-principles.md +220 -0
  621. package/.codex/skills/writing-skills/references/anti-patterns.md +25 -0
  622. package/.codex/skills/writing-skills/references/claude-search-optimization.md +140 -0
  623. package/.codex/skills/writing-skills/references/discovery-workflow.md +11 -0
  624. package/.codex/skills/writing-skills/references/file-organization.md +32 -0
  625. package/.codex/skills/writing-skills/references/flowcharts-and-examples.md +57 -0
  626. package/.codex/skills/writing-skills/references/rationalization-hardening.md +75 -0
  627. package/.codex/skills/writing-skills/references/testing-skill-types.md +52 -0
  628. package/.template-manifest.json +631 -0
  629. package/AGENTS.md +719 -0
  630. package/AGENTS.override.md.example +7 -0
  631. package/CHANGELOG.md +28 -0
  632. package/LICENSE +21 -0
  633. package/README.md +641 -0
  634. package/bin/codexkit +148 -0
  635. package/install/bead-close.sh +20 -0
  636. package/install/bead-search.sh +18 -0
  637. package/install/bead-start.sh +20 -0
  638. package/install/bead-sync.sh +19 -0
  639. package/install/bead-verify.sh +20 -0
  640. package/install/generate-manifest.sh +55 -0
  641. package/install/install-global.sh +150 -0
  642. package/install/install-project.sh +704 -0
  643. package/install/install-remote.sh +152 -0
  644. package/install/patch.sh +478 -0
  645. package/install/plugin.sh +565 -0
  646. package/install/run-codex.sh +68 -0
  647. package/install/template.sh +620 -0
  648. package/install/validate.sh +653 -0
  649. package/package.json +39 -0
  650. package/templates/global/.codex-config-template.toml +87 -0
  651. package/templates/global/AGENTS.override.md +18 -0
  652. package/templates/global/README.md +29 -0
  653. package/templates/project/.codex-config-template.toml +26 -0
  654. package/templates/project/AGENTS.md.template +27 -0
  655. package/templates/project/README.md +24 -0
@@ -0,0 +1,180 @@
1
+ ---
2
+ name: tilth-cli
3
+ description: AST-aware code navigation via tilth CLI. Use when subagents need structural code search, smart file reading, or codebase mapping — complements MCP tilth (which only the main agent can access).
4
+ version: 1.0.0
5
+ tags: [code-navigation, search, subagent]
6
+ dependencies: []
7
+ ---
8
+
9
+ # tilth CLI for Subagents
10
+
11
+ > **Why this exists:** tilth MCP tools (`tilth_tilth_search`, `tilth_tilth_read`, etc.) are only available to the main agent. Subagents cannot access MCP tools but CAN use Bash. This skill teaches subagents to call tilth directly from the command line.
12
+
13
+ ## When to Use
14
+
15
+ - When subagents need structural code search (they cannot access tilth MCP tools)
16
+ - When you need `--map` for codebase skeleton (CLI-only feature, not in MCP)
17
+ - For any agent that has Bash access but not tilth MCP
18
+
19
+ ## When NOT to Use
20
+
21
+ - Main agent should prefer tilth MCP tools — they have session dedup and hash-anchored editing
22
+ - For trivial lookups where grep/read suffices
23
+
24
+ ## Prerequisites
25
+
26
+ tilth must be available. Use `npx -y tilth` if not globally installed:
27
+
28
+ ```bash
29
+ npx -y tilth <query> [options]
30
+ ```
31
+
32
+ ## How tilth CLI Works
33
+
34
+ tilth has **one command** with **smart auto-detection**. Pass a query and it figures out what to do:
35
+
36
+ | Query Pattern | Detection | Action |
37
+ | ------------- | -------------------------------- | ------------------------------------------------------- |
38
+ | `src/auth.ts` | File path (exists on disk) | **Read file** — smart outline for large, full for small |
39
+ | `handleAuth` | Symbol name (camelCase, etc.) | **Symbol search** — AST definitions + usages |
40
+ | `"*.test.ts"` | Glob pattern (contains `*`, `?`) | **File listing** — matched paths with token estimates |
41
+ | `"TODO fix"` | Text (doesn't match above) | **Text search** — literal content matches |
42
+
43
+ ## Core Operations
44
+
45
+ ### 1. Read a File
46
+
47
+ ```bash
48
+ npx -y tilth src/index.ts # Smart view (outline if large, full if small)
49
+ npx -y tilth src/index.ts --full # Force full content
50
+ npx -y tilth src/index.ts --section 45-89 # Exact line range
51
+ npx -y tilth src/index.ts --section "## Config" # By heading
52
+ ```
53
+
54
+ Output: numbered lines (`N content`). Large files get a structural outline; use `--section` to drill into specific ranges.
55
+
56
+ ### 2. Search for Symbols
57
+
58
+ ```bash
59
+ npx -y tilth initCommand --scope src/ # Find definition + all usages
60
+ npx -y tilth handleAuth --scope src/auth/ # Scoped to subdirectory
61
+ ```
62
+
63
+ Returns: definitions first (with expanded source), then usages with context lines.
64
+
65
+ ### 3. Search for Text
66
+
67
+ ```bash
68
+ npx -y tilth "TODO" --scope src/ # Literal text search
69
+ npx -y tilth "version" --scope src/ # Finds all occurrences
70
+ ```
71
+
72
+ tilth auto-detects text vs symbol. Identifiers (camelCase, snake_case) → symbol search. Multi-word or quoted strings → text search.
73
+
74
+ ### 4. List Files (Glob)
75
+
76
+ ```bash
77
+ npx -y tilth "*.test.ts" --scope src/ # List test files
78
+ npx -y tilth "*.ts" --scope src/commands/ # List TS files in subdir
79
+ ```
80
+
81
+ Returns: matched file paths with token size estimates.
82
+
83
+ ### 5. Codebase Map (CLI-Only)
84
+
85
+ ```bash
86
+ npx -y tilth --map --scope src/ # Structural skeleton
87
+ npx -y tilth --map --scope . # Whole project
88
+ ```
89
+
90
+ Returns: directory tree with exported symbols per file. **CLI-only** — not available in MCP mode.
91
+
92
+ ## Available Flags
93
+
94
+ | Flag | Purpose | Example |
95
+ | ------------------- | -------------------------------------- | -------------------- |
96
+ | `--scope <DIR>` | Restrict search to directory | `--scope src/` |
97
+ | `--section <RANGE>` | Line range or heading for file reads | `--section 45-89` |
98
+ | `--full` | Force full file content (skip outline) | `--full` |
99
+ | `--budget <N>` | Max tokens in response | `--budget 2000` |
100
+ | `--json` | Machine-readable JSON output | `--json` |
101
+ | `--map` | Generate codebase structure map | `--map --scope src/` |
102
+
103
+ **Note:** `--kind`, `--deps`, `--expand`, and multi-symbol comma syntax are MCP-only features. The CLI does not support them.
104
+
105
+ ## MCP vs CLI Comparison
106
+
107
+ | Feature | MCP (main agent) | CLI (all agents) |
108
+ | ------------------------------------- | ---------------- | ------------------- |
109
+ | Session dedup (`[shown earlier]`) | Yes | No |
110
+ | Hash-anchored editing (`tilth_edit`) | Yes | No |
111
+ | Blast-radius analysis (`tilth_deps`) | Yes | No |
112
+ | Multi-symbol search (`sym1,sym2`) | Yes | No |
113
+ | `--kind` flag (content/regex/callers) | Yes | No |
114
+ | `--expand` control | Yes | No |
115
+ | `--map` codebase skeleton | No | Yes |
116
+ | Subagent access | No (main only) | Yes (any with Bash) |
117
+ | Process overhead | Once (~17ms) | Per call (~17ms) |
118
+
119
+ ## Output Format Examples
120
+
121
+ ### File read (small file)
122
+
123
+ ```
124
+ # src/config.ts (45 lines, ~380 tokens) [full]
125
+
126
+ 1 import { z } from 'zod';
127
+ 2 export const schema = z.object({
128
+ ...
129
+ ```
130
+
131
+ ### Symbol search
132
+
133
+ ```
134
+ # Search: "initCommand" in src/ — 6 matches (2 definitions, 4 usages)
135
+
136
+ ### Definitions (2)
137
+ ## commands/init.ts:515-961 [definition]
138
+ → [515-961] export async function initCommand(...)
139
+
140
+ ### Usages — same package (4)
141
+ ## index.ts:10 [usage]
142
+ → [10] import { initCommand } from "./commands/init.js";
143
+ ```
144
+
145
+ ### Codebase map
146
+
147
+ ```
148
+ # Map: src/ (depth 3)
149
+ index.ts (~1214 tokens)
150
+ commands/
151
+ init.ts: initCommand, detectMode, ...
152
+ upgrade.ts: checkVersion, upgradeCommand, ...
153
+ utils/
154
+ errors.ts: resolveProjectPath, showError, ...
155
+ ```
156
+
157
+ ## Usage Tips
158
+
159
+ - **Search first, read second** — symbol search finds definitions AND shows expanded source
160
+ - **Use `--section` for large files** — outline tells you line ranges; drill in with `--section 44-89`
161
+ - **Use `--scope`** to narrow searches — avoids scanning irrelevant directories
162
+ - **Use `--budget`** when you need concise output (limits token count)
163
+ - **~17ms per call** — fast enough for interactive use, but avoid unnecessary repeated calls
164
+
165
+ ## Example Subagent Dispatch
166
+
167
+ ```typescript
168
+ task({
169
+ subagent_type: "general",
170
+ prompt: `Use tilth CLI for code navigation (run via: npx -y tilth).
171
+
172
+ Find the definition of \`initCommand\` and understand how it's called:
173
+ npx -y tilth initCommand --scope src/
174
+
175
+ Then read the relevant file section:
176
+ npx -y tilth src/commands/init.ts --section 515-600
177
+
178
+ [rest of task instructions]`,
179
+ });
180
+ ```
@@ -0,0 +1,299 @@
1
+ ---
2
+ name: tool-priority
3
+ description: Use when choosing between tools or need tool reference - covers LSP, search, swarm, memory, and research tools with correct syntax
4
+ version: 1.0.0
5
+ tags: [workflow, context]
6
+ dependencies: []
7
+ ---
8
+
9
+ # Tool Priority Skill
10
+
11
+ ## When to Use
12
+
13
+ - You need to decide which tool to use for a task or recall tool syntax
14
+ - You are about to edit code and want the correct discovery/order of operations
15
+
16
+ ## When NOT to Use
17
+
18
+ - You already know the exact tool and syntax required
19
+ - The task is purely conceptual with no tool usage
20
+
21
+ ## Priority Order
22
+
23
+ **LSP → Search → Swarm → Memory → File Operations**
24
+
25
+ 1. **LSP** - Semantic code intelligence (9 operations via unified tool)
26
+ 2. **tilth** (MCP) - AST-aware code search + smart file reading. Replaces grep/glob/read for code navigation when available
27
+ 3. **grep** - Fast text search (logs, config, code patterns). Replaces bash rg/grep
28
+ 4. **glob** - File discovery by name pattern. Replaces bash find/ls
29
+ 5. **skill** - Load skills for specialized knowledge
30
+ 6. **task** - Parallel subagent execution
31
+ 7. **Swarm tool** - swarm (plan, monitor, delegate, sync operations)
32
+ 8. **Memory tools** - memory-search, memory-read, memory-update, memory-admin
33
+ 9. **Research tools** - context7, websearch, codesearch, grepsearch
34
+ 10. **read/edit/write** - File operations (always read before edit)
35
+
36
+ **Golden Rule**: Always `read` before `edit` to verify content.
37
+
38
+ ## Choosing the Right Tool
39
+
40
+ Ask: **"Am I looking for semantic understanding or just text?"**
41
+
42
+ ### Code Understanding (Use LSP)
43
+
44
+ The `lsp` tool provides 9 operations via a unified interface:
45
+
46
+ | Need | Operation | Example |
47
+ | -------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------- |
48
+ | Type info at cursor | `hover` | `lsp({ operation: "hover", filePath: "src/file.ts", line: 42, character: 10 })` |
49
+ | Jump to definition | `goToDefinition` | `lsp({ operation: "goToDefinition", filePath: "src/file.ts", line: 42, character: 10 })` |
50
+ | Find all usages | `findReferences` | `lsp({ operation: "findReferences", filePath: "src/file.ts", line: 42, character: 10 })` |
51
+ | File structure | `documentSymbol` | `lsp({ operation: "documentSymbol", filePath: "src/file.ts", line: 1, character: 1 })` |
52
+ | Workspace search | `workspaceSymbol` | `lsp({ operation: "workspaceSymbol", filePath: "src/file.ts", line: 1, character: 1, query: "UserService" })` |
53
+ | Find implementations | `goToImplementation` | `lsp({ operation: "goToImplementation", filePath: "src/file.ts", line: 42, character: 10 })` |
54
+ | Call hierarchy | `prepareCallHierarchy` | `lsp({ operation: "prepareCallHierarchy", filePath: "src/file.ts", line: 42, character: 10 })` |
55
+ | Incoming calls | `incomingCalls` | `lsp({ operation: "incomingCalls", filePath: "src/file.ts", line: 42, character: 10 })` |
56
+ | Outgoing calls | `outgoingCalls` | `lsp({ operation: "outgoingCalls", filePath: "src/file.ts", line: 42, character: 10 })` |
57
+
58
+ **Critical**: Run ALL 9 LSP operations before editing. See AGENTS.md for the full checklist.
59
+
60
+ ### Text Search (Use grep)
61
+
62
+ | Need | Pattern | Example |
63
+ | ----------------- | ---------------- | ------------------------------------------ |
64
+ | Function calls | `functionName\(` | `grep({ pattern: "fetchUser\(" })` |
65
+ | Import statements | `import.*from` | `grep({ pattern: "import.*from.*react" })` |
66
+ | Error messages | `FATAL\|ERROR` | `grep({ pattern: "ERROR\|FATAL" })` |
67
+ | TODO comments | `TODO\|FIXME` | `grep({ pattern: "TODO\|FIXME" })` |
68
+ | Hook usage | `useState\(` | `grep({ pattern: "useState\(" })` |
69
+ | Debug logs | `console\.log` | `grep({ pattern: "console\.log" })` |
70
+
71
+ ### Load Skills (Use skill tool)
72
+
73
+ Load specialized knowledge before starting work:
74
+
75
+ ```typescript
76
+ // Essential skills for most work
77
+ skill({ name: "verification-before-completion" });
78
+ skill({ name: "test-driven-development" });
79
+
80
+ // Domain-specific skills
81
+ skill({ name: "beads" }); // Task tracking
82
+ skill({ name: "beads-bridge" }); // Swarm coordination
83
+ skill({ name: "swarm-coordination" }); // Parallel execution
84
+ skill({ name: "frontend-design" }); // UI implementation
85
+ skill({ name: "prd" }); // Requirements documents
86
+ ```
87
+
88
+ ### Parallel Execution (Use Task tool)
89
+
90
+ Launch multiple subagents simultaneously:
91
+
92
+ ```typescript
93
+ // Workers run in parallel when multiple Task calls in one message
94
+ Task({
95
+ subagent_type: "explore",
96
+ description: "Find patterns",
97
+ prompt: `Find auth patterns in codebase...`,
98
+ });
99
+
100
+ Task({
101
+ subagent_type: "scout",
102
+ description: "Research docs",
103
+ prompt: `Research best practices for...`,
104
+ });
105
+ // Results return when both complete
106
+ ```
107
+
108
+ **Subagent types**: `general`, `explore`, `scout`, `review`, `plan`
109
+
110
+ ### Swarm Coordination Tools
111
+
112
+ | Tool | Purpose | Key Operations |
113
+ | --------- | -------------------------- | ------------------------------------- |
114
+ | **swarm** | Unified swarm coordination | `plan`, `monitor`, `delegate`, `sync` |
115
+
116
+ **swarm operations:**
117
+
118
+ - `plan`: Task analysis (actions: analyze, classify, check, allocate)
119
+ - `monitor`: Progress tracking (actions: progress_update, render_block, status, clear)
120
+ - `delegate`: Create delegation packets for workers
121
+ - `sync`: Beads state sync and export flow (actions: push, pull, create_shared, update_shared)
122
+
123
+ ### Memory Tools
124
+
125
+ | Tool | Purpose | When to Use |
126
+ | ----------------- | ------------------------- | ----------------------------------- |
127
+ | **memory-search** | Find past learnings | "Have we solved this before?" |
128
+ | **memory-read** | Load specific memory file | "What did we decide about X?" |
129
+ | **memory-update** | Save context | "Document this for future sessions" |
130
+ | **observation** | Record decisions/patterns | "This is worth remembering" |
131
+
132
+ ### Research Tools
133
+
134
+ | Tool | Purpose | When to Use |
135
+ | ----------------- | --------------------------------------------------------------- | ----------------------- |
136
+ | **context7** | Library documentation lookup. Replaces manual doc searching | API reference, examples |
137
+ | **websearch** | Web search. Replaces browser for current info | Docs not in Context7 |
138
+ | **codesearch** | Code examples from GitHub. Replaces manual GitHub search | Real-world patterns |
139
+ | **grepsearch** | Cross-repo code patterns. Replaces browsing GitHub for examples | grep.app search |
140
+ | **webfetch** | Fetch specific URL content. Replaces curl/browser | User-provided links |
141
+ | **review (Task)** | Second opinion | Validate approach |
142
+
143
+ **context7 operations:**
144
+
145
+ - `resolve`: Find library ID from name (e.g., "react" → "/reactjs/react.dev")
146
+ - `query`: Get documentation for a library topic
147
+
148
+ ### With tilth MCP (When Available)
149
+
150
+ tilth provides AST-aware code intelligence. When installed, prefer tilth tools over built-in equivalents:
151
+
152
+ | Need | Without tilth | With tilth | Why tilth wins |
153
+ | --------------- | -------------------- | ------------------------------- | ------------------------------------------------------- |
154
+ | Find symbol | `grep` + `read` | `tilth_search` (expand: 2) | Returns definitions with inline source — no second read |
155
+ | Read large file | `read` (full) | `tilth_read` | Auto-outlines, shows structure; section drill-down |
156
+ | Find files | `glob` | `tilth_files` | Adds token estimates per file |
157
+ | Find callers | `lsp(incomingCalls)` | `tilth_search(kind: "callers")` | Cross-language, structural matching |
158
+ | Blast radius | Manual tracing | `tilth_deps` | Shows imports + downstream callers automatically |
159
+
160
+ **WHEN to use tilth_deps**: Before renaming, removing, or changing the signature of an export.
161
+ **SKIP**: When adding new code, fixing internal bugs, or just reading.
162
+
163
+ **IMPORTANT**: Expanded tilth_search results include full source code — do NOT re-read files already shown in search output.
164
+
165
+ ## Workflow Pattern
166
+
167
+ ```typescript
168
+ // Step 1: Load skills
169
+ skill({ name: "verification-before-completion" });
170
+ skill({ name: "beads" });
171
+
172
+ // Step 2: Find it (text search)
173
+ grep({ pattern: "functionName", path: "src/" });
174
+
175
+ // Step 3: Understand it (LSP - ALL 9 operations)
176
+ lsp({ operation: "documentSymbol", filePath: "src/file.ts", line: 1, character: 1 });
177
+ lsp({ operation: "goToDefinition", filePath: "src/file.ts", line: 42, character: 10 });
178
+ lsp({ operation: "findReferences", filePath: "src/file.ts", line: 42, character: 10 });
179
+ lsp({ operation: "hover", filePath: "src/file.ts", line: 42, character: 10 });
180
+ // ... remaining 5 operations
181
+
182
+ // Step 4: Check memory
183
+ memory_search({ query: "auth patterns" });
184
+
185
+ // Step 5: Read before edit
186
+ read({ filePath: "/absolute/path/to/file.ts" });
187
+
188
+ // Step 6: Modify
189
+ edit({ filePath: "/absolute/path/to/file.ts", oldString: "...", newString: "..." });
190
+
191
+ // Step 7: Verify
192
+ bash({ command: "npm run typecheck && npm run lint" });
193
+ ```
194
+
195
+ ## Tool Comparison
196
+
197
+ ### grep vs LSP
198
+
199
+ | Scenario | Use | Why |
200
+ | ------------------ | --------------------------- | ------------------------------------------- |
201
+ | "Find all X" | `grep` | Fast text search, includes comments/strings |
202
+ | "Where is X used?" | `lsp` with `findReferences` | Semantic, tracks actual code dependencies |
203
+ | "What type is X?" | `lsp` with `hover` | Type system intelligence |
204
+ | "Find TODOs" | `grep` | Text search across all files |
205
+
206
+ ### When to Use What
207
+
208
+ **Start with LSP when:**
209
+
210
+ - Understanding code structure
211
+ - Before any edit (ALL 9 operations)
212
+ - Tracing dependencies
213
+ - Getting type information
214
+
215
+ **Start with grep when:**
216
+
217
+ - Quick exploration ("are there any X?")
218
+ - Finding error patterns, logs, configs
219
+ - Searching across file types (JSON, YAML, etc.)
220
+
221
+ **Use skill when:**
222
+
223
+ - Starting any significant work
224
+ - Need specialized knowledge
225
+ - Following established patterns
226
+
227
+ **Use Task when:**
228
+
229
+ - Multiple independent research questions
230
+ - Parallel implementation tasks
231
+ - 3+ files need simultaneous work
232
+
233
+ ## Common Mistakes
234
+
235
+ ❌ **Wrong**: Edit without LSP
236
+
237
+ ```typescript
238
+ // DON'T: Edit without understanding structure
239
+ edit({ filePath: "src/file.ts", oldString: "...", newString: "..." });
240
+ ```
241
+
242
+ ✅ **Right**: LSP before edit
243
+
244
+ ```typescript
245
+ // DO: Run all 9 LSP operations first
246
+ lsp({ operation: "documentSymbol", filePath: "src/file.ts", line: 1, character: 1 });
247
+ lsp({ operation: "goToDefinition", filePath: "src/file.ts", line: 10, character: 5 });
248
+ // ... 7 more operations
249
+ read({ filePath: "src/file.ts" });
250
+ edit({ filePath: "src/file.ts", oldString: "...", newString: "..." });
251
+ ```
252
+
253
+ ❌ **Wrong**: Old LSP syntax
254
+
255
+ ```typescript
256
+ // DON'T: This syntax doesn't exist
257
+ lsp_lsp_hover((filePath = "src/file.ts"), (line = 42), (character = 10));
258
+ ```
259
+
260
+ ✅ **Right**: Correct LSP syntax
261
+
262
+ ```typescript
263
+ // DO: Use operation parameter
264
+ lsp({ operation: "hover", filePath: "src/file.ts", line: 42, character: 10 });
265
+ ```
266
+
267
+ ## Quick Reference
268
+
269
+ ```
270
+ BEFORE EDITING:
271
+ lsp({ operation: "documentSymbol", ... }) → File structure
272
+ lsp({ operation: "goToDefinition", ... }) → Where defined
273
+ lsp({ operation: "findReferences", ... }) → All usages
274
+ lsp({ operation: "hover", ... }) → Type info
275
+ lsp({ operation: "goToImplementation", ... }) → Implementations
276
+ lsp({ operation: "prepareCallHierarchy", ... }) → Call hierarchy
277
+ lsp({ operation: "incomingCalls", ... }) → What calls this
278
+ lsp({ operation: "outgoingCalls", ... }) → What this calls
279
+ lsp({ operation: "workspaceSymbol", ... }) → Workspace search
280
+
281
+ SEARCHING:
282
+ grep({ pattern: "...", path: "src/" }) → Text search
283
+ glob({ pattern: "**/*.ts" }) → File discovery
284
+
285
+ PARALLEL WORK:
286
+ Task({ subagent_type: "explore", ... }) → Parallel subagent
287
+ swarm({ operation: "sync", action: "push" }) → Sync to todos
288
+ swarm({ operation: "monitor", action: "progress_update" }) → Track progress
289
+
290
+ RESEARCH:
291
+ context7({ operation: "resolve", libraryName: "..." })
292
+ context7({ operation: "query", libraryId: "...", topic: "..." })
293
+ websearch({ query: "..." })
294
+ Task({ subagent_type: "review", description: "Second opinion", prompt: "Review the approach." })
295
+
296
+ MEMORY:
297
+ memory_search({ query: "..." }) → Find past learnings
298
+ observation({ type: "learning", ... }) → Record for future
299
+ ```
@@ -0,0 +1,203 @@
1
+ ---
2
+ name: ui-inspiration-scout
3
+ description: Find external UI inspiration grounded in the current codebase's design patterns. Use when you need designer-style reference hunting before implementing or revising a UI.
4
+ version: 1.0.0
5
+ tags: [ui, design, research]
6
+ dependencies: []
7
+ ---
8
+
9
+ # UI Inspiration Scout
10
+
11
+ ## When to Use
12
+
13
+ - Exploring visual directions for a new component, page, flow, or design system
14
+ - Looking for external references that fit an existing product style
15
+ - Avoiding generic AI-slop by grounding inspiration in real product patterns
16
+ - Preparing a shortlist of references before `/prompts:design` or implementation
17
+
18
+ ## When NOT to Use
19
+
20
+ - Pure code implementation tasks with no design exploration step
21
+ - Accessibility-only audits with no inspiration or visual direction work
22
+ - Library/API documentation lookups that are not about UI patterns
23
+
24
+ ## Outcome
25
+
26
+ Produce a codebase-grounded inspiration brief, not a random link dump.
27
+
28
+ The result should include:
29
+
30
+ 1. Current codebase UI signals
31
+ 2. Search brief and constraints
32
+ 3. External inspiration shortlist with verified links
33
+ 4. What to borrow, adapt, and avoid
34
+ 5. Suggested next command
35
+
36
+ ## Workflow
37
+
38
+ ### 1. Ground in the codebase first
39
+
40
+ Before searching externally, inspect the existing UI surface:
41
+
42
+ - design tokens and CSS variables
43
+ - Tailwind or CSS conventions
44
+ - key page/component patterns
45
+ - density, tone, hierarchy, card treatment, nav patterns, and motion style
46
+ - reusable primitives or design-system conventions already in use
47
+
48
+ Look at the actual code before proposing references.
49
+
50
+ Useful local targets:
51
+
52
+ - `tailwind.config.*`
53
+ - `components.json`
54
+ - `globals.css`
55
+ - `src/components/**/*`
56
+ - `src/app/**/*`
57
+ - `app/**/*`
58
+ - `pages/**/*`
59
+
60
+ Extract a short UI signature:
61
+
62
+ - product type
63
+ - interface type
64
+ - visual tone
65
+ - layout style
66
+ - interaction style
67
+ - keep / change / avoid constraints
68
+
69
+ ### 2. Build the search brief
70
+
71
+ Turn the codebase signature plus the user request into a short search brief:
72
+
73
+ - target surface: component, page, flow, system
74
+ - domain: fintech, SaaS, commerce, media, etc.
75
+ - style direction: editorial, minimal, brutalist, premium, playful, utilitarian, etc.
76
+ - implementation constraints: mobile-first, dark mode, dense tables, card-heavy, no large rewrites, etc.
77
+
78
+ Do not search with vague terms like `beautiful dashboard`.
79
+ Prefer specific combinations such as:
80
+
81
+ - `B2B analytics dashboard dense data minimal`
82
+ - `editorial pricing page luxury serif dark mode`
83
+ - `mobile settings flow calm utility ios-like`
84
+
85
+ ### 3. Search external sources deliberately
86
+
87
+ Preferred order:
88
+
89
+ 1. Exa or web/image search for current visual references
90
+ 2. Ref/docs/source search for implementation-adjacent design examples
91
+ 3. Context7 only when a UI library/framework pattern needs authoritative docs
92
+
93
+ Typical sources:
94
+
95
+ - Dribbble
96
+ - Mobbin
97
+ - Awwwards
98
+ - Land-book / Landingfolio style galleries
99
+ - High-quality product sites
100
+ - Official component library examples
101
+
102
+ Rules:
103
+
104
+ - Cite verified URLs only
105
+ - Prefer recent, implementation-relevant references over flashy concept art
106
+ - Select references that match the existing codebase trajectory, not a total redesign unless requested
107
+ - Avoid copyrighted copying; extract patterns, not clones
108
+
109
+ ### 4. Use `ui-ux-pro-max` as an optional enhancer
110
+
111
+ If the local skill `$ui-ux-pro-max` is available, use it after codebase grounding to widen:
112
+
113
+ - palette options
114
+ - typography pairings
115
+ - style alternatives
116
+ - stack-specific implementation guidance
117
+
118
+ Use it to enrich the search brief, not to replace codebase analysis.
119
+
120
+ Good pattern:
121
+
122
+ 1. inspect current UI locally
123
+ 2. define search brief
124
+ 3. optionally run `ui-ux-pro-max` design-system search
125
+ 4. search external references
126
+ 5. synthesize a shortlist tied back to the repo
127
+
128
+ ### 5. Synthesize, do not dump
129
+
130
+ Return 3-5 references max.
131
+
132
+ For each reference include:
133
+
134
+ - source
135
+ - URL
136
+ - why it matches this codebase
137
+ - what to borrow
138
+ - what to avoid copying
139
+
140
+ Then propose 2-3 design directions:
141
+
142
+ - safest evolution
143
+ - stronger visual push
144
+ - optional wildcard direction
145
+
146
+ ### 6. Hand off cleanly
147
+
148
+ Finish with:
149
+
150
+ - recommended direction
151
+ - implementation guardrails
152
+ - next command:
153
+ - `/prompts:design` for detailed design output
154
+ - `/prompts:ui-review` for critique of an existing screen
155
+ - `/prompts:start` if the direction is already settled
156
+
157
+ ## Output Template
158
+
159
+ ```markdown
160
+ ## Codebase UI Signature
161
+ - Product/UI type:
162
+ - Current patterns:
163
+ - Keep:
164
+ - Change:
165
+ - Avoid:
166
+
167
+ ## Search Brief
168
+ - Query themes:
169
+ - Constraints:
170
+ - Source preference:
171
+
172
+ ## Inspiration Shortlist
173
+ 1. [Title](https://...)
174
+ - Match:
175
+ - Borrow:
176
+ - Avoid:
177
+
178
+ ## Directions
179
+ ### Direction A
180
+ ### Direction B
181
+ ### Direction C
182
+
183
+ ## Recommendation
184
+ - Best fit:
185
+ - Why:
186
+ - Next step:
187
+ ```
188
+
189
+ ## Anti-Patterns
190
+
191
+ - Starting from Dribbble before reading the actual UI code
192
+ - Dumping 10+ links with no synthesis
193
+ - Recommending a full visual reset when the user asked for iteration
194
+ - Mixing incompatible visual languages with no rationale
195
+ - Using Context7 as a moodboard search tool instead of authoritative UI-library docs
196
+
197
+ ## Verification
198
+
199
+ - Did you read the current UI code first?
200
+ - Are all cited links verified?
201
+ - Does every reference include a match rationale?
202
+ - Did you distinguish what to borrow from what to avoid?
203
+ - Is the recommendation implementable in this repo's current stack?