adevkit 0.1.0__py3-none-any.whl

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 (731) hide show
  1. adevkit-0.1.0.dist-info/METADATA +171 -0
  2. adevkit-0.1.0.dist-info/RECORD +731 -0
  3. adevkit-0.1.0.dist-info/WHEEL +5 -0
  4. adevkit-0.1.0.dist-info/entry_points.txt +3 -0
  5. adevkit-0.1.0.dist-info/top_level.txt +1 -0
  6. devkit/__init__.py +4 -0
  7. devkit/cli.py +442 -0
  8. devkit/config.py +21 -0
  9. devkit/prompts.py +197 -0
  10. devkit/scaffold/__init__.py +16 -0
  11. devkit/scaffold/agents_md.py +152 -0
  12. devkit/scaffold/env_setup.py +59 -0
  13. devkit/scaffold/git_setup.py +69 -0
  14. devkit/scaffold/prd_md.py +85 -0
  15. devkit/scaffold/vscode_setup.py +38 -0
  16. devkit/skills/__init__.py +10 -0
  17. devkit/skills/catalog.py +156 -0
  18. devkit/skills/embedded/SKILL.md +52 -0
  19. devkit/skills/embedded/animate/RECIPES.md +324 -0
  20. devkit/skills/embedded/animate/SKILL.md +207 -0
  21. devkit/skills/embedded/animate-expo/RECIPES.md +385 -0
  22. devkit/skills/embedded/animate-expo/SKILL.md +263 -0
  23. devkit/skills/embedded/animation-performance/SKILL.md +222 -0
  24. devkit/skills/embedded/animation-vocabulary/SKILL.md +181 -0
  25. devkit/skills/embedded/apple-design/SKILL.md +290 -0
  26. devkit/skills/embedded/ask-sonner/API.md +64 -0
  27. devkit/skills/embedded/ask-sonner/SKILL.md +88 -0
  28. devkit/skills/embedded/banner-design/SKILL.md +145 -0
  29. devkit/skills/embedded/banner-design/references/banner-sizes-and-styles.md +118 -0
  30. devkit/skills/embedded/brand/SKILL.md +108 -0
  31. devkit/skills/embedded/brand/references/approval-checklist.md +169 -0
  32. devkit/skills/embedded/brand/references/asset-organization.md +157 -0
  33. devkit/skills/embedded/brand/references/brand-guideline-template.md +140 -0
  34. devkit/skills/embedded/brand/references/color-palette-management.md +186 -0
  35. devkit/skills/embedded/brand/references/consistency-checklist.md +94 -0
  36. devkit/skills/embedded/brand/references/logo-usage-rules.md +185 -0
  37. devkit/skills/embedded/brand/references/messaging-framework.md +85 -0
  38. devkit/skills/embedded/brand/references/typography-specifications.md +214 -0
  39. devkit/skills/embedded/brand/references/update.md +129 -0
  40. devkit/skills/embedded/brand/references/visual-identity.md +96 -0
  41. devkit/skills/embedded/brand/references/voice-framework.md +88 -0
  42. devkit/skills/embedded/brand/scripts/extract-colors.cjs +337 -0
  43. devkit/skills/embedded/brand/scripts/inject-brand-context.cjs +349 -0
  44. devkit/skills/embedded/brand/scripts/sync-brand-to-tokens.cjs +415 -0
  45. devkit/skills/embedded/brand/scripts/tests/test_sync_brand_to_tokens.py +368 -0
  46. devkit/skills/embedded/brand/scripts/validate-asset.cjs +387 -0
  47. devkit/skills/embedded/brand/templates/brand-guidelines-starter.md +275 -0
  48. devkit/skills/embedded/break-ui/CATALOG.md +135 -0
  49. devkit/skills/embedded/break-ui/SKILL.md +175 -0
  50. devkit/skills/embedded/chrome-devtools/SKILL.md +74 -0
  51. devkit/skills/embedded/deploy-to-vercel/Archive.zip +0 -0
  52. devkit/skills/embedded/deploy-to-vercel/SKILL.md +296 -0
  53. devkit/skills/embedded/deploy-to-vercel/resources/deploy-codex.sh +301 -0
  54. devkit/skills/embedded/deploy-to-vercel/resources/deploy.sh +301 -0
  55. devkit/skills/embedded/design/SKILL.md +333 -0
  56. devkit/skills/embedded/design/data/cip/deliverables.csv +51 -0
  57. devkit/skills/embedded/design/data/cip/industries.csv +21 -0
  58. devkit/skills/embedded/design/data/cip/mockup-contexts.csv +21 -0
  59. devkit/skills/embedded/design/data/cip/styles.csv +21 -0
  60. devkit/skills/embedded/design/data/icon/styles.csv +16 -0
  61. devkit/skills/embedded/design/data/logo/colors.csv +56 -0
  62. devkit/skills/embedded/design/data/logo/industries.csv +56 -0
  63. devkit/skills/embedded/design/data/logo/styles.csv +56 -0
  64. devkit/skills/embedded/design/references/banner-sizes-and-styles.md +118 -0
  65. devkit/skills/embedded/design/references/cip-deliverable-guide.md +95 -0
  66. devkit/skills/embedded/design/references/cip-design.md +123 -0
  67. devkit/skills/embedded/design/references/cip-prompt-engineering.md +84 -0
  68. devkit/skills/embedded/design/references/cip-style-guide.md +68 -0
  69. devkit/skills/embedded/design/references/design-routing.md +207 -0
  70. devkit/skills/embedded/design/references/icon-design.md +122 -0
  71. devkit/skills/embedded/design/references/logo-color-psychology.md +101 -0
  72. devkit/skills/embedded/design/references/logo-design.md +110 -0
  73. devkit/skills/embedded/design/references/logo-prompt-engineering.md +158 -0
  74. devkit/skills/embedded/design/references/logo-style-guide.md +109 -0
  75. devkit/skills/embedded/design/references/slides-copywriting-formulas.md +84 -0
  76. devkit/skills/embedded/design/references/slides-create.md +4 -0
  77. devkit/skills/embedded/design/references/slides-html-template.md +295 -0
  78. devkit/skills/embedded/design/references/slides-layout-patterns.md +137 -0
  79. devkit/skills/embedded/design/references/slides-strategies.md +94 -0
  80. devkit/skills/embedded/design/references/slides.md +42 -0
  81. devkit/skills/embedded/design/references/social-photos-design.md +329 -0
  82. devkit/skills/embedded/design/scripts/cip/core.py +215 -0
  83. devkit/skills/embedded/design/scripts/cip/generate.py +504 -0
  84. devkit/skills/embedded/design/scripts/cip/render-html.py +424 -0
  85. devkit/skills/embedded/design/scripts/cip/search.py +127 -0
  86. devkit/skills/embedded/design/scripts/icon/generate.py +535 -0
  87. devkit/skills/embedded/design/scripts/logo/core.py +175 -0
  88. devkit/skills/embedded/design/scripts/logo/generate.py +812 -0
  89. devkit/skills/embedded/design/scripts/logo/search.py +114 -0
  90. devkit/skills/embedded/design/scripts/logo/tests/test_generate.py +454 -0
  91. devkit/skills/embedded/design/scripts/tests/test_cip_generate.py +134 -0
  92. devkit/skills/embedded/design/scripts/tests/test_icon_generate.py +178 -0
  93. devkit/skills/embedded/design-system/SKILL.md +248 -0
  94. devkit/skills/embedded/design-system/data/slide-backgrounds.csv +11 -0
  95. devkit/skills/embedded/design-system/data/slide-charts.csv +26 -0
  96. devkit/skills/embedded/design-system/data/slide-color-logic.csv +14 -0
  97. devkit/skills/embedded/design-system/data/slide-copy.csv +26 -0
  98. devkit/skills/embedded/design-system/data/slide-layout-logic.csv +16 -0
  99. devkit/skills/embedded/design-system/data/slide-layouts.csv +26 -0
  100. devkit/skills/embedded/design-system/data/slide-strategies.csv +16 -0
  101. devkit/skills/embedded/design-system/data/slide-typography.csv +15 -0
  102. devkit/skills/embedded/design-system/references/component-specs.md +236 -0
  103. devkit/skills/embedded/design-system/references/component-tokens.md +214 -0
  104. devkit/skills/embedded/design-system/references/primitive-tokens.md +203 -0
  105. devkit/skills/embedded/design-system/references/semantic-tokens.md +215 -0
  106. devkit/skills/embedded/design-system/references/states-and-variants.md +241 -0
  107. devkit/skills/embedded/design-system/references/tailwind-integration.md +251 -0
  108. devkit/skills/embedded/design-system/references/token-architecture.md +224 -0
  109. devkit/skills/embedded/design-system/scripts/embed-tokens.cjs +103 -0
  110. devkit/skills/embedded/design-system/scripts/fetch-background.py +339 -0
  111. devkit/skills/embedded/design-system/scripts/generate-slide.py +770 -0
  112. devkit/skills/embedded/design-system/scripts/generate-tokens.cjs +205 -0
  113. devkit/skills/embedded/design-system/scripts/html-token-validator.py +359 -0
  114. devkit/skills/embedded/design-system/scripts/search-slides.py +228 -0
  115. devkit/skills/embedded/design-system/scripts/slide-token-validator.py +35 -0
  116. devkit/skills/embedded/design-system/scripts/slide_search_core.py +453 -0
  117. devkit/skills/embedded/design-system/scripts/tests/test_validate_tokens.py +52 -0
  118. devkit/skills/embedded/design-system/scripts/validate-tokens.cjs +246 -0
  119. devkit/skills/embedded/design-system/templates/design-tokens-starter.json +143 -0
  120. devkit/skills/embedded/design-taste-frontend/README.md +81 -0
  121. devkit/skills/embedded/design-taste-frontend/SKILL.md +542 -0
  122. devkit/skills/embedded/design-taste-frontend/assets/app.css +216 -0
  123. devkit/skills/embedded/design-taste-frontend/assets/base.css +105 -0
  124. devkit/skills/embedded/design-taste-frontend/assets/base.js +37 -0
  125. devkit/skills/embedded/design-taste-frontend/assets/charts.js +619 -0
  126. devkit/skills/embedded/design-taste-frontend/assets/scenes/stage.css +28 -0
  127. devkit/skills/embedded/design-taste-frontend/assets/scenes/stage.js +134 -0
  128. devkit/skills/embedded/design-taste-frontend/evals/evals.json +76 -0
  129. devkit/skills/embedded/design-taste-frontend/library/app.json +1327 -0
  130. devkit/skills/embedded/design-taste-frontend/library/directions.json +1078 -0
  131. devkit/skills/embedded/design-taste-frontend/library/heroes.json +1086 -0
  132. devkit/skills/embedded/design-taste-frontend/library/motions.json +92 -0
  133. devkit/skills/embedded/design-taste-frontend/library/palettes.json +1485 -0
  134. devkit/skills/embedded/design-taste-frontend/library/photos.json +7240 -0
  135. devkit/skills/embedded/design-taste-frontend/library/sections.json +4429 -0
  136. devkit/skills/embedded/design-taste-frontend/library/sites.json +8350 -0
  137. devkit/skills/embedded/design-taste-frontend/library/type.json +2024 -0
  138. devkit/skills/embedded/design-taste-frontend/references/app-screens.md +1199 -0
  139. devkit/skills/embedded/design-taste-frontend/references/colour.md +141 -0
  140. devkit/skills/embedded/design-taste-frontend/references/copy.md +177 -0
  141. devkit/skills/embedded/design-taste-frontend/references/critique.md +182 -0
  142. devkit/skills/embedded/design-taste-frontend/references/imagery.md +791 -0
  143. devkit/skills/embedded/design-taste-frontend/references/layout.md +292 -0
  144. devkit/skills/embedded/design-taste-frontend/references/motion.md +980 -0
  145. devkit/skills/embedded/design-taste-frontend/references/research.md +356 -0
  146. devkit/skills/embedded/design-taste-frontend/references/scenes.md +174 -0
  147. devkit/skills/embedded/design-taste-frontend/references/tells.md +115 -0
  148. devkit/skills/embedded/design-taste-frontend/references/type.md +170 -0
  149. devkit/skills/embedded/design-taste-frontend/scripts/assets.mjs +865 -0
  150. devkit/skills/embedded/design-taste-frontend/scripts/draw.mjs +584 -0
  151. devkit/skills/embedded/design-taste-frontend/scripts/inspect.mjs +308 -0
  152. devkit/skills/embedded/design-taste-frontend/scripts/lib/app-draw.mjs +203 -0
  153. devkit/skills/embedded/design-taste-frontend/scripts/lib/cdp.mjs +248 -0
  154. devkit/skills/embedded/design-taste-frontend/scripts/lib/inspection-files.mjs +9 -0
  155. devkit/skills/embedded/design-taste-frontend/scripts/lib/probe.mjs +929 -0
  156. devkit/skills/embedded/design-taste-frontend/scripts/lib/rules.mjs +243 -0
  157. devkit/skills/embedded/design-taste-frontend/scripts/lint.mjs +119 -0
  158. devkit/skills/embedded/design-taste-frontend/scripts/scenes.mjs +124 -0
  159. devkit/skills/embedded/emil-design-eng/SKILL.md +674 -0
  160. devkit/skills/embedded/find-animation-opportunities/SKILL.md +140 -0
  161. devkit/skills/embedded/gemini-api-dev/SKILL.md +458 -0
  162. devkit/skills/embedded/gemini-api-dev/references/migration.md +180 -0
  163. devkit/skills/embedded/impeccable/SKILL.md +86 -0
  164. devkit/skills/embedded/impeccable/agents/impeccable_asset_producer.toml +47 -0
  165. devkit/skills/embedded/impeccable/agents/impeccable_documenter.toml +27 -0
  166. devkit/skills/embedded/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
  167. devkit/skills/embedded/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
  168. devkit/skills/embedded/impeccable/agents/openai.yaml +4 -0
  169. devkit/skills/embedded/impeccable/reference/adapt.md +318 -0
  170. devkit/skills/embedded/impeccable/reference/adapt.native.md +58 -0
  171. devkit/skills/embedded/impeccable/reference/android.md +46 -0
  172. devkit/skills/embedded/impeccable/reference/animate.md +89 -0
  173. devkit/skills/embedded/impeccable/reference/audit.md +139 -0
  174. devkit/skills/embedded/impeccable/reference/audit.native.md +139 -0
  175. devkit/skills/embedded/impeccable/reference/bolder.md +33 -0
  176. devkit/skills/embedded/impeccable/reference/clarify.md +94 -0
  177. devkit/skills/embedded/impeccable/reference/colorize.md +86 -0
  178. devkit/skills/embedded/impeccable/reference/component-review.md +63 -0
  179. devkit/skills/embedded/impeccable/reference/craft-floor.md +50 -0
  180. devkit/skills/embedded/impeccable/reference/craft.md +5 -0
  181. devkit/skills/embedded/impeccable/reference/critique.md +841 -0
  182. devkit/skills/embedded/impeccable/reference/degraded/asset-producer.md +44 -0
  183. devkit/skills/embedded/impeccable/reference/degraded/documenter.md +24 -0
  184. devkit/skills/embedded/impeccable/reference/degraded/finish-reviewer.md +38 -0
  185. devkit/skills/embedded/impeccable/reference/degraded/manual-edit-applier.md +92 -0
  186. devkit/skills/embedded/impeccable/reference/delight.md +70 -0
  187. devkit/skills/embedded/impeccable/reference/distill.md +111 -0
  188. devkit/skills/embedded/impeccable/reference/doctor.md +54 -0
  189. devkit/skills/embedded/impeccable/reference/document.md +416 -0
  190. devkit/skills/embedded/impeccable/reference/extract.md +69 -0
  191. devkit/skills/embedded/impeccable/reference/generate.md +101 -0
  192. devkit/skills/embedded/impeccable/reference/harden.md +362 -0
  193. devkit/skills/embedded/impeccable/reference/hooks.md +113 -0
  194. devkit/skills/embedded/impeccable/reference/init.md +131 -0
  195. devkit/skills/embedded/impeccable/reference/ios.md +51 -0
  196. devkit/skills/embedded/impeccable/reference/layout.md +84 -0
  197. devkit/skills/embedded/impeccable/reference/live-setup.md +104 -0
  198. devkit/skills/embedded/impeccable/reference/live.md +327 -0
  199. devkit/skills/embedded/impeccable/reference/mode-operate.md +21 -0
  200. devkit/skills/embedded/impeccable/reference/mode-persuade.md +19 -0
  201. devkit/skills/embedded/impeccable/reference/mode-read.md +21 -0
  202. devkit/skills/embedded/impeccable/reference/new-work.md +152 -0
  203. devkit/skills/embedded/impeccable/reference/onboard.md +234 -0
  204. devkit/skills/embedded/impeccable/reference/operate.md +61 -0
  205. devkit/skills/embedded/impeccable/reference/optimize.md +257 -0
  206. devkit/skills/embedded/impeccable/reference/overdrive.md +127 -0
  207. devkit/skills/embedded/impeccable/reference/polish.md +105 -0
  208. devkit/skills/embedded/impeccable/reference/quieter.md +99 -0
  209. devkit/skills/embedded/impeccable/reference/region-map.md +26 -0
  210. devkit/skills/embedded/impeccable/reference/routing.md +24 -0
  211. devkit/skills/embedded/impeccable/reference/shape.md +59 -0
  212. devkit/skills/embedded/impeccable/reference/typeset.md +90 -0
  213. devkit/skills/embedded/impeccable/reference/visualize.md +47 -0
  214. devkit/skills/embedded/impeccable/scripts/VERSION +1 -0
  215. devkit/skills/embedded/impeccable/scripts/command-metadata.json +98 -0
  216. devkit/skills/embedded/impeccable/scripts/data/font-index-failures.json +121 -0
  217. devkit/skills/embedded/impeccable/scripts/data/font-index.json +1 -0
  218. devkit/skills/embedded/impeccable/scripts/impeccable +213 -0
  219. devkit/skills/embedded/impeccable/scripts/impeccable.cmd +239 -0
  220. devkit/skills/embedded/impeccable/scripts/live-browser-dom.js +320 -0
  221. devkit/skills/embedded/impeccable/scripts/live-browser-ignores.js +246 -0
  222. devkit/skills/embedded/impeccable/scripts/live-browser-session.js +183 -0
  223. devkit/skills/embedded/impeccable/scripts/live-browser.js +13645 -0
  224. devkit/skills/embedded/impeccable/scripts/modern-screenshot.umd.js +14 -0
  225. devkit/skills/embedded/improve-animations/AUDIT.md +115 -0
  226. devkit/skills/embedded/improve-animations/PLAN-TEMPLATE.md +73 -0
  227. devkit/skills/embedded/improve-animations/SKILL.md +109 -0
  228. devkit/skills/embedded/mobile-native/SKILL.md +311 -0
  229. devkit/skills/embedded/modern-web-guidance/SKILL.md +135 -0
  230. devkit/skills/embedded/pick-ui-library/SKILL.md +85 -0
  231. devkit/skills/embedded/ponytail/SKILL.md +52 -0
  232. devkit/skills/embedded/ponytail-audit/SKILL.md +103 -0
  233. devkit/skills/embedded/ponytail-debt/SKILL.md +44 -0
  234. devkit/skills/embedded/ponytail-gain/SKILL.md +52 -0
  235. devkit/skills/embedded/ponytail-help/SKILL.md +76 -0
  236. devkit/skills/embedded/ponytail-review/SKILL.md +101 -0
  237. devkit/skills/embedded/prototype/PICKER.md +197 -0
  238. devkit/skills/embedded/prototype/SKILL.md +98 -0
  239. devkit/skills/embedded/review-animations/SKILL.md +120 -0
  240. devkit/skills/embedded/review-animations/STANDARDS.md +187 -0
  241. devkit/skills/embedded/skills-lock.json +239 -0
  242. devkit/skills/embedded/slides/SKILL.md +44 -0
  243. devkit/skills/embedded/slides/references/copywriting-formulas.md +84 -0
  244. devkit/skills/embedded/slides/references/create.md +4 -0
  245. devkit/skills/embedded/slides/references/html-template.md +295 -0
  246. devkit/skills/embedded/slides/references/layout-patterns.md +137 -0
  247. devkit/skills/embedded/slides/references/slide-strategies.md +94 -0
  248. devkit/skills/embedded/ui-styling/LICENSE.txt +202 -0
  249. devkit/skills/embedded/ui-styling/SKILL.md +336 -0
  250. devkit/skills/embedded/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -0
  251. devkit/skills/embedded/ui-styling/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
  252. devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-Bold.ttf +0 -0
  253. devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -0
  254. devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-Regular.ttf +0 -0
  255. devkit/skills/embedded/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -0
  256. devkit/skills/embedded/ui-styling/canvas-fonts/Boldonse-Regular.ttf +0 -0
  257. devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
  258. devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
  259. devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
  260. devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
  261. devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
  262. devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -0
  263. devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
  264. devkit/skills/embedded/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -0
  265. devkit/skills/embedded/ui-styling/canvas-fonts/DMMono-Regular.ttf +0 -0
  266. devkit/skills/embedded/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -0
  267. devkit/skills/embedded/ui-styling/canvas-fonts/EricaOne-Regular.ttf +0 -0
  268. devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-Bold.ttf +0 -0
  269. devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -0
  270. devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-Regular.ttf +0 -0
  271. devkit/skills/embedded/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -0
  272. devkit/skills/embedded/ui-styling/canvas-fonts/Gloock-Regular.ttf +0 -0
  273. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
  274. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
  275. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
  276. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
  277. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
  278. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
  279. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
  280. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
  281. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
  282. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
  283. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -0
  284. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
  285. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
  286. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
  287. devkit/skills/embedded/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -0
  288. devkit/skills/embedded/ui-styling/canvas-fonts/Italiana-Regular.ttf +0 -0
  289. devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
  290. devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
  291. devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
  292. devkit/skills/embedded/ui-styling/canvas-fonts/Jura-Light.ttf +0 -0
  293. devkit/skills/embedded/ui-styling/canvas-fonts/Jura-Medium.ttf +0 -0
  294. devkit/skills/embedded/ui-styling/canvas-fonts/Jura-OFL.txt +93 -0
  295. devkit/skills/embedded/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
  296. devkit/skills/embedded/ui-styling/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
  297. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Bold.ttf +0 -0
  298. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-BoldItalic.ttf +0 -0
  299. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Italic.ttf +0 -0
  300. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-OFL.txt +93 -0
  301. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Regular.ttf +0 -0
  302. devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-Bold.ttf +0 -0
  303. devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -0
  304. devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-Regular.ttf +0 -0
  305. devkit/skills/embedded/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
  306. devkit/skills/embedded/ui-styling/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
  307. devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-Bold.ttf +0 -0
  308. devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -0
  309. devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-Regular.ttf +0 -0
  310. devkit/skills/embedded/ui-styling/canvas-fonts/PixelifySans-Medium.ttf +0 -0
  311. devkit/skills/embedded/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -0
  312. devkit/skills/embedded/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -0
  313. devkit/skills/embedded/ui-styling/canvas-fonts/PoiretOne-Regular.ttf +0 -0
  314. devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-Bold.ttf +0 -0
  315. devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -0
  316. devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-Regular.ttf +0 -0
  317. devkit/skills/embedded/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -0
  318. devkit/skills/embedded/ui-styling/canvas-fonts/Silkscreen-Regular.ttf +0 -0
  319. devkit/skills/embedded/ui-styling/canvas-fonts/SmoochSans-Medium.ttf +0 -0
  320. devkit/skills/embedded/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -0
  321. devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-Medium.ttf +0 -0
  322. devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -0
  323. devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-Regular.ttf +0 -0
  324. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Bold.ttf +0 -0
  325. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
  326. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Italic.ttf +0 -0
  327. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -0
  328. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Regular.ttf +0 -0
  329. devkit/skills/embedded/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -0
  330. devkit/skills/embedded/ui-styling/canvas-fonts/YoungSerif-Regular.ttf +0 -0
  331. devkit/skills/embedded/ui-styling/references/canvas-design-system.md +320 -0
  332. devkit/skills/embedded/ui-styling/references/shadcn-accessibility.md +471 -0
  333. devkit/skills/embedded/ui-styling/references/shadcn-components.md +424 -0
  334. devkit/skills/embedded/ui-styling/references/shadcn-theming.md +373 -0
  335. devkit/skills/embedded/ui-styling/references/tailwind-customization.md +483 -0
  336. devkit/skills/embedded/ui-styling/references/tailwind-responsive.md +382 -0
  337. devkit/skills/embedded/ui-styling/references/tailwind-utilities.md +455 -0
  338. devkit/skills/embedded/ui-styling/scripts/.coverage +0 -0
  339. devkit/skills/embedded/ui-styling/scripts/requirements.txt +17 -0
  340. devkit/skills/embedded/ui-styling/scripts/shadcn_add.py +308 -0
  341. devkit/skills/embedded/ui-styling/scripts/tailwind_config_gen.py +508 -0
  342. devkit/skills/embedded/ui-styling/scripts/tests/coverage-ui.json +1 -0
  343. devkit/skills/embedded/ui-styling/scripts/tests/requirements.txt +3 -0
  344. devkit/skills/embedded/ui-styling/scripts/tests/test_shadcn_add.py +266 -0
  345. devkit/skills/embedded/ui-styling/scripts/tests/test_tailwind_config_gen.py +508 -0
  346. devkit/skills/embedded/ui-ux-pro-max/SKILL.md +214 -0
  347. devkit/skills/embedded/ui-ux-pro-max/data/app-interface.csv +33 -0
  348. devkit/skills/embedded/ui-ux-pro-max/data/catalog-summary.json +78 -0
  349. devkit/skills/embedded/ui-ux-pro-max/data/charts.csv +26 -0
  350. devkit/skills/embedded/ui-ux-pro-max/data/colors.csv +193 -0
  351. devkit/skills/embedded/ui-ux-pro-max/data/data-provenance.json +1348 -0
  352. devkit/skills/embedded/ui-ux-pro-max/data/google-font-licenses.json +20185 -0
  353. devkit/skills/embedded/ui-ux-pro-max/data/google-fonts.csv +1935 -0
  354. devkit/skills/embedded/ui-ux-pro-max/data/icons.csv +106 -0
  355. devkit/skills/embedded/ui-ux-pro-max/data/landing.csv +35 -0
  356. devkit/skills/embedded/ui-ux-pro-max/data/motion.csv +18 -0
  357. devkit/skills/embedded/ui-ux-pro-max/data/phosphor-icons-upstream.json +32582 -0
  358. devkit/skills/embedded/ui-ux-pro-max/data/products.csv +193 -0
  359. devkit/skills/embedded/ui-ux-pro-max/data/react-performance.csv +45 -0
  360. devkit/skills/embedded/ui-ux-pro-max/data/stacks/angular.csv +51 -0
  361. devkit/skills/embedded/ui-ux-pro-max/data/stacks/astro.csv +54 -0
  362. devkit/skills/embedded/ui-ux-pro-max/data/stacks/avalonia.csv +57 -0
  363. devkit/skills/embedded/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  364. devkit/skills/embedded/ui-ux-pro-max/data/stacks/html-tailwind.csv +60 -0
  365. devkit/skills/embedded/ui-ux-pro-max/data/stacks/javafx.csv +76 -0
  366. devkit/skills/embedded/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  367. devkit/skills/embedded/ui-ux-pro-max/data/stacks/laravel.csv +51 -0
  368. devkit/skills/embedded/ui-ux-pro-max/data/stacks/nextjs.csv +62 -0
  369. devkit/skills/embedded/ui-ux-pro-max/data/stacks/nuxt-ui.csv +77 -0
  370. devkit/skills/embedded/ui-ux-pro-max/data/stacks/nuxtjs.csv +68 -0
  371. devkit/skills/embedded/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  372. devkit/skills/embedded/ui-ux-pro-max/data/stacks/react.csv +67 -0
  373. devkit/skills/embedded/ui-ux-pro-max/data/stacks/shadcn.csv +69 -0
  374. devkit/skills/embedded/ui-ux-pro-max/data/stacks/svelte.csv +56 -0
  375. devkit/skills/embedded/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  376. devkit/skills/embedded/ui-ux-pro-max/data/stacks/threejs.csv +54 -0
  377. devkit/skills/embedded/ui-ux-pro-max/data/stacks/uno.csv +60 -0
  378. devkit/skills/embedded/ui-ux-pro-max/data/stacks/uwp.csv +56 -0
  379. devkit/skills/embedded/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  380. devkit/skills/embedded/ui-ux-pro-max/data/stacks/winui.csv +60 -0
  381. devkit/skills/embedded/ui-ux-pro-max/data/stacks/wpf.csv +57 -0
  382. devkit/skills/embedded/ui-ux-pro-max/data/styles.csv +89 -0
  383. devkit/skills/embedded/ui-ux-pro-max/data/typography.csv +75 -0
  384. devkit/skills/embedded/ui-ux-pro-max/data/ui-reasoning.csv +193 -0
  385. devkit/skills/embedded/ui-ux-pro-max/data/ux-guidelines.csv +120 -0
  386. devkit/skills/embedded/ui-ux-pro-max/references/pro-rules.md +117 -0
  387. devkit/skills/embedded/ui-ux-pro-max/references/quick-reference.md +256 -0
  388. devkit/skills/embedded/ui-ux-pro-max/scripts/core.py +993 -0
  389. devkit/skills/embedded/ui-ux-pro-max/scripts/design_system.py +1668 -0
  390. devkit/skills/embedded/ui-ux-pro-max/scripts/reasoning_contract.py +123 -0
  391. devkit/skills/embedded/ui-ux-pro-max/scripts/search.py +177 -0
  392. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json +36 -0
  393. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-catalog.json +33 -0
  394. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv +3 -0
  395. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json +17 -0
  396. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json +7 -0
  397. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv +4 -0
  398. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json +23 -0
  399. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json +13 -0
  400. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json +4 -0
  401. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json +5 -0
  402. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-baseline.json +3366 -0
  403. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-cases.json +111 -0
  404. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-thresholds.json +100 -0
  405. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_catalog_refresh.py +354 -0
  406. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_catalog_summary_line_endings.py +78 -0
  407. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_core.py +343 -0
  408. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_core_data_quality.py +198 -0
  409. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_data_contracts.py +421 -0
  410. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_design_system_mode.py +233 -0
  411. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_design_system_stack.py +61 -0
  412. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_native_desktop_stack_freshness.py +179 -0
  413. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_relevance_evaluator.py +182 -0
  414. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_skill_script_paths.py +82 -0
  415. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_style_taxonomy.py +175 -0
  416. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_text_layout_resilience.py +120 -0
  417. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_web_stack_freshness.py +177 -0
  418. devkit/skills/embedded/ui-ux-pro-max/scripts/validate_data.py +1095 -0
  419. devkit/skills/embedded/vercel-cli-with-tokens/SKILL.md +353 -0
  420. devkit/skills/embedded/vercel-composition-patterns/AGENTS.md +946 -0
  421. devkit/skills/embedded/vercel-composition-patterns/README.md +60 -0
  422. devkit/skills/embedded/vercel-composition-patterns/SKILL.md +89 -0
  423. devkit/skills/embedded/vercel-composition-patterns/rules/_sections.md +29 -0
  424. devkit/skills/embedded/vercel-composition-patterns/rules/_template.md +24 -0
  425. devkit/skills/embedded/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  426. devkit/skills/embedded/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  427. devkit/skills/embedded/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  428. devkit/skills/embedded/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  429. devkit/skills/embedded/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
  430. devkit/skills/embedded/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  431. devkit/skills/embedded/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  432. devkit/skills/embedded/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  433. devkit/skills/embedded/vercel-optimize/AGENTS.md +48 -0
  434. devkit/skills/embedded/vercel-optimize/CONTRIBUTING.md +41 -0
  435. devkit/skills/embedded/vercel-optimize/README.md +91 -0
  436. devkit/skills/embedded/vercel-optimize/SKILL.md +322 -0
  437. devkit/skills/embedded/vercel-optimize/lib/auth-route.mjs +23 -0
  438. devkit/skills/embedded/vercel-optimize/lib/budget-summary.mjs +182 -0
  439. devkit/skills/embedded/vercel-optimize/lib/citations.mjs +139 -0
  440. devkit/skills/embedded/vercel-optimize/lib/cost-coverage.mjs +143 -0
  441. devkit/skills/embedded/vercel-optimize/lib/dedup-recs.mjs +325 -0
  442. devkit/skills/embedded/vercel-optimize/lib/deep-dive.mjs +350 -0
  443. devkit/skills/embedded/vercel-optimize/lib/display-labels.mjs +185 -0
  444. devkit/skills/embedded/vercel-optimize/lib/extract-claims.mjs +550 -0
  445. devkit/skills/embedded/vercel-optimize/lib/framework-support.mjs +67 -0
  446. devkit/skills/embedded/vercel-optimize/lib/gates/build-minutes-fanout.mjs +69 -0
  447. devkit/skills/embedded/vercel-optimize/lib/gates/cold-start.mjs +66 -0
  448. devkit/skills/embedded/vercel-optimize/lib/gates/contract.mjs +79 -0
  449. devkit/skills/embedded/vercel-optimize/lib/gates/cwv-poor.mjs +87 -0
  450. devkit/skills/embedded/vercel-optimize/lib/gates/external-api-slow.mjs +55 -0
  451. devkit/skills/embedded/vercel-optimize/lib/gates/hard-gates.mjs +73 -0
  452. devkit/skills/embedded/vercel-optimize/lib/gates/index.mjs +45 -0
  453. devkit/skills/embedded/vercel-optimize/lib/gates/isr-overrevalidation.mjs +62 -0
  454. devkit/skills/embedded/vercel-optimize/lib/gates/middleware-heavy.mjs +51 -0
  455. devkit/skills/embedded/vercel-optimize/lib/gates/observability-events-attribution.mjs +56 -0
  456. devkit/skills/embedded/vercel-optimize/lib/gates/platform-bot-protection.mjs +115 -0
  457. devkit/skills/embedded/vercel-optimize/lib/gates/platform-fluid-compute.mjs +83 -0
  458. devkit/skills/embedded/vercel-optimize/lib/gates/region-misconfig.mjs +64 -0
  459. devkit/skills/embedded/vercel-optimize/lib/gates/route-errors.mjs +80 -0
  460. devkit/skills/embedded/vercel-optimize/lib/gates/scanner-driven.mjs +122 -0
  461. devkit/skills/embedded/vercel-optimize/lib/gates/select-candidates.mjs +134 -0
  462. devkit/skills/embedded/vercel-optimize/lib/gates/slow-route.mjs +88 -0
  463. devkit/skills/embedded/vercel-optimize/lib/gates/types.d.ts +38 -0
  464. devkit/skills/embedded/vercel-optimize/lib/gates/uncached-route.mjs +93 -0
  465. devkit/skills/embedded/vercel-optimize/lib/gates/usage-spike-triage.mjs +121 -0
  466. devkit/skills/embedded/vercel-optimize/lib/grade-recommendation.mjs +155 -0
  467. devkit/skills/embedded/vercel-optimize/lib/impact-label.mjs +126 -0
  468. devkit/skills/embedded/vercel-optimize/lib/impact-magnitude.mjs +60 -0
  469. devkit/skills/embedded/vercel-optimize/lib/investigation-brief.mjs +610 -0
  470. devkit/skills/embedded/vercel-optimize/lib/observation-safety.mjs +174 -0
  471. devkit/skills/embedded/vercel-optimize/lib/project-facts.mjs +99 -0
  472. devkit/skills/embedded/vercel-optimize/lib/queries.mjs +315 -0
  473. devkit/skills/embedded/vercel-optimize/lib/reconcile-candidates.mjs +372 -0
  474. devkit/skills/embedded/vercel-optimize/lib/render-report.mjs +955 -0
  475. devkit/skills/embedded/vercel-optimize/lib/repo-root.mjs +86 -0
  476. devkit/skills/embedded/vercel-optimize/lib/route-normalize.mjs +220 -0
  477. devkit/skills/embedded/vercel-optimize/lib/sanitizers/bot-protection-certainty.mjs +38 -0
  478. devkit/skills/embedded/vercel-optimize/lib/sanitizers/cache-tag-invalidation-certainty.mjs +30 -0
  479. devkit/skills/embedded/vercel-optimize/lib/sanitizers/count-correct.mjs +52 -0
  480. devkit/skills/embedded/vercel-optimize/lib/sanitizers/function-duration-invocations.mjs +38 -0
  481. devkit/skills/embedded/vercel-optimize/lib/sanitizers/index.mjs +79 -0
  482. devkit/skills/embedded/vercel-optimize/lib/sanitizers/middleware-conflict.mjs +36 -0
  483. devkit/skills/embedded/vercel-optimize/lib/sanitizers/missing-citation.mjs +16 -0
  484. devkit/skills/embedded/vercel-optimize/lib/sanitizers/pre-release.mjs +74 -0
  485. devkit/skills/embedded/vercel-optimize/lib/sanitizers/rate-limit.mjs +67 -0
  486. devkit/skills/embedded/vercel-optimize/lib/sanitizers/rendering-mode-mislabel.mjs +38 -0
  487. devkit/skills/embedded/vercel-optimize/lib/sanitizers/undeclared-dep.mjs +78 -0
  488. devkit/skills/embedded/vercel-optimize/lib/sanitizers/vercel-directive-strip.mjs +37 -0
  489. devkit/skills/embedded/vercel-optimize/lib/sanitizers/window-units.mjs +32 -0
  490. devkit/skills/embedded/vercel-optimize/lib/scanners/cache-components-suspense-dedupe.mjs +109 -0
  491. devkit/skills/embedded/vercel-optimize/lib/scanners/edge-heavy-import.mjs +94 -0
  492. devkit/skills/embedded/vercel-optimize/lib/scanners/force-dynamic.mjs +42 -0
  493. devkit/skills/embedded/vercel-optimize/lib/scanners/headers-in-page.mjs +44 -0
  494. devkit/skills/embedded/vercel-optimize/lib/scanners/index.mjs +35 -0
  495. devkit/skills/embedded/vercel-optimize/lib/scanners/large-static-asset.mjs +92 -0
  496. devkit/skills/embedded/vercel-optimize/lib/scanners/max-age-without-s-maxage.mjs +42 -0
  497. devkit/skills/embedded/vercel-optimize/lib/scanners/middleware-broad-matcher.mjs +55 -0
  498. devkit/skills/embedded/vercel-optimize/lib/scanners/missing-cache-headers.mjs +90 -0
  499. devkit/skills/embedded/vercel-optimize/lib/scanners/prisma-include-tree.mjs +42 -0
  500. devkit/skills/embedded/vercel-optimize/lib/scanners/region-pin-in-config.mjs +88 -0
  501. devkit/skills/embedded/vercel-optimize/lib/scanners/source-maps-production.mjs +36 -0
  502. devkit/skills/embedded/vercel-optimize/lib/scanners/sveltekit-prerender-missing.mjs +43 -0
  503. devkit/skills/embedded/vercel-optimize/lib/scanners/turbo-force-bypass.mjs +129 -0
  504. devkit/skills/embedded/vercel-optimize/lib/scanners/unoptimized-image.mjs +113 -0
  505. devkit/skills/embedded/vercel-optimize/lib/scanners/use-cache-date-stamp.mjs +106 -0
  506. devkit/skills/embedded/vercel-optimize/lib/support-topics.mjs +355 -0
  507. devkit/skills/embedded/vercel-optimize/lib/throttle.mjs +273 -0
  508. devkit/skills/embedded/vercel-optimize/lib/util.mjs +17 -0
  509. devkit/skills/embedded/vercel-optimize/lib/vercel.mjs +864 -0
  510. devkit/skills/embedded/vercel-optimize/lib/verify-claim.mjs +1296 -0
  511. devkit/skills/embedded/vercel-optimize/lib/workspace-resolver.mjs +521 -0
  512. devkit/skills/embedded/vercel-optimize/references/candidates.md +176 -0
  513. devkit/skills/embedded/vercel-optimize/references/data-collection.md +218 -0
  514. devkit/skills/embedded/vercel-optimize/references/docs-library.json +683 -0
  515. devkit/skills/embedded/vercel-optimize/references/doctrine.md +105 -0
  516. devkit/skills/embedded/vercel-optimize/references/observability-plus.md +108 -0
  517. devkit/skills/embedded/vercel-optimize/references/playbooks/README.md +53 -0
  518. devkit/skills/embedded/vercel-optimize/references/playbooks/ai-application.md +32 -0
  519. devkit/skills/embedded/vercel-optimize/references/playbooks/api-service.md +30 -0
  520. devkit/skills/embedded/vercel-optimize/references/playbooks/content-site.md +30 -0
  521. devkit/skills/embedded/vercel-optimize/references/playbooks/ecommerce.md +30 -0
  522. devkit/skills/embedded/vercel-optimize/references/playbooks/marketing.md +30 -0
  523. devkit/skills/embedded/vercel-optimize/references/playbooks/saas.md +31 -0
  524. devkit/skills/embedded/vercel-optimize/references/playbooks/sveltekit.md +75 -0
  525. devkit/skills/embedded/vercel-optimize/references/recommendations.md +203 -0
  526. devkit/skills/embedded/vercel-optimize/references/scanner-patterns.md +251 -0
  527. devkit/skills/embedded/vercel-optimize/references/scoring.md +205 -0
  528. devkit/skills/embedded/vercel-optimize/references/support-topics/README.md +46 -0
  529. devkit/skills/embedded/vercel-optimize/references/support-topics/astro-edge-middleware-scope.md +22 -0
  530. devkit/skills/embedded/vercel-optimize/references/support-topics/astro-output-mode-and-isr.md +22 -0
  531. devkit/skills/embedded/vercel-optimize/references/support-topics/auth-preserving-parallelization.md +22 -0
  532. devkit/skills/embedded/vercel-optimize/references/support-topics/bot-protection-product-guardrails.md +22 -0
  533. devkit/skills/embedded/vercel-optimize/references/support-topics/build-minutes-monorepo-fanout.md +23 -0
  534. devkit/skills/embedded/vercel-optimize/references/support-topics/cache-components-static-shell-boundaries.md +22 -0
  535. devkit/skills/embedded/vercel-optimize/references/support-topics/cache-components-suspense-dedupe-pitfall.md +23 -0
  536. devkit/skills/embedded/vercel-optimize/references/support-topics/cdn-cache-auth-safety.md +22 -0
  537. devkit/skills/embedded/vercel-optimize/references/support-topics/cold-start-initialization-bundle.md +22 -0
  538. devkit/skills/embedded/vercel-optimize/references/support-topics/core-web-vitals-client-bottlenecks.md +22 -0
  539. devkit/skills/embedded/vercel-optimize/references/support-topics/database-egress-pooling-region.md +22 -0
  540. devkit/skills/embedded/vercel-optimize/references/support-topics/dynamic-rendering-traps.md +22 -0
  541. devkit/skills/embedded/vercel-optimize/references/support-topics/external-api-critical-path-platform.md +22 -0
  542. devkit/skills/embedded/vercel-optimize/references/support-topics/external-api-critical-path.md +22 -0
  543. devkit/skills/embedded/vercel-optimize/references/support-topics/fast-data-transfer-payloads.md +22 -0
  544. devkit/skills/embedded/vercel-optimize/references/support-topics/fluid-compute-caveats.md +22 -0
  545. devkit/skills/embedded/vercel-optimize/references/support-topics/function-duration-io-and-after.md +22 -0
  546. devkit/skills/embedded/vercel-optimize/references/support-topics/function-invocation-reduction.md +22 -0
  547. devkit/skills/embedded/vercel-optimize/references/support-topics/function-region-misconfiguration-ttfb.md +23 -0
  548. devkit/skills/embedded/vercel-optimize/references/support-topics/image-optimization-cost-control.md +22 -0
  549. devkit/skills/embedded/vercel-optimize/references/support-topics/isr-revalidation-static-generation.md +22 -0
  550. devkit/skills/embedded/vercel-optimize/references/support-topics/middleware-proxy-edge-cost.md +22 -0
  551. devkit/skills/embedded/vercel-optimize/references/support-topics/next-fetch-revalidate-floor.md +22 -0
  552. devkit/skills/embedded/vercel-optimize/references/support-topics/next-font-cls-self-hosting.md +23 -0
  553. devkit/skills/embedded/vercel-optimize/references/support-topics/next-heavy-ui-lazy-load-boundaries.md +23 -0
  554. devkit/skills/embedded/vercel-optimize/references/support-topics/next-image-lcp-preload-sizes.md +23 -0
  555. devkit/skills/embedded/vercel-optimize/references/support-topics/next-route-handler-get-cache-defaults.md +22 -0
  556. devkit/skills/embedded/vercel-optimize/references/support-topics/next-script-third-party-strategy.md +23 -0
  557. devkit/skills/embedded/vercel-optimize/references/support-topics/nextjs-version-cache-semantics.md +22 -0
  558. devkit/skills/embedded/vercel-optimize/references/support-topics/not-found-catchall-request-waste.md +23 -0
  559. devkit/skills/embedded/vercel-optimize/references/support-topics/nuxt-route-rules-cache-isr.md +22 -0
  560. devkit/skills/embedded/vercel-optimize/references/support-topics/observability-events-cost-attribution.md +22 -0
  561. devkit/skills/embedded/vercel-optimize/references/support-topics/post-response-work-waituntil.md +22 -0
  562. devkit/skills/embedded/vercel-optimize/references/support-topics/route-error-durable-offload.md +22 -0
  563. devkit/skills/embedded/vercel-optimize/references/support-topics/route-error-runtime-limits.md +22 -0
  564. devkit/skills/embedded/vercel-optimize/references/support-topics/runtime-cache-reusable-data.md +22 -0
  565. devkit/skills/embedded/vercel-optimize/references/support-topics/sveltekit-isr-prerender-safety.md +22 -0
  566. devkit/skills/embedded/vercel-optimize/references/support-topics/sveltekit-split-cold-start-tradeoff.md +22 -0
  567. devkit/skills/embedded/vercel-optimize/references/support-topics/usage-spike-triage.md +22 -0
  568. devkit/skills/embedded/vercel-optimize/references/support-topics/use-cache-date-stamp-isr-write-amplifier.md +23 -0
  569. devkit/skills/embedded/vercel-optimize/references/support-topics/use-cache-remote-shared-origin-data.md +22 -0
  570. devkit/skills/embedded/vercel-optimize/references/support-topics/workflow-resumable-stream-routes.md +23 -0
  571. devkit/skills/embedded/vercel-optimize/references/verification.md +102 -0
  572. devkit/skills/embedded/vercel-optimize/references/voice.md +76 -0
  573. devkit/skills/embedded/vercel-optimize/scripts/budget-summary.mjs +56 -0
  574. devkit/skills/embedded/vercel-optimize/scripts/build-docs.mjs +74 -0
  575. devkit/skills/embedded/vercel-optimize/scripts/check-citations.mjs +81 -0
  576. devkit/skills/embedded/vercel-optimize/scripts/check-docs-fresh.mjs +93 -0
  577. devkit/skills/embedded/vercel-optimize/scripts/collect-signals.mjs +576 -0
  578. devkit/skills/embedded/vercel-optimize/scripts/collect-sub-agent-outputs.mjs +296 -0
  579. devkit/skills/embedded/vercel-optimize/scripts/deep-dive.mjs +319 -0
  580. devkit/skills/embedded/vercel-optimize/scripts/gate-investigations.mjs +166 -0
  581. devkit/skills/embedded/vercel-optimize/scripts/merge-signals.mjs +192 -0
  582. devkit/skills/embedded/vercel-optimize/scripts/prepare-investigation-brief.mjs +231 -0
  583. devkit/skills/embedded/vercel-optimize/scripts/reconcile-candidates.mjs +62 -0
  584. devkit/skills/embedded/vercel-optimize/scripts/render-report.mjs +437 -0
  585. devkit/skills/embedded/vercel-optimize/scripts/scan-codebase.mjs +313 -0
  586. devkit/skills/embedded/vercel-optimize/scripts/verify-and-regen.mjs +346 -0
  587. devkit/skills/embedded/vercel-optimize/scripts/verify-finding.mjs +19 -0
  588. devkit/skills/embedded/vercel-react-best-practices/AGENTS.md +3810 -0
  589. devkit/skills/embedded/vercel-react-best-practices/README.md +123 -0
  590. devkit/skills/embedded/vercel-react-best-practices/SKILL.md +149 -0
  591. devkit/skills/embedded/vercel-react-best-practices/rules/_sections.md +46 -0
  592. devkit/skills/embedded/vercel-react-best-practices/rules/_template.md +28 -0
  593. devkit/skills/embedded/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  594. devkit/skills/embedded/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  595. devkit/skills/embedded/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  596. devkit/skills/embedded/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  597. devkit/skills/embedded/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  598. devkit/skills/embedded/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  599. devkit/skills/embedded/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  600. devkit/skills/embedded/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  601. devkit/skills/embedded/vercel-react-best-practices/rules/async-parallel.md +28 -0
  602. devkit/skills/embedded/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  603. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  604. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  605. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  606. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  607. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  608. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  609. devkit/skills/embedded/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  610. devkit/skills/embedded/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  611. devkit/skills/embedded/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  612. devkit/skills/embedded/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  613. devkit/skills/embedded/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  614. devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  615. devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  616. devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  617. devkit/skills/embedded/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  618. devkit/skills/embedded/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  619. devkit/skills/embedded/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  620. devkit/skills/embedded/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  621. devkit/skills/embedded/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  622. devkit/skills/embedded/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  623. devkit/skills/embedded/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  624. devkit/skills/embedded/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  625. devkit/skills/embedded/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  626. devkit/skills/embedded/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  627. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  628. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  629. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  630. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  631. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  632. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  633. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  634. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  635. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  636. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  637. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  638. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  639. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  640. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  641. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  642. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  643. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  644. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  645. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  646. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  647. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  648. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  649. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  650. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  651. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  652. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  653. devkit/skills/embedded/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  654. devkit/skills/embedded/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  655. devkit/skills/embedded/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  656. devkit/skills/embedded/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  657. devkit/skills/embedded/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  658. devkit/skills/embedded/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  659. devkit/skills/embedded/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  660. devkit/skills/embedded/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  661. devkit/skills/embedded/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  662. devkit/skills/embedded/vercel-react-best-practices/rules/server-serialization.md +38 -0
  663. devkit/skills/embedded/vercel-react-native-skills/AGENTS.md +2897 -0
  664. devkit/skills/embedded/vercel-react-native-skills/README.md +165 -0
  665. devkit/skills/embedded/vercel-react-native-skills/SKILL.md +121 -0
  666. devkit/skills/embedded/vercel-react-native-skills/rules/_sections.md +86 -0
  667. devkit/skills/embedded/vercel-react-native-skills/rules/_template.md +28 -0
  668. devkit/skills/embedded/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
  669. devkit/skills/embedded/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
  670. devkit/skills/embedded/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
  671. devkit/skills/embedded/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
  672. devkit/skills/embedded/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
  673. devkit/skills/embedded/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
  674. devkit/skills/embedded/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
  675. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
  676. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
  677. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-images.md +53 -0
  678. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
  679. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
  680. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
  681. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
  682. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
  683. devkit/skills/embedded/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
  684. devkit/skills/embedded/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
  685. devkit/skills/embedded/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
  686. devkit/skills/embedded/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
  687. devkit/skills/embedded/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
  688. devkit/skills/embedded/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
  689. devkit/skills/embedded/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
  690. devkit/skills/embedded/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
  691. devkit/skills/embedded/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
  692. devkit/skills/embedded/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
  693. devkit/skills/embedded/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
  694. devkit/skills/embedded/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
  695. devkit/skills/embedded/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
  696. devkit/skills/embedded/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
  697. devkit/skills/embedded/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
  698. devkit/skills/embedded/vercel-react-native-skills/rules/ui-menus.md +174 -0
  699. devkit/skills/embedded/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
  700. devkit/skills/embedded/vercel-react-native-skills/rules/ui-pressable.md +61 -0
  701. devkit/skills/embedded/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
  702. devkit/skills/embedded/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
  703. devkit/skills/embedded/vercel-react-native-skills/rules/ui-styling.md +87 -0
  704. devkit/skills/embedded/vercel-react-view-transitions/AGENTS.md +1380 -0
  705. devkit/skills/embedded/vercel-react-view-transitions/README.md +44 -0
  706. devkit/skills/embedded/vercel-react-view-transitions/SKILL.md +332 -0
  707. devkit/skills/embedded/vercel-react-view-transitions/references/css-recipes.md +312 -0
  708. devkit/skills/embedded/vercel-react-view-transitions/references/implementation.md +170 -0
  709. devkit/skills/embedded/vercel-react-view-transitions/references/nextjs.md +233 -0
  710. devkit/skills/embedded/vercel-react-view-transitions/references/patterns.md +274 -0
  711. devkit/skills/embedded/vercel-react-view-transitions/references/troubleshooting.md +47 -0
  712. devkit/skills/embedded/web-design-guidelines/SKILL.md +39 -0
  713. devkit/skills/embedded/write-swift/SKILL.md +396 -0
  714. devkit/skills/embedded/writing-guidelines/SKILL.md +39 -0
  715. devkit/skills/installer.py +110 -0
  716. devkit/templates/__init__.py +76 -0
  717. devkit/templates/ai_agents_python.py +160 -0
  718. devkit/templates/base.py +37 -0
  719. devkit/templates/content_site.py +117 -0
  720. devkit/templates/custom.py +129 -0
  721. devkit/templates/design_system.py +167 -0
  722. devkit/templates/expo_fullstack.py +278 -0
  723. devkit/templates/expo_mobile.py +127 -0
  724. devkit/templates/minimal_agentic.py +34 -0
  725. devkit/templates/nextjs.py +219 -0
  726. devkit/templates/python_fastapi.py +125 -0
  727. devkit/templates/saas_fullstack.py +212 -0
  728. devkit/templates/vite_react.py +176 -0
  729. devkit/ui.py +61 -0
  730. devkit/utils/__init__.py +15 -0
  731. devkit/utils/system.py +48 -0
@@ -0,0 +1,329 @@
1
+ # Social Photos Design Guide
2
+
3
+ Design social media images via HTML/CSS rendering + screenshot export. Orchestrates the bundled `ui-ux-pro-max`, `brand`, and `design-system` skills; screenshot export runs through Chrome headless, Playwright, or Puppeteer.
4
+
5
+ ## Platform Sizes
6
+
7
+ | Platform | Type | Size (px) | Aspect |
8
+ |----------|------|-----------|--------|
9
+ | Instagram | Post | 1080 x 1080 | 1:1 |
10
+ | Instagram | Story/Reel | 1080 x 1920 | 9:16 |
11
+ | Instagram | Carousel | 1080 x 1350 | 4:5 |
12
+ | Facebook | Post | 1200 x 630 | ~1.9:1 |
13
+ | Facebook | Story | 1080 x 1920 | 9:16 |
14
+ | Twitter/X | Post | 1200 x 675 | 16:9 |
15
+ | Twitter/X | Card | 800 x 418 | ~1.91:1 |
16
+ | LinkedIn | Post | 1200 x 627 | ~1.91:1 |
17
+ | LinkedIn | Article | 1200 x 644 | ~1.86:1 |
18
+ | Pinterest | Pin | 1000 x 1500 | 2:3 |
19
+ | YouTube | Thumbnail | 1280 x 720 | 16:9 |
20
+ | TikTok | Cover | 1080 x 1920 | 9:16 |
21
+ | Threads | Post | 1080 x 1080 | 1:1 |
22
+
23
+ ## Workflow
24
+
25
+ ### Step 1: Plan the Work
26
+
27
+ Create TODO tasks with the runtime's native task list. Break down into:
28
+ - Requirement analysis task
29
+ - Idea generation task(s)
30
+ - HTML design task(s) — can parallelize per size/variant
31
+ - Screenshot export task(s) — can parallelize per file
32
+ - Report generation task
33
+
34
+ Spawn parallel subagents for independent tasks (e.g., multiple HTML files for different sizes).
35
+
36
+ ### Step 2: Analyze Requirements
37
+
38
+ Parse user input for:
39
+ - **Subject/topic** — what the social photo represents
40
+ - **Target platforms** — which sizes needed (default: Instagram Post 1:1 + Story 9:16)
41
+ - **Visual style** — minimalist, bold, gradient, photo-based, etc.
42
+ - **Brand context** — read from `docs/brand-guidelines.md` if exists
43
+ - **Content elements** — headline, subtext, CTA, images, icons
44
+ - **Quantity** — how many variations (default: 3)
45
+
46
+ ### Step 3: Generate Ideas
47
+
48
+ Create 3-5 concept ideas that:
49
+ - Match the input prompt/requirements
50
+ - Consider platform-specific best practices
51
+ - Vary in composition, color, typography approach
52
+ - Align with brand guidelines if available
53
+
54
+ Present ideas to user via `AskUserQuestion` for approval before designing.
55
+
56
+ ### Step 4: Design HTML Files
57
+
58
+ Use these bundled skills in sequence:
59
+
60
+ 1. **`brand`** — Extract brand colors, fonts, voice from user's project
61
+ 2. **`design-system`** — Get design tokens (spacing, typography scale, color palette)
62
+ 3. **`ui-ux-pro-max`** — Layout, hierarchy, visual balance; search a different style, palette, or font pairing per concept for design variety.
63
+
64
+ For each approved idea + each target size, create an HTML file:
65
+
66
+ ```
67
+ output/social-photos/
68
+ ├── idea-1-instagram-post-1080x1080.html
69
+ ├── idea-1-instagram-story-1080x1920.html
70
+ ├── idea-2-instagram-post-1080x1080.html
71
+ ├── idea-2-instagram-story-1080x1920.html
72
+ └── ...
73
+ ```
74
+
75
+ #### HTML Design Rules
76
+
77
+ - **Viewport** — Set exact pixel dimensions matching target size
78
+ - **Self-contained** — Inline all CSS, embed fonts via Google Fonts CDN
79
+ - **No scrolling** — Everything fits in one viewport
80
+ - **High contrast** — Text readable at thumbnail size
81
+ - **Brand-aligned** — Use extracted brand colors/fonts
82
+ - **Safe zones** — Critical content within central 80% area
83
+ - **Typography** — Min 24px for headlines, min 16px for body at 1080px width
84
+ - **Visual hierarchy** — One focal point, clear reading flow
85
+
86
+ #### HTML Template Structure
87
+
88
+ ```html
89
+ <!DOCTYPE html>
90
+ <html>
91
+ <head>
92
+ <meta charset="UTF-8">
93
+ <meta name="viewport" content="width={WIDTH}, initial-scale=1.0">
94
+ <link href="https://fonts.googleapis.com/css2?family={FONT}&display=swap" rel="stylesheet">
95
+ <style>
96
+ * { margin: 0; padding: 0; box-sizing: border-box; }
97
+ html, body {
98
+ width: {WIDTH}px;
99
+ height: {HEIGHT}px;
100
+ overflow: hidden;
101
+ font-family: '{FONT}', sans-serif;
102
+ }
103
+ .canvas {
104
+ width: {WIDTH}px;
105
+ height: {HEIGHT}px;
106
+ position: relative;
107
+ /* Background: gradient, solid, or image */
108
+ }
109
+ /* Design tokens from brand/design-system */
110
+ </style>
111
+ </head>
112
+ <body>
113
+ <div class="canvas">
114
+ <!-- Content layers -->
115
+ </div>
116
+ </body>
117
+ </html>
118
+ ```
119
+
120
+ ### Step 5: Screenshot Export
121
+
122
+ Use Chrome headless, Playwright, or Puppeteer to capture exact-size screenshots.
123
+
124
+ **IMPORTANT:** Always add a delay (3-5s) after page load for fonts/images to fully render before capture.
125
+
126
+ #### Option A: Chrome Headless CLI (Recommended — zero dependencies)
127
+
128
+ ```bash
129
+ CHROME="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
130
+ DELAY=5 # seconds for fonts/images to load
131
+
132
+ "$CHROME" \
133
+ --headless \
134
+ --disable-gpu \
135
+ --no-sandbox \
136
+ --hide-scrollbars \
137
+ --window-size="${WIDTH},${HEIGHT}" \
138
+ --virtual-time-budget=$((DELAY * 1000)) \
139
+ --screenshot="output.png" \
140
+ "file:///path/to/file.html"
141
+ ```
142
+
143
+ Key flags:
144
+ - `--virtual-time-budget=5000` — waits 5s virtual time for assets (Google Fonts, images) to load
145
+ - `--hide-scrollbars` — prevents scrollbar artifacts in screenshots
146
+ - `--window-size=WxH` — sets exact pixel dimensions
147
+
148
+ #### Option B: Browser automation provided by the runtime
149
+
150
+ If the runtime offers a browser-automation or screenshot capability (for example a browser MCP server), use it to:
151
+ 1. Open each HTML file in browser
152
+ 2. Set viewport to exact target dimensions
153
+ 3. Wait 3-5s for fonts/images to fully load
154
+ 4. Screenshot full page to PNG
155
+ 5. Save to `output/social-photos/exports/`
156
+
157
+ #### Option C: Playwright script
158
+
159
+ ```javascript
160
+ const { chromium } = require('playwright');
161
+
162
+ async function captureScreenshots(htmlFiles) {
163
+ const browser = await chromium.launch();
164
+
165
+ for (const file of htmlFiles) {
166
+ const [width, height] = file.match(/(\d+)x(\d+)/).slice(1).map(Number);
167
+
168
+ const page = await browser.newPage();
169
+ await page.setViewportSize({ width, height });
170
+ await page.goto(`file://${file}`, { waitUntil: 'networkidle' });
171
+ // Wait for fonts/images to fully render
172
+ await page.waitForTimeout(3000);
173
+
174
+ const outputPath = file.replace('.html', '.png').replace('social-photos/', 'social-photos/exports/');
175
+ await page.screenshot({ path: outputPath, type: 'png' });
176
+ await page.close();
177
+ }
178
+
179
+ await browser.close();
180
+ }
181
+ ```
182
+
183
+ #### Option D: Puppeteer script
184
+
185
+ ```javascript
186
+ const puppeteer = require('puppeteer');
187
+
188
+ async function captureScreenshots(htmlFiles) {
189
+ const browser = await puppeteer.launch();
190
+
191
+ for (const file of htmlFiles) {
192
+ const [width, height] = file.match(/(\d+)x(\d+)/).slice(1).map(Number);
193
+
194
+ const page = await browser.newPage();
195
+ await page.setViewport({ width, height, deviceScaleFactor: 2 }); // 2x for retina
196
+ await page.goto(`file://${file}`, { waitUntil: 'networkidle0' });
197
+ // Wait for fonts/images to fully render
198
+ await new Promise(r => setTimeout(r, 3000));
199
+
200
+ const outputPath = file.replace('.html', '.png').replace('social-photos/', 'social-photos/exports/');
201
+ await page.screenshot({ path: outputPath, type: 'png' });
202
+ await page.close();
203
+ }
204
+
205
+ await browser.close();
206
+ }
207
+ ```
208
+
209
+ **IMPORTANT:** Use `deviceScaleFactor: 2` for retina-quality output (Puppeteer only).
210
+
211
+ ### Step 6: Verify & Fix Designs
212
+
213
+ Open each exported PNG in an available browser or image viewer and inspect it:
214
+
215
+ 1. Open exported screenshots and check for layout/styling issues
216
+ 2. Verify: fonts rendered correctly, colors match brand, text readable at thumbnail size
217
+ 3. Check: no overflow, no cut-off content, safe zones respected, visual hierarchy clear
218
+ 4. If issues found → fix HTML source → re-export screenshot → verify again
219
+ 5. Repeat until all designs pass visual QA
220
+
221
+ **Common issues to check:**
222
+ - Fonts not loaded (fallback to system fonts)
223
+ - Text overflow or clipping
224
+ - Elements outside safe zone (central 80%)
225
+ - Low contrast text (below WCAG AA 4.5:1)
226
+ - Misaligned elements or broken layouts
227
+
228
+ ### Step 7: Generate Summary Report
229
+
230
+ Save the report as `plans/reports/{YYMMDD}-social-photos-{topic}.md`.
231
+
232
+ Report structure:
233
+
234
+ ```markdown
235
+ # Social Photos Design Report
236
+
237
+ ## Overview
238
+ - Prompt/requirements: {original input}
239
+ - Platforms: {target platforms}
240
+ - Variations: {count}
241
+ - Style: {chosen style}
242
+
243
+ ## Ideas Generated
244
+ 1. **{Idea name}** — {brief description, rationale}
245
+ 2. ...
246
+
247
+ ## Design Decisions
248
+ - Color palette: {colors used, why}
249
+ - Typography: {fonts, sizes, why}
250
+ - Layout: {composition approach, why}
251
+ - Brand alignment: {how brand guidelines influenced design}
252
+
253
+ ## Output Files
254
+ | File | Size | Platform | Preview |
255
+ |------|------|----------|---------|
256
+ | exports/{filename}.png | {WxH} | {platform} | {description} |
257
+
258
+ ## Why This Works
259
+ - {Platform-specific reasoning}
260
+ - {Brand alignment reasoning}
261
+ - {Visual hierarchy reasoning}
262
+ - {Engagement potential reasoning}
263
+
264
+ ## Recommendations
265
+ - {A/B test suggestions}
266
+ - {Platform-specific tips}
267
+ - {Iteration opportunities}
268
+ ```
269
+
270
+ ### Step 8: Organize Output
271
+
272
+ Organize all output files and reports:
273
+ - Move/copy exported PNGs to proper asset directories
274
+ - Ensure reports are in `plans/reports/` under the name from Step 7
275
+ - Clean up intermediate HTML files if requested
276
+ - Tag outputs with metadata (platform, size, concept name)
277
+
278
+ ## Design Best Practices
279
+
280
+ ### Platform-Specific Tips
281
+
282
+ - **Instagram** — Visual-first, minimal text (<20%), strong colors, lifestyle feel
283
+ - **Facebook** — Informative, can have more text, eye-catching in feed
284
+ - **Twitter/X** — Bold headlines, contrast for dark/light mode, clear message
285
+ - **LinkedIn** — Professional, clean, data-driven visuals, thought leadership
286
+ - **Pinterest** — Vertical format, text overlay on images, how-to style
287
+ - **YouTube** — Face close-ups perform best, bright colors, readable at small size
288
+ - **TikTok** — Trendy, energetic, bold typography, youth-oriented
289
+
290
+ ### Art Direction Styles (Reuse from Banner)
291
+
292
+ | Style | Best For | Key Elements |
293
+ |-------|----------|--------------|
294
+ | Minimalist | SaaS, tech, luxury | Whitespace, single accent color, clean type |
295
+ | Bold Typography | Announcements, quotes | Large type, high contrast, minimal imagery |
296
+ | Gradient Mesh | Modern brands, apps | Fluid color transitions, floating elements |
297
+ | Photo-Based | Lifestyle, e-commerce | Hero image, subtle overlay, text on image |
298
+ | Geometric | Tech, fintech | Shapes, patterns, structured layouts |
299
+ | Glassmorphism | SaaS, modern apps | Frosted glass, blur effects, transparency |
300
+ | Flat Illustration | Education, health | Custom illustrations, friendly, approachable |
301
+ | Duotone | Creative, editorial | Two-color treatment on photos |
302
+ | Collage | Fashion, culture | Mixed media, overlapping elements |
303
+ | 3D/Isometric | Tech, product | Depth, shadows, modern perspective |
304
+
305
+ ### Color & Contrast
306
+
307
+ - Ensure WCAG AA contrast ratio (4.5:1 min) for all text
308
+ - Test designs at 50% size to verify readability
309
+ - Consider platform dark/light mode compatibility
310
+ - Use brand primary color as dominant, secondary as accent
311
+
312
+ ### Typography Hierarchy
313
+
314
+ | Element | Min Size (at 1080px) | Weight |
315
+ |---------|---------------------|--------|
316
+ | Headline | 48px | Bold/Black |
317
+ | Subheadline | 32px | Semibold |
318
+ | Body | 24px | Regular |
319
+ | Caption | 18px | Regular/Light |
320
+ | CTA | 28px | Bold |
321
+
322
+ ## Security & Scope
323
+
324
+ This sub-skill handles social media image design only. Does NOT handle:
325
+ - Video content creation
326
+ - Animation/motion graphics
327
+ - Print production files (CMYK, bleed)
328
+ - Direct social media posting/scheduling
329
+ - AI image generation (supply images, or generate them with a separate authorized capability)
@@ -0,0 +1,215 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ CIP Design Core - BM25 search engine for Corporate Identity Program design guidelines
5
+ """
6
+
7
+ import csv
8
+ import re
9
+ from pathlib import Path
10
+ from math import log
11
+ from collections import defaultdict
12
+
13
+ # ============ CONFIGURATION ============
14
+ DATA_DIR = Path(__file__).parent.parent.parent / "data" / "cip"
15
+ MAX_RESULTS = 3
16
+
17
+ CSV_CONFIG = {
18
+ "deliverable": {
19
+ "file": "deliverables.csv",
20
+ "search_cols": ["Deliverable", "Category", "Keywords", "Description", "Mockup Context"],
21
+ "output_cols": ["Deliverable", "Category", "Keywords", "Description", "Dimensions", "File Format", "Logo Placement", "Color Usage", "Typography Notes", "Mockup Context", "Best Practices", "Avoid"]
22
+ },
23
+ "style": {
24
+ "file": "styles.csv",
25
+ "search_cols": ["Style Name", "Category", "Keywords", "Description", "Mood"],
26
+ "output_cols": ["Style Name", "Category", "Keywords", "Description", "Primary Colors", "Secondary Colors", "Typography", "Materials", "Finishes", "Mood", "Best For", "Avoid For"]
27
+ },
28
+ "industry": {
29
+ "file": "industries.csv",
30
+ "search_cols": ["Industry", "Keywords", "CIP Style", "Mood"],
31
+ "output_cols": ["Industry", "Keywords", "CIP Style", "Primary Colors", "Secondary Colors", "Typography", "Key Deliverables", "Mood", "Best Practices", "Avoid"]
32
+ },
33
+ "mockup": {
34
+ "file": "mockup-contexts.csv",
35
+ "search_cols": ["Context Name", "Category", "Keywords", "Scene Description"],
36
+ "output_cols": ["Context Name", "Category", "Keywords", "Scene Description", "Lighting", "Environment", "Props", "Camera Angle", "Background", "Style Notes", "Best For", "Prompt Modifiers"]
37
+ }
38
+ }
39
+
40
+
41
+ # ============ BM25 IMPLEMENTATION ============
42
+ class BM25:
43
+ """BM25 ranking algorithm for text search"""
44
+
45
+ def __init__(self, k1=1.5, b=0.75):
46
+ self.k1 = k1
47
+ self.b = b
48
+ self.corpus = []
49
+ self.doc_lengths = []
50
+ self.avgdl = 0
51
+ self.idf = {}
52
+ self.doc_freqs = defaultdict(int)
53
+ self.N = 0
54
+
55
+ def tokenize(self, text):
56
+ """Lowercase, split, remove punctuation, filter short words"""
57
+ text = re.sub(r'[^\w\s]', ' ', str(text).lower())
58
+ return [w for w in text.split() if len(w) > 2]
59
+
60
+ def fit(self, documents):
61
+ """Build BM25 index from documents"""
62
+ self.corpus = [self.tokenize(doc) for doc in documents]
63
+ self.N = len(self.corpus)
64
+ if self.N == 0:
65
+ return
66
+ self.doc_lengths = [len(doc) for doc in self.corpus]
67
+ self.avgdl = sum(self.doc_lengths) / self.N
68
+
69
+ for doc in self.corpus:
70
+ seen = set()
71
+ for word in doc:
72
+ if word not in seen:
73
+ self.doc_freqs[word] += 1
74
+ seen.add(word)
75
+
76
+ for word, freq in self.doc_freqs.items():
77
+ self.idf[word] = log((self.N - freq + 0.5) / (freq + 0.5) + 1)
78
+
79
+ def score(self, query):
80
+ """Score all documents against query"""
81
+ query_tokens = self.tokenize(query)
82
+ scores = []
83
+
84
+ for idx, doc in enumerate(self.corpus):
85
+ score = 0
86
+ doc_len = self.doc_lengths[idx]
87
+ term_freqs = defaultdict(int)
88
+ for word in doc:
89
+ term_freqs[word] += 1
90
+
91
+ for token in query_tokens:
92
+ if token in self.idf:
93
+ tf = term_freqs[token]
94
+ idf = self.idf[token]
95
+ numerator = tf * (self.k1 + 1)
96
+ denominator = tf + self.k1 * (1 - self.b + self.b * doc_len / self.avgdl)
97
+ score += idf * numerator / denominator
98
+
99
+ scores.append((idx, score))
100
+
101
+ return sorted(scores, key=lambda x: x[1], reverse=True)
102
+
103
+
104
+ # ============ SEARCH FUNCTIONS ============
105
+ def _load_csv(filepath):
106
+ """Load CSV and return list of dicts"""
107
+ with open(filepath, 'r', encoding='utf-8') as f:
108
+ return list(csv.DictReader(f))
109
+
110
+
111
+ def _search_csv(filepath, search_cols, output_cols, query, max_results):
112
+ """Core search function using BM25"""
113
+ if not filepath.exists():
114
+ return []
115
+
116
+ data = _load_csv(filepath)
117
+
118
+ # Build documents from search columns
119
+ documents = [" ".join(str(row.get(col, "")) for col in search_cols) for row in data]
120
+
121
+ # BM25 search
122
+ bm25 = BM25()
123
+ bm25.fit(documents)
124
+ ranked = bm25.score(query)
125
+
126
+ # Get top results with score > 0
127
+ results = []
128
+ for idx, score in ranked[:max_results]:
129
+ if score > 0:
130
+ row = data[idx]
131
+ results.append({col: row.get(col, "") for col in output_cols if col in row})
132
+
133
+ return results
134
+
135
+
136
+ def detect_domain(query):
137
+ """Auto-detect the most relevant domain from query"""
138
+ query_lower = query.lower()
139
+
140
+ domain_keywords = {
141
+ "deliverable": ["card", "letterhead", "envelope", "folder", "shirt", "cap", "badge", "signage", "vehicle", "car", "van", "stationery", "uniform", "merchandise", "packaging", "banner", "booth"],
142
+ "style": ["style", "minimal", "modern", "luxury", "vintage", "industrial", "elegant", "bold", "corporate", "organic", "playful"],
143
+ "industry": ["tech", "finance", "legal", "healthcare", "hospitality", "food", "fashion", "retail", "construction", "logistics"],
144
+ "mockup": ["mockup", "scene", "context", "photo", "shot", "lighting", "background", "studio", "lifestyle"]
145
+ }
146
+
147
+ scores = {domain: sum(1 for kw in keywords if kw in query_lower) for domain, keywords in domain_keywords.items()}
148
+ best = max(scores, key=scores.get)
149
+ return best if scores[best] > 0 else "deliverable"
150
+
151
+
152
+ def search(query, domain=None, max_results=MAX_RESULTS):
153
+ """Main search function with auto-domain detection"""
154
+ if domain is None:
155
+ domain = detect_domain(query)
156
+
157
+ config = CSV_CONFIG.get(domain, CSV_CONFIG["deliverable"])
158
+ filepath = DATA_DIR / config["file"]
159
+
160
+ if not filepath.exists():
161
+ return {"error": f"File not found: {filepath}", "domain": domain}
162
+
163
+ results = _search_csv(filepath, config["search_cols"], config["output_cols"], query, max_results)
164
+
165
+ return {
166
+ "domain": domain,
167
+ "query": query,
168
+ "file": config["file"],
169
+ "count": len(results),
170
+ "results": results
171
+ }
172
+
173
+
174
+ def search_all(query, max_results=2):
175
+ """Search across all domains and combine results"""
176
+ all_results = {}
177
+ for domain in CSV_CONFIG.keys():
178
+ result = search(query, domain, max_results)
179
+ if result.get("results"):
180
+ all_results[domain] = result["results"]
181
+ return all_results
182
+
183
+
184
+ def get_cip_brief(brand_name, industry_query, style_query=None):
185
+ """Generate a comprehensive CIP brief for a brand"""
186
+ # Search industry
187
+ industry_results = search(industry_query, "industry", 1)
188
+ industry = industry_results.get("results", [{}])[0] if industry_results.get("results") else {}
189
+
190
+ # Search style (use industry style if not specified)
191
+ style_query = style_query or industry.get("CIP Style", "corporate minimal")
192
+ style_results = search(style_query, "style", 1)
193
+ style = style_results.get("results", [{}])[0] if style_results.get("results") else {}
194
+
195
+ # Get recommended deliverables for the industry
196
+ key_deliverables = industry.get("Key Deliverables", "").split()
197
+ deliverable_results = []
198
+ for d in key_deliverables[:5]:
199
+ result = search(d, "deliverable", 1)
200
+ if result.get("results"):
201
+ deliverable_results.append(result["results"][0])
202
+
203
+ return {
204
+ "brand_name": brand_name,
205
+ "industry": industry,
206
+ "style": style,
207
+ "recommended_deliverables": deliverable_results,
208
+ "color_system": {
209
+ "primary": style.get("Primary Colors", industry.get("Primary Colors", "")),
210
+ "secondary": style.get("Secondary Colors", industry.get("Secondary Colors", ""))
211
+ },
212
+ "typography": style.get("Typography", industry.get("Typography", "")),
213
+ "materials": style.get("Materials", ""),
214
+ "finishes": style.get("Finishes", "")
215
+ }