@hybridlabor-api/bdb-antigravity-skills 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 (792) hide show
  1. package/GEMINI.md +29 -0
  2. package/README.md +64 -0
  3. package/installer.sh +97 -0
  4. package/mcp_config.json +32 -0
  5. package/package.json +20 -0
  6. package/skills/global_config/MCP_Manage/SKILL.md +39 -0
  7. package/skills/global_config/agent-manager-skill/SKILL.md +47 -0
  8. package/skills/global_config/agent-memory-mcp/SKILL.md +92 -0
  9. package/skills/global_config/agent-orchestrator/SKILL.md +321 -0
  10. package/skills/global_config/agent-orchestrator/references/capability-taxonomy.md +85 -0
  11. package/skills/global_config/agent-orchestrator/references/orchestration-patterns.md +129 -0
  12. package/skills/global_config/agent-orchestrator/scripts/match_skills.py +329 -0
  13. package/skills/global_config/agent-orchestrator/scripts/orchestrate.py +304 -0
  14. package/skills/global_config/agent-orchestrator/scripts/requirements.txt +1 -0
  15. package/skills/global_config/agent-orchestrator/scripts/scan_registry.py +508 -0
  16. package/skills/global_config/agent-tool-builder/SKILL.md +714 -0
  17. package/skills/global_config/ai-agent-development/SKILL.md +178 -0
  18. package/skills/global_config/ai-product/SKILL.md +753 -0
  19. package/skills/global_config/api-design-principles/SKILL.md +45 -0
  20. package/skills/global_config/api-design-principles/assets/api-design-checklist.md +155 -0
  21. package/skills/global_config/api-design-principles/assets/rest-api-template.py +182 -0
  22. package/skills/global_config/api-design-principles/references/graphql-schema-design.md +583 -0
  23. package/skills/global_config/api-design-principles/references/rest-best-practices.md +408 -0
  24. package/skills/global_config/api-design-principles/resources/implementation-playbook.md +513 -0
  25. package/skills/global_config/api-patterns/SKILL.md +90 -0
  26. package/skills/global_config/api-patterns/api-style.md +42 -0
  27. package/skills/global_config/api-patterns/auth.md +24 -0
  28. package/skills/global_config/api-patterns/documentation.md +26 -0
  29. package/skills/global_config/api-patterns/graphql.md +41 -0
  30. package/skills/global_config/api-patterns/rate-limiting.md +31 -0
  31. package/skills/global_config/api-patterns/response.md +37 -0
  32. package/skills/global_config/api-patterns/rest.md +40 -0
  33. package/skills/global_config/api-patterns/scripts/api_validator.py +211 -0
  34. package/skills/global_config/api-patterns/security-testing.md +122 -0
  35. package/skills/global_config/api-patterns/trpc.md +41 -0
  36. package/skills/global_config/api-patterns/versioning.md +22 -0
  37. package/skills/global_config/apify-lead-generation/SKILL.md +131 -0
  38. package/skills/global_config/apify-lead-generation/reference/scripts/run_actor.js +363 -0
  39. package/skills/global_config/apify-ultimate-scraper/SKILL.md +241 -0
  40. package/skills/global_config/apify-ultimate-scraper/reference/scripts/run_actor.js +363 -0
  41. package/skills/global_config/architect-review/SKILL.md +177 -0
  42. package/skills/global_config/bash-linux/SKILL.md +209 -0
  43. package/skills/global_config/bdbrainstorm/SKILL.md +37 -0
  44. package/skills/global_config/browser-automation/SKILL.md +1116 -0
  45. package/skills/global_config/clean-code/SKILL.md +99 -0
  46. package/skills/global_config/cloudflare-workers-expert/SKILL.md +94 -0
  47. package/skills/global_config/concise-planning/SKILL.md +73 -0
  48. package/skills/global_config/copywriting/SKILL.md +254 -0
  49. package/skills/global_config/crewai/SKILL.md +458 -0
  50. package/skills/global_config/database-design/SKILL.md +62 -0
  51. package/skills/global_config/database-design/database-selection.md +43 -0
  52. package/skills/global_config/database-design/indexing.md +39 -0
  53. package/skills/global_config/database-design/migrations.md +48 -0
  54. package/skills/global_config/database-design/optimization.md +36 -0
  55. package/skills/global_config/database-design/orm-selection.md +30 -0
  56. package/skills/global_config/database-design/schema-design.md +56 -0
  57. package/skills/global_config/database-design/scripts/schema_validator.py +172 -0
  58. package/skills/global_config/debugger/SKILL.md +58 -0
  59. package/skills/global_config/deep-research/SKILL.md +120 -0
  60. package/skills/global_config/design-spells/SKILL.md +41 -0
  61. package/skills/global_config/design-taste-frontend/SKILL.md +247 -0
  62. package/skills/global_config/docker-expert/SKILL.md +418 -0
  63. package/skills/global_config/documentation/SKILL.md +265 -0
  64. package/skills/global_config/drizzle-orm-expert/SKILL.md +368 -0
  65. package/skills/global_config/executing-plans/SKILL.md +87 -0
  66. package/skills/global_config/frontend-design/LICENSE.txt +177 -0
  67. package/skills/global_config/frontend-design/SKILL.md +282 -0
  68. package/skills/global_config/frontend-dev-guidelines/SKILL.md +369 -0
  69. package/skills/global_config/frontend-dev-guidelines/resources/common-patterns.md +331 -0
  70. package/skills/global_config/frontend-dev-guidelines/resources/complete-examples.md +872 -0
  71. package/skills/global_config/frontend-dev-guidelines/resources/component-patterns.md +502 -0
  72. package/skills/global_config/frontend-dev-guidelines/resources/data-fetching.md +767 -0
  73. package/skills/global_config/frontend-dev-guidelines/resources/file-organization.md +502 -0
  74. package/skills/global_config/frontend-dev-guidelines/resources/loading-and-error-states.md +501 -0
  75. package/skills/global_config/frontend-dev-guidelines/resources/performance.md +406 -0
  76. package/skills/global_config/frontend-dev-guidelines/resources/routing-guide.md +364 -0
  77. package/skills/global_config/frontend-dev-guidelines/resources/styling-guide.md +428 -0
  78. package/skills/global_config/frontend-dev-guidelines/resources/typescript-standards.md +418 -0
  79. package/skills/global_config/gemini-api-dev/SKILL.md +138 -0
  80. package/skills/global_config/gemini-api-integration/SKILL.md +193 -0
  81. package/skills/global_config/geo-fundamentals/SKILL.md +165 -0
  82. package/skills/global_config/geo-fundamentals/scripts/geo_checker.py +289 -0
  83. package/skills/global_config/git-advanced-workflows/SKILL.md +420 -0
  84. package/skills/global_config/git-pr-review/SKILL.md +179 -0
  85. package/skills/global_config/github/SKILL.md +80 -0
  86. package/skills/global_config/github/agents/openai.yaml +4 -0
  87. package/skills/global_config/github-actions-templates/SKILL.md +353 -0
  88. package/skills/global_config/github-workflow-automation/SKILL.md +854 -0
  89. package/skills/global_config/go-concurrency-patterns/SKILL.md +41 -0
  90. package/skills/global_config/go-concurrency-patterns/resources/implementation-playbook.md +654 -0
  91. package/skills/global_config/go-playwright/SKILL.md +76 -0
  92. package/skills/global_config/go-playwright/resources/implementation-playbook.md +110 -0
  93. package/skills/global_config/golang-pro/SKILL.md +181 -0
  94. package/skills/global_config/google-sheets-automation/SKILL.md +149 -0
  95. package/skills/global_config/landing-page-generator/SKILL.md +213 -0
  96. package/skills/global_config/landing-page-generator/references/conversion-patterns.md +176 -0
  97. package/skills/global_config/landing-page-generator/references/frameworks.md +177 -0
  98. package/skills/global_config/landing-page-generator/references/landing-page-patterns.md +98 -0
  99. package/skills/global_config/landing-page-generator/references/seo-checklist.md +109 -0
  100. package/skills/global_config/landing-page-generator/scripts/landing_page_scaffolder.py +568 -0
  101. package/skills/global_config/linear-claude-skill/SKILL.md +523 -0
  102. package/skills/global_config/llm-app-patterns/SKILL.md +768 -0
  103. package/skills/global_config/llm-application-dev-ai-assistant/SKILL.md +43 -0
  104. package/skills/global_config/llm-application-dev-ai-assistant/resources/implementation-playbook.md +1236 -0
  105. package/skills/global_config/llm-prompt-optimizer/SKILL.md +187 -0
  106. package/skills/global_config/llm-structured-output/SKILL.md +212 -0
  107. package/skills/global_config/local-llm-expert/SKILL.md +88 -0
  108. package/skills/global_config/microservices-patterns/SKILL.md +43 -0
  109. package/skills/global_config/microservices-patterns/resources/implementation-playbook.md +607 -0
  110. package/skills/global_config/modern-javascript-patterns/SKILL.md +43 -0
  111. package/skills/global_config/modern-javascript-patterns/resources/implementation-playbook.md +910 -0
  112. package/skills/global_config/monorepo-management/SKILL.md +43 -0
  113. package/skills/global_config/monorepo-management/resources/implementation-playbook.md +621 -0
  114. package/skills/global_config/n8n-code-javascript/SKILL.md +706 -0
  115. package/skills/global_config/n8n-code-python/SKILL.md +755 -0
  116. package/skills/global_config/n8n-expression-syntax/SKILL.md +528 -0
  117. package/skills/global_config/n8n-mcp-tools-expert/SKILL.md +654 -0
  118. package/skills/global_config/n8n-workflow-patterns/SKILL.md +423 -0
  119. package/skills/global_config/neon-postgres/SKILL.md +619 -0
  120. package/skills/global_config/nextjs-app-router-patterns/SKILL.md +41 -0
  121. package/skills/global_config/nextjs-app-router-patterns/resources/implementation-playbook.md +543 -0
  122. package/skills/global_config/nextjs-best-practices/SKILL.md +213 -0
  123. package/skills/global_config/notion-automation/SKILL.md +224 -0
  124. package/skills/global_config/obsidian-markdown/SKILL.md +209 -0
  125. package/skills/global_config/obsidian-markdown/references/CALLOUTS.md +58 -0
  126. package/skills/global_config/obsidian-markdown/references/EMBEDS.md +63 -0
  127. package/skills/global_config/obsidian-markdown/references/PROPERTIES.md +61 -0
  128. package/skills/global_config/openapi-spec-generation/SKILL.md +41 -0
  129. package/skills/global_config/openapi-spec-generation/resources/implementation-playbook.md +1027 -0
  130. package/skills/global_config/os-scripting/SKILL.md +433 -0
  131. package/skills/global_config/planning-with-files/SKILL.md +189 -0
  132. package/skills/global_config/planning-with-files/examples.md +202 -0
  133. package/skills/global_config/planning-with-files/reference.md +218 -0
  134. package/skills/global_config/planning-with-files/scripts/check-complete.sh +44 -0
  135. package/skills/global_config/planning-with-files/scripts/init-session.sh +120 -0
  136. package/skills/global_config/planning-with-files/templates/findings.md +95 -0
  137. package/skills/global_config/planning-with-files/templates/progress.md +114 -0
  138. package/skills/global_config/planning-with-files/templates/task_plan.md +132 -0
  139. package/skills/global_config/playwright-skill/API_REFERENCE.md +653 -0
  140. package/skills/global_config/playwright-skill/SKILL.md +469 -0
  141. package/skills/global_config/playwright-skill/lib/helpers.js +441 -0
  142. package/skills/global_config/playwright-skill/package.json +26 -0
  143. package/skills/global_config/playwright-skill/run.js +228 -0
  144. package/skills/global_config/posix-shell-pro/SKILL.md +308 -0
  145. package/skills/global_config/postgres-best-practices/AGENTS.md +1490 -0
  146. package/skills/global_config/postgres-best-practices/README.md +119 -0
  147. package/skills/global_config/postgres-best-practices/SKILL.md +63 -0
  148. package/skills/global_config/postgres-best-practices/metadata.json +13 -0
  149. package/skills/global_config/postgres-best-practices/rules/_contributing.md +171 -0
  150. package/skills/global_config/postgres-best-practices/rules/_sections.md +39 -0
  151. package/skills/global_config/postgres-best-practices/rules/_template.md +34 -0
  152. package/skills/global_config/postgres-best-practices/rules/advanced-full-text-search.md +55 -0
  153. package/skills/global_config/postgres-best-practices/rules/advanced-jsonb-indexing.md +49 -0
  154. package/skills/global_config/postgres-best-practices/rules/conn-idle-timeout.md +46 -0
  155. package/skills/global_config/postgres-best-practices/rules/conn-limits.md +44 -0
  156. package/skills/global_config/postgres-best-practices/rules/conn-pooling.md +41 -0
  157. package/skills/global_config/postgres-best-practices/rules/conn-prepared-statements.md +46 -0
  158. package/skills/global_config/postgres-best-practices/rules/data-batch-inserts.md +54 -0
  159. package/skills/global_config/postgres-best-practices/rules/data-n-plus-one.md +53 -0
  160. package/skills/global_config/postgres-best-practices/rules/data-pagination.md +50 -0
  161. package/skills/global_config/postgres-best-practices/rules/data-upsert.md +50 -0
  162. package/skills/global_config/postgres-best-practices/rules/lock-advisory.md +56 -0
  163. package/skills/global_config/postgres-best-practices/rules/lock-deadlock-prevention.md +68 -0
  164. package/skills/global_config/postgres-best-practices/rules/lock-short-transactions.md +50 -0
  165. package/skills/global_config/postgres-best-practices/rules/lock-skip-locked.md +54 -0
  166. package/skills/global_config/postgres-best-practices/rules/monitor-explain-analyze.md +45 -0
  167. package/skills/global_config/postgres-best-practices/rules/monitor-pg-stat-statements.md +55 -0
  168. package/skills/global_config/postgres-best-practices/rules/monitor-vacuum-analyze.md +55 -0
  169. package/skills/global_config/postgres-best-practices/rules/query-composite-indexes.md +44 -0
  170. package/skills/global_config/postgres-best-practices/rules/query-covering-indexes.md +40 -0
  171. package/skills/global_config/postgres-best-practices/rules/query-index-types.md +45 -0
  172. package/skills/global_config/postgres-best-practices/rules/query-missing-indexes.md +43 -0
  173. package/skills/global_config/postgres-best-practices/rules/query-partial-indexes.md +45 -0
  174. package/skills/global_config/postgres-best-practices/rules/schema-data-types.md +46 -0
  175. package/skills/global_config/postgres-best-practices/rules/schema-foreign-key-indexes.md +59 -0
  176. package/skills/global_config/postgres-best-practices/rules/schema-lowercase-identifiers.md +55 -0
  177. package/skills/global_config/postgres-best-practices/rules/schema-partitioning.md +55 -0
  178. package/skills/global_config/postgres-best-practices/rules/schema-primary-keys.md +61 -0
  179. package/skills/global_config/postgres-best-practices/rules/security-privileges.md +54 -0
  180. package/skills/global_config/postgres-best-practices/rules/security-rls-basics.md +50 -0
  181. package/skills/global_config/postgres-best-practices/rules/security-rls-performance.md +57 -0
  182. package/skills/global_config/postgresql/SKILL.md +233 -0
  183. package/skills/global_config/prisma-expert/SKILL.md +366 -0
  184. package/skills/global_config/product-manager-toolkit/SKILL.md +362 -0
  185. package/skills/global_config/product-manager-toolkit/references/prd_templates.md +317 -0
  186. package/skills/global_config/product-manager-toolkit/scripts/customer_interview_analyzer.py +441 -0
  187. package/skills/global_config/product-manager-toolkit/scripts/rice_prioritizer.py +296 -0
  188. package/skills/global_config/programmatic-seo/SKILL.md +356 -0
  189. package/skills/global_config/prompt-engineer/README.md +659 -0
  190. package/skills/global_config/prompt-engineer/SKILL.md +281 -0
  191. package/skills/global_config/prompt-engineering-patterns/SKILL.md +221 -0
  192. package/skills/global_config/prompt-engineering-patterns/assets/few-shot-examples.json +106 -0
  193. package/skills/global_config/prompt-engineering-patterns/assets/prompt-template-library.md +246 -0
  194. package/skills/global_config/prompt-engineering-patterns/references/chain-of-thought.md +399 -0
  195. package/skills/global_config/prompt-engineering-patterns/references/few-shot-learning.md +369 -0
  196. package/skills/global_config/prompt-engineering-patterns/references/prompt-optimization.md +414 -0
  197. package/skills/global_config/prompt-engineering-patterns/references/prompt-templates.md +470 -0
  198. package/skills/global_config/prompt-engineering-patterns/references/system-prompts.md +189 -0
  199. package/skills/global_config/prompt-engineering-patterns/scripts/optimize-prompt.py +279 -0
  200. package/skills/global_config/python-patterns/SKILL.md +451 -0
  201. package/skills/global_config/python-performance-optimization/SKILL.md +44 -0
  202. package/skills/global_config/python-performance-optimization/resources/implementation-playbook.md +868 -0
  203. package/skills/global_config/python-pro/SKILL.md +161 -0
  204. package/skills/global_config/rag-engineer/SKILL.md +341 -0
  205. package/skills/global_config/rag-implementation/SKILL.md +201 -0
  206. package/skills/global_config/react-best-practices/AGENTS.md +2249 -0
  207. package/skills/global_config/react-best-practices/README.md +123 -0
  208. package/skills/global_config/react-best-practices/SKILL.md +131 -0
  209. package/skills/global_config/react-best-practices/metadata.json +15 -0
  210. package/skills/global_config/react-best-practices/rules/_sections.md +46 -0
  211. package/skills/global_config/react-best-practices/rules/_template.md +28 -0
  212. package/skills/global_config/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  213. package/skills/global_config/react-best-practices/rules/advanced-use-latest.md +49 -0
  214. package/skills/global_config/react-best-practices/rules/async-api-routes.md +38 -0
  215. package/skills/global_config/react-best-practices/rules/async-defer-await.md +80 -0
  216. package/skills/global_config/react-best-practices/rules/async-dependencies.md +36 -0
  217. package/skills/global_config/react-best-practices/rules/async-parallel.md +28 -0
  218. package/skills/global_config/react-best-practices/rules/async-suspense-boundaries.md +99 -0
  219. package/skills/global_config/react-best-practices/rules/bundle-barrel-imports.md +59 -0
  220. package/skills/global_config/react-best-practices/rules/bundle-conditional.md +31 -0
  221. package/skills/global_config/react-best-practices/rules/bundle-defer-third-party.md +49 -0
  222. package/skills/global_config/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  223. package/skills/global_config/react-best-practices/rules/bundle-preload.md +50 -0
  224. package/skills/global_config/react-best-practices/rules/client-event-listeners.md +74 -0
  225. package/skills/global_config/react-best-practices/rules/client-swr-dedup.md +56 -0
  226. package/skills/global_config/react-best-practices/rules/js-batch-dom-css.md +82 -0
  227. package/skills/global_config/react-best-practices/rules/js-cache-function-results.md +80 -0
  228. package/skills/global_config/react-best-practices/rules/js-cache-property-access.md +28 -0
  229. package/skills/global_config/react-best-practices/rules/js-cache-storage.md +70 -0
  230. package/skills/global_config/react-best-practices/rules/js-combine-iterations.md +32 -0
  231. package/skills/global_config/react-best-practices/rules/js-early-exit.md +50 -0
  232. package/skills/global_config/react-best-practices/rules/js-hoist-regexp.md +45 -0
  233. package/skills/global_config/react-best-practices/rules/js-index-maps.md +37 -0
  234. package/skills/global_config/react-best-practices/rules/js-length-check-first.md +49 -0
  235. package/skills/global_config/react-best-practices/rules/js-min-max-loop.md +82 -0
  236. package/skills/global_config/react-best-practices/rules/js-set-map-lookups.md +24 -0
  237. package/skills/global_config/react-best-practices/rules/js-tosorted-immutable.md +57 -0
  238. package/skills/global_config/react-best-practices/rules/rendering-activity.md +26 -0
  239. package/skills/global_config/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  240. package/skills/global_config/react-best-practices/rules/rendering-conditional-render.md +40 -0
  241. package/skills/global_config/react-best-practices/rules/rendering-content-visibility.md +38 -0
  242. package/skills/global_config/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  243. package/skills/global_config/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  244. package/skills/global_config/react-best-practices/rules/rendering-svg-precision.md +28 -0
  245. package/skills/global_config/react-best-practices/rules/rerender-defer-reads.md +39 -0
  246. package/skills/global_config/react-best-practices/rules/rerender-dependencies.md +45 -0
  247. package/skills/global_config/react-best-practices/rules/rerender-derived-state.md +29 -0
  248. package/skills/global_config/react-best-practices/rules/rerender-functional-setstate.md +74 -0
  249. package/skills/global_config/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  250. package/skills/global_config/react-best-practices/rules/rerender-memo.md +44 -0
  251. package/skills/global_config/react-best-practices/rules/rerender-transitions.md +40 -0
  252. package/skills/global_config/react-best-practices/rules/server-after-nonblocking.md +73 -0
  253. package/skills/global_config/react-best-practices/rules/server-cache-lru.md +41 -0
  254. package/skills/global_config/react-best-practices/rules/server-cache-react.md +26 -0
  255. package/skills/global_config/react-best-practices/rules/server-parallel-fetching.md +79 -0
  256. package/skills/global_config/react-best-practices/rules/server-serialization.md +38 -0
  257. package/skills/global_config/react-component-performance/SKILL.md +139 -0
  258. package/skills/global_config/react-component-performance/agents/openai.yaml +4 -0
  259. package/skills/global_config/react-component-performance/references/examples.md +88 -0
  260. package/skills/global_config/react-patterns/SKILL.md +216 -0
  261. package/skills/global_config/readme/SKILL.md +848 -0
  262. package/skills/global_config/remotion/SKILL.md +404 -0
  263. package/skills/global_config/schema-markup/SKILL.md +363 -0
  264. package/skills/global_config/senior-frontend/SKILL.md +495 -0
  265. package/skills/global_config/senior-frontend/references/frontend_best_practices.md +806 -0
  266. package/skills/global_config/senior-frontend/references/nextjs_optimization_guide.md +724 -0
  267. package/skills/global_config/senior-frontend/references/react_patterns.md +746 -0
  268. package/skills/global_config/senior-frontend/scripts/bundle_analyzer.py +407 -0
  269. package/skills/global_config/senior-frontend/scripts/component_generator.py +329 -0
  270. package/skills/global_config/senior-frontend/scripts/frontend_scaffolder.py +1005 -0
  271. package/skills/global_config/senior-fullstack/SKILL.md +220 -0
  272. package/skills/global_config/senior-fullstack/references/architecture_patterns.md +103 -0
  273. package/skills/global_config/senior-fullstack/references/development_workflows.md +103 -0
  274. package/skills/global_config/senior-fullstack/references/tech_stack_guide.md +103 -0
  275. package/skills/global_config/senior-fullstack/scripts/code_quality_analyzer.py +114 -0
  276. package/skills/global_config/senior-fullstack/scripts/fullstack_scaffolder.py +114 -0
  277. package/skills/global_config/senior-fullstack/scripts/project_scaffolder.py +114 -0
  278. package/skills/global_config/seo/SKILL.md +143 -0
  279. package/skills/global_config/seo/references/cwv-thresholds.md +108 -0
  280. package/skills/global_config/seo/references/eeat-framework.md +214 -0
  281. package/skills/global_config/seo/references/quality-gates.md +155 -0
  282. package/skills/global_config/seo/references/schema-types.md +118 -0
  283. package/skills/global_config/seo-audit/SKILL.md +492 -0
  284. package/skills/global_config/seo-technical/SKILL.md +179 -0
  285. package/skills/global_config/shadcn/SKILL.md +254 -0
  286. package/skills/global_config/shadcn/agents/openai.yml +5 -0
  287. package/skills/global_config/shadcn/assets/shadcn-small.png +0 -0
  288. package/skills/global_config/shadcn/assets/shadcn.png +0 -0
  289. package/skills/global_config/shadcn/cli.md +255 -0
  290. package/skills/global_config/shadcn/customization.md +202 -0
  291. package/skills/global_config/shadcn/evals/evals.json +47 -0
  292. package/skills/global_config/shadcn/mcp.md +94 -0
  293. package/skills/global_config/shadcn/rules/base-vs-radix.md +306 -0
  294. package/skills/global_config/shadcn/rules/composition.md +195 -0
  295. package/skills/global_config/shadcn/rules/forms.md +192 -0
  296. package/skills/global_config/shadcn/rules/icons.md +101 -0
  297. package/skills/global_config/shadcn/rules/styling.md +162 -0
  298. package/skills/global_config/simplify-code/SKILL.md +183 -0
  299. package/skills/global_config/slack-automation/SKILL.md +197 -0
  300. package/skills/global_config/software-architecture/SKILL.md +86 -0
  301. package/skills/global_config/spline-3d-integration/SKILL.md +90 -0
  302. package/skills/global_config/spline-3d-integration/examples/interactive-scene.tsx +198 -0
  303. package/skills/global_config/spline-3d-integration/examples/react-spline-wrapper.tsx +124 -0
  304. package/skills/global_config/spline-3d-integration/examples/vanilla-embed.html +146 -0
  305. package/skills/global_config/spline-3d-integration/guides/COMMON_PROBLEMS.md +262 -0
  306. package/skills/global_config/spline-3d-integration/guides/PERFORMANCE.md +163 -0
  307. package/skills/global_config/spline-3d-integration/guides/REACT_INTEGRATION.md +212 -0
  308. package/skills/global_config/spline-3d-integration/guides/VANILLA_INTEGRATION.md +203 -0
  309. package/skills/global_config/subagent-driven-development/SKILL.md +247 -0
  310. package/skills/global_config/subagent-driven-development/code-quality-reviewer-prompt.md +20 -0
  311. package/skills/global_config/subagent-driven-development/implementer-prompt.md +78 -0
  312. package/skills/global_config/subagent-driven-development/spec-reviewer-prompt.md +61 -0
  313. package/skills/global_config/systematic-debugging/CREATION-LOG.md +119 -0
  314. package/skills/global_config/systematic-debugging/SKILL.md +303 -0
  315. package/skills/global_config/systematic-debugging/condition-based-waiting-example.ts +158 -0
  316. package/skills/global_config/systematic-debugging/condition-based-waiting.md +115 -0
  317. package/skills/global_config/systematic-debugging/defense-in-depth.md +122 -0
  318. package/skills/global_config/systematic-debugging/find-polluter.sh +63 -0
  319. package/skills/global_config/systematic-debugging/root-cause-tracing.md +169 -0
  320. package/skills/global_config/systematic-debugging/test-academic.md +14 -0
  321. package/skills/global_config/systematic-debugging/test-pressure-1.md +58 -0
  322. package/skills/global_config/systematic-debugging/test-pressure-2.md +68 -0
  323. package/skills/global_config/systematic-debugging/test-pressure-3.md +69 -0
  324. package/skills/global_config/tailwind-patterns/SKILL.md +279 -0
  325. package/skills/global_config/tanstack-query-expert/SKILL.md +247 -0
  326. package/skills/global_config/tdd-workflow/SKILL.md +159 -0
  327. package/skills/global_config/test-driven-development/SKILL.md +378 -0
  328. package/skills/global_config/test-driven-development/testing-anti-patterns.md +299 -0
  329. package/skills/global_config/threejs-skills/SKILL.md +720 -0
  330. package/skills/global_config/tmux/SKILL.md +375 -0
  331. package/skills/global_config/turborepo-caching/SKILL.md +427 -0
  332. package/skills/global_config/typescript-pro/SKILL.md +58 -0
  333. package/skills/global_config/ui-component/SKILL.md +104 -0
  334. package/skills/global_config/ui-page/SKILL.md +100 -0
  335. package/skills/global_config/ui-pattern/SKILL.md +92 -0
  336. package/skills/global_config/ui-review/SKILL.md +90 -0
  337. package/skills/global_config/ui-tokens/SKILL.md +73 -0
  338. package/skills/global_config/ui-ux-pro-max/SKILL.md +361 -0
  339. package/skills/global_config/ui-ux-pro-max/data/charts.csv +26 -0
  340. package/skills/global_config/ui-ux-pro-max/data/colors.csv +97 -0
  341. package/skills/global_config/ui-ux-pro-max/data/icons.csv +101 -0
  342. package/skills/global_config/ui-ux-pro-max/data/landing.csv +31 -0
  343. package/skills/global_config/ui-ux-pro-max/data/products.csv +97 -0
  344. package/skills/global_config/ui-ux-pro-max/data/prompts.csv +24 -0
  345. package/skills/global_config/ui-ux-pro-max/data/react-performance.csv +45 -0
  346. package/skills/global_config/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  347. package/skills/global_config/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  348. package/skills/global_config/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  349. package/skills/global_config/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  350. package/skills/global_config/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  351. package/skills/global_config/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  352. package/skills/global_config/ui-ux-pro-max/data/stacks/react.csv +54 -0
  353. package/skills/global_config/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  354. package/skills/global_config/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  355. package/skills/global_config/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  356. package/skills/global_config/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  357. package/skills/global_config/ui-ux-pro-max/data/styles.csv +59 -0
  358. package/skills/global_config/ui-ux-pro-max/data/typography.csv +58 -0
  359. package/skills/global_config/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  360. package/skills/global_config/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  361. package/skills/global_config/ui-ux-pro-max/data/web-interface.csv +31 -0
  362. package/skills/global_config/ui-ux-pro-max/scripts/__pycache__/core.cpython-313.pyc +0 -0
  363. package/skills/global_config/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-313.pyc +0 -0
  364. package/skills/global_config/ui-ux-pro-max/scripts/core.py +257 -0
  365. package/skills/global_config/ui-ux-pro-max/scripts/design_system.py +487 -0
  366. package/skills/global_config/ui-ux-pro-max/scripts/search.py +76 -0
  367. package/skills/global_config/using-neon/SKILL.md +90 -0
  368. package/skills/global_config/ux-audit/SKILL.md +66 -0
  369. package/skills/global_config/ux-feedback/SKILL.md +68 -0
  370. package/skills/global_config/ux-flow/SKILL.md +72 -0
  371. package/skills/global_config/ux-persuasion-engineer/SKILL.md +119 -0
  372. package/skills/global_config/vector-database-engineer/SKILL.md +68 -0
  373. package/skills/global_config/vercel-ai-sdk-expert/SKILL.md +227 -0
  374. package/skills/global_config/vercel-deployment/SKILL.md +682 -0
  375. package/skills/global_config/wcag-audit-patterns/SKILL.md +49 -0
  376. package/skills/global_config/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  377. package/skills/global_config/web-artifacts-builder/LICENSE.txt +202 -0
  378. package/skills/global_config/web-artifacts-builder/SKILL.md +84 -0
  379. package/skills/global_config/web-artifacts-builder/scripts/bundle-artifact.sh +54 -0
  380. package/skills/global_config/web-artifacts-builder/scripts/init-artifact.sh +322 -0
  381. package/skills/global_config/web-artifacts-builder/scripts/shadcn-components.tar.gz +0 -0
  382. package/skills/global_config/web-performance-optimization/SKILL.md +654 -0
  383. package/skills/global_config/web-scraper/SKILL.md +757 -0
  384. package/skills/global_config/web-scraper/references/data-transforms.md +397 -0
  385. package/skills/global_config/web-scraper/references/extraction-patterns.md +475 -0
  386. package/skills/global_config/web-scraper/references/output-templates.md +481 -0
  387. package/skills/global_config/webapp-testing/LICENSE.txt +202 -0
  388. package/skills/global_config/webapp-testing/SKILL.md +106 -0
  389. package/skills/global_config/webapp-testing/scripts/with_server.py +106 -0
  390. package/skills/global_config/writing-plans/SKILL.md +127 -0
  391. package/skills/global_config/zustand-store-ts/SKILL.md +79 -0
  392. package/skills/global_legacy/agent-manager-skill/SKILL.md +47 -0
  393. package/skills/global_legacy/agent-memory-mcp/SKILL.md +92 -0
  394. package/skills/global_legacy/agent-orchestrator/SKILL.md +321 -0
  395. package/skills/global_legacy/agent-orchestrator/references/capability-taxonomy.md +85 -0
  396. package/skills/global_legacy/agent-orchestrator/references/orchestration-patterns.md +129 -0
  397. package/skills/global_legacy/agent-orchestrator/scripts/match_skills.py +329 -0
  398. package/skills/global_legacy/agent-orchestrator/scripts/orchestrate.py +304 -0
  399. package/skills/global_legacy/agent-orchestrator/scripts/requirements.txt +1 -0
  400. package/skills/global_legacy/agent-orchestrator/scripts/scan_registry.py +508 -0
  401. package/skills/global_legacy/agent-tool-builder/SKILL.md +714 -0
  402. package/skills/global_legacy/ai-agent-development/SKILL.md +178 -0
  403. package/skills/global_legacy/ai-product/SKILL.md +753 -0
  404. package/skills/global_legacy/api-design-principles/SKILL.md +45 -0
  405. package/skills/global_legacy/api-design-principles/assets/api-design-checklist.md +155 -0
  406. package/skills/global_legacy/api-design-principles/assets/rest-api-template.py +182 -0
  407. package/skills/global_legacy/api-design-principles/references/graphql-schema-design.md +583 -0
  408. package/skills/global_legacy/api-design-principles/references/rest-best-practices.md +408 -0
  409. package/skills/global_legacy/api-design-principles/resources/implementation-playbook.md +513 -0
  410. package/skills/global_legacy/api-patterns/SKILL.md +90 -0
  411. package/skills/global_legacy/api-patterns/api-style.md +42 -0
  412. package/skills/global_legacy/api-patterns/auth.md +24 -0
  413. package/skills/global_legacy/api-patterns/documentation.md +26 -0
  414. package/skills/global_legacy/api-patterns/graphql.md +41 -0
  415. package/skills/global_legacy/api-patterns/rate-limiting.md +31 -0
  416. package/skills/global_legacy/api-patterns/response.md +37 -0
  417. package/skills/global_legacy/api-patterns/rest.md +40 -0
  418. package/skills/global_legacy/api-patterns/scripts/api_validator.py +211 -0
  419. package/skills/global_legacy/api-patterns/security-testing.md +122 -0
  420. package/skills/global_legacy/api-patterns/trpc.md +41 -0
  421. package/skills/global_legacy/api-patterns/versioning.md +22 -0
  422. package/skills/global_legacy/apify-lead-generation/SKILL.md +131 -0
  423. package/skills/global_legacy/apify-lead-generation/reference/scripts/run_actor.js +363 -0
  424. package/skills/global_legacy/apify-ultimate-scraper/SKILL.md +241 -0
  425. package/skills/global_legacy/apify-ultimate-scraper/reference/scripts/run_actor.js +363 -0
  426. package/skills/global_legacy/architect-review/SKILL.md +177 -0
  427. package/skills/global_legacy/bash-linux/SKILL.md +209 -0
  428. package/skills/global_legacy/brainstorming/SKILL.md +237 -0
  429. package/skills/global_legacy/browser-automation/SKILL.md +1116 -0
  430. package/skills/global_legacy/clean-code/SKILL.md +99 -0
  431. package/skills/global_legacy/cloudflare-workers-expert/SKILL.md +94 -0
  432. package/skills/global_legacy/concise-planning/SKILL.md +73 -0
  433. package/skills/global_legacy/copywriting/SKILL.md +254 -0
  434. package/skills/global_legacy/crewai/SKILL.md +458 -0
  435. package/skills/global_legacy/database-design/SKILL.md +62 -0
  436. package/skills/global_legacy/database-design/database-selection.md +43 -0
  437. package/skills/global_legacy/database-design/indexing.md +39 -0
  438. package/skills/global_legacy/database-design/migrations.md +48 -0
  439. package/skills/global_legacy/database-design/optimization.md +36 -0
  440. package/skills/global_legacy/database-design/orm-selection.md +30 -0
  441. package/skills/global_legacy/database-design/schema-design.md +56 -0
  442. package/skills/global_legacy/database-design/scripts/schema_validator.py +172 -0
  443. package/skills/global_legacy/debugger/SKILL.md +58 -0
  444. package/skills/global_legacy/deep-research/SKILL.md +120 -0
  445. package/skills/global_legacy/design-spells/SKILL.md +41 -0
  446. package/skills/global_legacy/design-taste-frontend/SKILL.md +247 -0
  447. package/skills/global_legacy/docker-expert/SKILL.md +418 -0
  448. package/skills/global_legacy/documentation/SKILL.md +265 -0
  449. package/skills/global_legacy/drizzle-orm-expert/SKILL.md +368 -0
  450. package/skills/global_legacy/executing-plans/SKILL.md +87 -0
  451. package/skills/global_legacy/frontend-design/LICENSE.txt +177 -0
  452. package/skills/global_legacy/frontend-design/SKILL.md +282 -0
  453. package/skills/global_legacy/frontend-dev-guidelines/SKILL.md +369 -0
  454. package/skills/global_legacy/frontend-dev-guidelines/resources/common-patterns.md +331 -0
  455. package/skills/global_legacy/frontend-dev-guidelines/resources/complete-examples.md +872 -0
  456. package/skills/global_legacy/frontend-dev-guidelines/resources/component-patterns.md +502 -0
  457. package/skills/global_legacy/frontend-dev-guidelines/resources/data-fetching.md +767 -0
  458. package/skills/global_legacy/frontend-dev-guidelines/resources/file-organization.md +502 -0
  459. package/skills/global_legacy/frontend-dev-guidelines/resources/loading-and-error-states.md +501 -0
  460. package/skills/global_legacy/frontend-dev-guidelines/resources/performance.md +406 -0
  461. package/skills/global_legacy/frontend-dev-guidelines/resources/routing-guide.md +364 -0
  462. package/skills/global_legacy/frontend-dev-guidelines/resources/styling-guide.md +428 -0
  463. package/skills/global_legacy/frontend-dev-guidelines/resources/typescript-standards.md +418 -0
  464. package/skills/global_legacy/gemini-api-dev/SKILL.md +138 -0
  465. package/skills/global_legacy/gemini-api-integration/SKILL.md +193 -0
  466. package/skills/global_legacy/geo-fundamentals/SKILL.md +165 -0
  467. package/skills/global_legacy/geo-fundamentals/scripts/geo_checker.py +289 -0
  468. package/skills/global_legacy/git-advanced-workflows/SKILL.md +420 -0
  469. package/skills/global_legacy/git-pr-review/SKILL.md +179 -0
  470. package/skills/global_legacy/github/SKILL.md +80 -0
  471. package/skills/global_legacy/github/agents/openai.yaml +4 -0
  472. package/skills/global_legacy/github-actions-templates/SKILL.md +353 -0
  473. package/skills/global_legacy/github-workflow-automation/SKILL.md +854 -0
  474. package/skills/global_legacy/go-concurrency-patterns/SKILL.md +41 -0
  475. package/skills/global_legacy/go-concurrency-patterns/resources/implementation-playbook.md +654 -0
  476. package/skills/global_legacy/go-playwright/SKILL.md +76 -0
  477. package/skills/global_legacy/go-playwright/resources/implementation-playbook.md +110 -0
  478. package/skills/global_legacy/golang-pro/SKILL.md +181 -0
  479. package/skills/global_legacy/google-sheets-automation/SKILL.md +149 -0
  480. package/skills/global_legacy/landing-page-generator/SKILL.md +213 -0
  481. package/skills/global_legacy/landing-page-generator/references/conversion-patterns.md +176 -0
  482. package/skills/global_legacy/landing-page-generator/references/frameworks.md +177 -0
  483. package/skills/global_legacy/landing-page-generator/references/landing-page-patterns.md +98 -0
  484. package/skills/global_legacy/landing-page-generator/references/seo-checklist.md +109 -0
  485. package/skills/global_legacy/landing-page-generator/scripts/landing_page_scaffolder.py +568 -0
  486. package/skills/global_legacy/linear-claude-skill/SKILL.md +523 -0
  487. package/skills/global_legacy/llm-app-patterns/SKILL.md +768 -0
  488. package/skills/global_legacy/llm-application-dev-ai-assistant/SKILL.md +43 -0
  489. package/skills/global_legacy/llm-application-dev-ai-assistant/resources/implementation-playbook.md +1236 -0
  490. package/skills/global_legacy/llm-prompt-optimizer/SKILL.md +187 -0
  491. package/skills/global_legacy/llm-structured-output/SKILL.md +212 -0
  492. package/skills/global_legacy/local-llm-expert/SKILL.md +88 -0
  493. package/skills/global_legacy/microservices-patterns/SKILL.md +43 -0
  494. package/skills/global_legacy/microservices-patterns/resources/implementation-playbook.md +607 -0
  495. package/skills/global_legacy/modern-javascript-patterns/SKILL.md +43 -0
  496. package/skills/global_legacy/modern-javascript-patterns/resources/implementation-playbook.md +910 -0
  497. package/skills/global_legacy/monorepo-management/SKILL.md +43 -0
  498. package/skills/global_legacy/monorepo-management/resources/implementation-playbook.md +621 -0
  499. package/skills/global_legacy/n8n-code-javascript/SKILL.md +706 -0
  500. package/skills/global_legacy/n8n-code-python/SKILL.md +755 -0
  501. package/skills/global_legacy/n8n-expression-syntax/SKILL.md +528 -0
  502. package/skills/global_legacy/n8n-mcp-tools-expert/SKILL.md +654 -0
  503. package/skills/global_legacy/n8n-workflow-patterns/SKILL.md +423 -0
  504. package/skills/global_legacy/neon-postgres/SKILL.md +619 -0
  505. package/skills/global_legacy/nextjs-app-router-patterns/SKILL.md +41 -0
  506. package/skills/global_legacy/nextjs-app-router-patterns/resources/implementation-playbook.md +543 -0
  507. package/skills/global_legacy/nextjs-best-practices/SKILL.md +213 -0
  508. package/skills/global_legacy/notion-automation/SKILL.md +224 -0
  509. package/skills/global_legacy/obsidian-markdown/SKILL.md +209 -0
  510. package/skills/global_legacy/obsidian-markdown/references/CALLOUTS.md +58 -0
  511. package/skills/global_legacy/obsidian-markdown/references/EMBEDS.md +63 -0
  512. package/skills/global_legacy/obsidian-markdown/references/PROPERTIES.md +61 -0
  513. package/skills/global_legacy/openapi-spec-generation/SKILL.md +41 -0
  514. package/skills/global_legacy/openapi-spec-generation/resources/implementation-playbook.md +1027 -0
  515. package/skills/global_legacy/os-scripting/SKILL.md +433 -0
  516. package/skills/global_legacy/planning-with-files/SKILL.md +189 -0
  517. package/skills/global_legacy/planning-with-files/examples.md +202 -0
  518. package/skills/global_legacy/planning-with-files/reference.md +218 -0
  519. package/skills/global_legacy/planning-with-files/scripts/check-complete.sh +44 -0
  520. package/skills/global_legacy/planning-with-files/scripts/init-session.sh +120 -0
  521. package/skills/global_legacy/planning-with-files/templates/findings.md +95 -0
  522. package/skills/global_legacy/planning-with-files/templates/progress.md +114 -0
  523. package/skills/global_legacy/planning-with-files/templates/task_plan.md +132 -0
  524. package/skills/global_legacy/playwright-skill/API_REFERENCE.md +653 -0
  525. package/skills/global_legacy/playwright-skill/SKILL.md +469 -0
  526. package/skills/global_legacy/playwright-skill/lib/helpers.js +441 -0
  527. package/skills/global_legacy/playwright-skill/package.json +26 -0
  528. package/skills/global_legacy/playwright-skill/run.js +228 -0
  529. package/skills/global_legacy/posix-shell-pro/SKILL.md +308 -0
  530. package/skills/global_legacy/postgres-best-practices/AGENTS.md +1490 -0
  531. package/skills/global_legacy/postgres-best-practices/README.md +119 -0
  532. package/skills/global_legacy/postgres-best-practices/SKILL.md +63 -0
  533. package/skills/global_legacy/postgres-best-practices/metadata.json +13 -0
  534. package/skills/global_legacy/postgres-best-practices/rules/_contributing.md +171 -0
  535. package/skills/global_legacy/postgres-best-practices/rules/_sections.md +39 -0
  536. package/skills/global_legacy/postgres-best-practices/rules/_template.md +34 -0
  537. package/skills/global_legacy/postgres-best-practices/rules/advanced-full-text-search.md +55 -0
  538. package/skills/global_legacy/postgres-best-practices/rules/advanced-jsonb-indexing.md +49 -0
  539. package/skills/global_legacy/postgres-best-practices/rules/conn-idle-timeout.md +46 -0
  540. package/skills/global_legacy/postgres-best-practices/rules/conn-limits.md +44 -0
  541. package/skills/global_legacy/postgres-best-practices/rules/conn-pooling.md +41 -0
  542. package/skills/global_legacy/postgres-best-practices/rules/conn-prepared-statements.md +46 -0
  543. package/skills/global_legacy/postgres-best-practices/rules/data-batch-inserts.md +54 -0
  544. package/skills/global_legacy/postgres-best-practices/rules/data-n-plus-one.md +53 -0
  545. package/skills/global_legacy/postgres-best-practices/rules/data-pagination.md +50 -0
  546. package/skills/global_legacy/postgres-best-practices/rules/data-upsert.md +50 -0
  547. package/skills/global_legacy/postgres-best-practices/rules/lock-advisory.md +56 -0
  548. package/skills/global_legacy/postgres-best-practices/rules/lock-deadlock-prevention.md +68 -0
  549. package/skills/global_legacy/postgres-best-practices/rules/lock-short-transactions.md +50 -0
  550. package/skills/global_legacy/postgres-best-practices/rules/lock-skip-locked.md +54 -0
  551. package/skills/global_legacy/postgres-best-practices/rules/monitor-explain-analyze.md +45 -0
  552. package/skills/global_legacy/postgres-best-practices/rules/monitor-pg-stat-statements.md +55 -0
  553. package/skills/global_legacy/postgres-best-practices/rules/monitor-vacuum-analyze.md +55 -0
  554. package/skills/global_legacy/postgres-best-practices/rules/query-composite-indexes.md +44 -0
  555. package/skills/global_legacy/postgres-best-practices/rules/query-covering-indexes.md +40 -0
  556. package/skills/global_legacy/postgres-best-practices/rules/query-index-types.md +45 -0
  557. package/skills/global_legacy/postgres-best-practices/rules/query-missing-indexes.md +43 -0
  558. package/skills/global_legacy/postgres-best-practices/rules/query-partial-indexes.md +45 -0
  559. package/skills/global_legacy/postgres-best-practices/rules/schema-data-types.md +46 -0
  560. package/skills/global_legacy/postgres-best-practices/rules/schema-foreign-key-indexes.md +59 -0
  561. package/skills/global_legacy/postgres-best-practices/rules/schema-lowercase-identifiers.md +55 -0
  562. package/skills/global_legacy/postgres-best-practices/rules/schema-partitioning.md +55 -0
  563. package/skills/global_legacy/postgres-best-practices/rules/schema-primary-keys.md +61 -0
  564. package/skills/global_legacy/postgres-best-practices/rules/security-privileges.md +54 -0
  565. package/skills/global_legacy/postgres-best-practices/rules/security-rls-basics.md +50 -0
  566. package/skills/global_legacy/postgres-best-practices/rules/security-rls-performance.md +57 -0
  567. package/skills/global_legacy/postgresql/SKILL.md +233 -0
  568. package/skills/global_legacy/prisma-expert/SKILL.md +366 -0
  569. package/skills/global_legacy/product-manager-toolkit/SKILL.md +362 -0
  570. package/skills/global_legacy/product-manager-toolkit/references/prd_templates.md +317 -0
  571. package/skills/global_legacy/product-manager-toolkit/scripts/customer_interview_analyzer.py +441 -0
  572. package/skills/global_legacy/product-manager-toolkit/scripts/rice_prioritizer.py +296 -0
  573. package/skills/global_legacy/programmatic-seo/SKILL.md +356 -0
  574. package/skills/global_legacy/prompt-engineer/README.md +659 -0
  575. package/skills/global_legacy/prompt-engineer/SKILL.md +281 -0
  576. package/skills/global_legacy/prompt-engineering-patterns/SKILL.md +221 -0
  577. package/skills/global_legacy/prompt-engineering-patterns/assets/few-shot-examples.json +106 -0
  578. package/skills/global_legacy/prompt-engineering-patterns/assets/prompt-template-library.md +246 -0
  579. package/skills/global_legacy/prompt-engineering-patterns/references/chain-of-thought.md +399 -0
  580. package/skills/global_legacy/prompt-engineering-patterns/references/few-shot-learning.md +369 -0
  581. package/skills/global_legacy/prompt-engineering-patterns/references/prompt-optimization.md +414 -0
  582. package/skills/global_legacy/prompt-engineering-patterns/references/prompt-templates.md +470 -0
  583. package/skills/global_legacy/prompt-engineering-patterns/references/system-prompts.md +189 -0
  584. package/skills/global_legacy/prompt-engineering-patterns/scripts/optimize-prompt.py +279 -0
  585. package/skills/global_legacy/python-patterns/SKILL.md +451 -0
  586. package/skills/global_legacy/python-performance-optimization/SKILL.md +44 -0
  587. package/skills/global_legacy/python-performance-optimization/resources/implementation-playbook.md +868 -0
  588. package/skills/global_legacy/python-pro/SKILL.md +161 -0
  589. package/skills/global_legacy/rag-engineer/SKILL.md +341 -0
  590. package/skills/global_legacy/rag-implementation/SKILL.md +201 -0
  591. package/skills/global_legacy/react-best-practices/AGENTS.md +2249 -0
  592. package/skills/global_legacy/react-best-practices/README.md +123 -0
  593. package/skills/global_legacy/react-best-practices/SKILL.md +131 -0
  594. package/skills/global_legacy/react-best-practices/metadata.json +15 -0
  595. package/skills/global_legacy/react-best-practices/rules/_sections.md +46 -0
  596. package/skills/global_legacy/react-best-practices/rules/_template.md +28 -0
  597. package/skills/global_legacy/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  598. package/skills/global_legacy/react-best-practices/rules/advanced-use-latest.md +49 -0
  599. package/skills/global_legacy/react-best-practices/rules/async-api-routes.md +38 -0
  600. package/skills/global_legacy/react-best-practices/rules/async-defer-await.md +80 -0
  601. package/skills/global_legacy/react-best-practices/rules/async-dependencies.md +36 -0
  602. package/skills/global_legacy/react-best-practices/rules/async-parallel.md +28 -0
  603. package/skills/global_legacy/react-best-practices/rules/async-suspense-boundaries.md +99 -0
  604. package/skills/global_legacy/react-best-practices/rules/bundle-barrel-imports.md +59 -0
  605. package/skills/global_legacy/react-best-practices/rules/bundle-conditional.md +31 -0
  606. package/skills/global_legacy/react-best-practices/rules/bundle-defer-third-party.md +49 -0
  607. package/skills/global_legacy/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  608. package/skills/global_legacy/react-best-practices/rules/bundle-preload.md +50 -0
  609. package/skills/global_legacy/react-best-practices/rules/client-event-listeners.md +74 -0
  610. package/skills/global_legacy/react-best-practices/rules/client-swr-dedup.md +56 -0
  611. package/skills/global_legacy/react-best-practices/rules/js-batch-dom-css.md +82 -0
  612. package/skills/global_legacy/react-best-practices/rules/js-cache-function-results.md +80 -0
  613. package/skills/global_legacy/react-best-practices/rules/js-cache-property-access.md +28 -0
  614. package/skills/global_legacy/react-best-practices/rules/js-cache-storage.md +70 -0
  615. package/skills/global_legacy/react-best-practices/rules/js-combine-iterations.md +32 -0
  616. package/skills/global_legacy/react-best-practices/rules/js-early-exit.md +50 -0
  617. package/skills/global_legacy/react-best-practices/rules/js-hoist-regexp.md +45 -0
  618. package/skills/global_legacy/react-best-practices/rules/js-index-maps.md +37 -0
  619. package/skills/global_legacy/react-best-practices/rules/js-length-check-first.md +49 -0
  620. package/skills/global_legacy/react-best-practices/rules/js-min-max-loop.md +82 -0
  621. package/skills/global_legacy/react-best-practices/rules/js-set-map-lookups.md +24 -0
  622. package/skills/global_legacy/react-best-practices/rules/js-tosorted-immutable.md +57 -0
  623. package/skills/global_legacy/react-best-practices/rules/rendering-activity.md +26 -0
  624. package/skills/global_legacy/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  625. package/skills/global_legacy/react-best-practices/rules/rendering-conditional-render.md +40 -0
  626. package/skills/global_legacy/react-best-practices/rules/rendering-content-visibility.md +38 -0
  627. package/skills/global_legacy/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  628. package/skills/global_legacy/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  629. package/skills/global_legacy/react-best-practices/rules/rendering-svg-precision.md +28 -0
  630. package/skills/global_legacy/react-best-practices/rules/rerender-defer-reads.md +39 -0
  631. package/skills/global_legacy/react-best-practices/rules/rerender-dependencies.md +45 -0
  632. package/skills/global_legacy/react-best-practices/rules/rerender-derived-state.md +29 -0
  633. package/skills/global_legacy/react-best-practices/rules/rerender-functional-setstate.md +74 -0
  634. package/skills/global_legacy/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  635. package/skills/global_legacy/react-best-practices/rules/rerender-memo.md +44 -0
  636. package/skills/global_legacy/react-best-practices/rules/rerender-transitions.md +40 -0
  637. package/skills/global_legacy/react-best-practices/rules/server-after-nonblocking.md +73 -0
  638. package/skills/global_legacy/react-best-practices/rules/server-cache-lru.md +41 -0
  639. package/skills/global_legacy/react-best-practices/rules/server-cache-react.md +26 -0
  640. package/skills/global_legacy/react-best-practices/rules/server-parallel-fetching.md +79 -0
  641. package/skills/global_legacy/react-best-practices/rules/server-serialization.md +38 -0
  642. package/skills/global_legacy/react-component-performance/SKILL.md +139 -0
  643. package/skills/global_legacy/react-component-performance/agents/openai.yaml +4 -0
  644. package/skills/global_legacy/react-component-performance/references/examples.md +88 -0
  645. package/skills/global_legacy/react-patterns/SKILL.md +216 -0
  646. package/skills/global_legacy/readme/SKILL.md +848 -0
  647. package/skills/global_legacy/remotion/SKILL.md +404 -0
  648. package/skills/global_legacy/schema-markup/SKILL.md +363 -0
  649. package/skills/global_legacy/senior-frontend/SKILL.md +495 -0
  650. package/skills/global_legacy/senior-frontend/references/frontend_best_practices.md +806 -0
  651. package/skills/global_legacy/senior-frontend/references/nextjs_optimization_guide.md +724 -0
  652. package/skills/global_legacy/senior-frontend/references/react_patterns.md +746 -0
  653. package/skills/global_legacy/senior-frontend/scripts/bundle_analyzer.py +407 -0
  654. package/skills/global_legacy/senior-frontend/scripts/component_generator.py +329 -0
  655. package/skills/global_legacy/senior-frontend/scripts/frontend_scaffolder.py +1005 -0
  656. package/skills/global_legacy/senior-fullstack/SKILL.md +220 -0
  657. package/skills/global_legacy/senior-fullstack/references/architecture_patterns.md +103 -0
  658. package/skills/global_legacy/senior-fullstack/references/development_workflows.md +103 -0
  659. package/skills/global_legacy/senior-fullstack/references/tech_stack_guide.md +103 -0
  660. package/skills/global_legacy/senior-fullstack/scripts/code_quality_analyzer.py +114 -0
  661. package/skills/global_legacy/senior-fullstack/scripts/fullstack_scaffolder.py +114 -0
  662. package/skills/global_legacy/senior-fullstack/scripts/project_scaffolder.py +114 -0
  663. package/skills/global_legacy/seo/SKILL.md +143 -0
  664. package/skills/global_legacy/seo/references/cwv-thresholds.md +108 -0
  665. package/skills/global_legacy/seo/references/eeat-framework.md +214 -0
  666. package/skills/global_legacy/seo/references/quality-gates.md +155 -0
  667. package/skills/global_legacy/seo/references/schema-types.md +118 -0
  668. package/skills/global_legacy/seo-audit/SKILL.md +492 -0
  669. package/skills/global_legacy/seo-technical/SKILL.md +179 -0
  670. package/skills/global_legacy/shadcn/SKILL.md +254 -0
  671. package/skills/global_legacy/shadcn/agents/openai.yml +5 -0
  672. package/skills/global_legacy/shadcn/assets/shadcn-small.png +0 -0
  673. package/skills/global_legacy/shadcn/assets/shadcn.png +0 -0
  674. package/skills/global_legacy/shadcn/cli.md +255 -0
  675. package/skills/global_legacy/shadcn/customization.md +202 -0
  676. package/skills/global_legacy/shadcn/evals/evals.json +47 -0
  677. package/skills/global_legacy/shadcn/mcp.md +94 -0
  678. package/skills/global_legacy/shadcn/rules/base-vs-radix.md +306 -0
  679. package/skills/global_legacy/shadcn/rules/composition.md +195 -0
  680. package/skills/global_legacy/shadcn/rules/forms.md +192 -0
  681. package/skills/global_legacy/shadcn/rules/icons.md +101 -0
  682. package/skills/global_legacy/shadcn/rules/styling.md +162 -0
  683. package/skills/global_legacy/simplify-code/SKILL.md +183 -0
  684. package/skills/global_legacy/slack-automation/SKILL.md +197 -0
  685. package/skills/global_legacy/software-architecture/SKILL.md +86 -0
  686. package/skills/global_legacy/spline-3d-integration/SKILL.md +90 -0
  687. package/skills/global_legacy/spline-3d-integration/examples/interactive-scene.tsx +198 -0
  688. package/skills/global_legacy/spline-3d-integration/examples/react-spline-wrapper.tsx +124 -0
  689. package/skills/global_legacy/spline-3d-integration/examples/vanilla-embed.html +146 -0
  690. package/skills/global_legacy/spline-3d-integration/guides/COMMON_PROBLEMS.md +262 -0
  691. package/skills/global_legacy/spline-3d-integration/guides/PERFORMANCE.md +163 -0
  692. package/skills/global_legacy/spline-3d-integration/guides/REACT_INTEGRATION.md +212 -0
  693. package/skills/global_legacy/spline-3d-integration/guides/VANILLA_INTEGRATION.md +203 -0
  694. package/skills/global_legacy/subagent-driven-development/SKILL.md +247 -0
  695. package/skills/global_legacy/subagent-driven-development/code-quality-reviewer-prompt.md +20 -0
  696. package/skills/global_legacy/subagent-driven-development/implementer-prompt.md +78 -0
  697. package/skills/global_legacy/subagent-driven-development/spec-reviewer-prompt.md +61 -0
  698. package/skills/global_legacy/systematic-debugging/CREATION-LOG.md +119 -0
  699. package/skills/global_legacy/systematic-debugging/SKILL.md +303 -0
  700. package/skills/global_legacy/systematic-debugging/condition-based-waiting-example.ts +158 -0
  701. package/skills/global_legacy/systematic-debugging/condition-based-waiting.md +115 -0
  702. package/skills/global_legacy/systematic-debugging/defense-in-depth.md +122 -0
  703. package/skills/global_legacy/systematic-debugging/find-polluter.sh +63 -0
  704. package/skills/global_legacy/systematic-debugging/root-cause-tracing.md +169 -0
  705. package/skills/global_legacy/systematic-debugging/test-academic.md +14 -0
  706. package/skills/global_legacy/systematic-debugging/test-pressure-1.md +58 -0
  707. package/skills/global_legacy/systematic-debugging/test-pressure-2.md +68 -0
  708. package/skills/global_legacy/systematic-debugging/test-pressure-3.md +69 -0
  709. package/skills/global_legacy/tailwind-patterns/SKILL.md +279 -0
  710. package/skills/global_legacy/tanstack-query-expert/SKILL.md +247 -0
  711. package/skills/global_legacy/tdd-workflow/SKILL.md +159 -0
  712. package/skills/global_legacy/test-driven-development/SKILL.md +378 -0
  713. package/skills/global_legacy/test-driven-development/testing-anti-patterns.md +299 -0
  714. package/skills/global_legacy/threejs-skills/SKILL.md +720 -0
  715. package/skills/global_legacy/tmux/SKILL.md +375 -0
  716. package/skills/global_legacy/turborepo-caching/SKILL.md +427 -0
  717. package/skills/global_legacy/typescript-pro/SKILL.md +58 -0
  718. package/skills/global_legacy/ui-component/SKILL.md +104 -0
  719. package/skills/global_legacy/ui-page/SKILL.md +100 -0
  720. package/skills/global_legacy/ui-pattern/SKILL.md +92 -0
  721. package/skills/global_legacy/ui-review/SKILL.md +90 -0
  722. package/skills/global_legacy/ui-tokens/SKILL.md +73 -0
  723. package/skills/global_legacy/ui-ux-pro-max/SKILL.md +361 -0
  724. package/skills/global_legacy/ui-ux-pro-max/data/charts.csv +26 -0
  725. package/skills/global_legacy/ui-ux-pro-max/data/colors.csv +97 -0
  726. package/skills/global_legacy/ui-ux-pro-max/data/icons.csv +101 -0
  727. package/skills/global_legacy/ui-ux-pro-max/data/landing.csv +31 -0
  728. package/skills/global_legacy/ui-ux-pro-max/data/products.csv +97 -0
  729. package/skills/global_legacy/ui-ux-pro-max/data/prompts.csv +24 -0
  730. package/skills/global_legacy/ui-ux-pro-max/data/react-performance.csv +45 -0
  731. package/skills/global_legacy/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  732. package/skills/global_legacy/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  733. package/skills/global_legacy/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  734. package/skills/global_legacy/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  735. package/skills/global_legacy/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  736. package/skills/global_legacy/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  737. package/skills/global_legacy/ui-ux-pro-max/data/stacks/react.csv +54 -0
  738. package/skills/global_legacy/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  739. package/skills/global_legacy/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  740. package/skills/global_legacy/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  741. package/skills/global_legacy/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  742. package/skills/global_legacy/ui-ux-pro-max/data/styles.csv +59 -0
  743. package/skills/global_legacy/ui-ux-pro-max/data/typography.csv +58 -0
  744. package/skills/global_legacy/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  745. package/skills/global_legacy/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  746. package/skills/global_legacy/ui-ux-pro-max/data/web-interface.csv +31 -0
  747. package/skills/global_legacy/ui-ux-pro-max/scripts/core.py +257 -0
  748. package/skills/global_legacy/ui-ux-pro-max/scripts/design_system.py +487 -0
  749. package/skills/global_legacy/ui-ux-pro-max/scripts/search.py +76 -0
  750. package/skills/global_legacy/using-neon/SKILL.md +90 -0
  751. package/skills/global_legacy/ux-audit/SKILL.md +66 -0
  752. package/skills/global_legacy/ux-feedback/SKILL.md +68 -0
  753. package/skills/global_legacy/ux-flow/SKILL.md +72 -0
  754. package/skills/global_legacy/ux-persuasion-engineer/SKILL.md +119 -0
  755. package/skills/global_legacy/vector-database-engineer/SKILL.md +68 -0
  756. package/skills/global_legacy/vercel-ai-sdk-expert/SKILL.md +227 -0
  757. package/skills/global_legacy/vercel-deployment/SKILL.md +682 -0
  758. package/skills/global_legacy/wcag-audit-patterns/SKILL.md +49 -0
  759. package/skills/global_legacy/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  760. package/skills/global_legacy/web-artifacts-builder/LICENSE.txt +202 -0
  761. package/skills/global_legacy/web-artifacts-builder/SKILL.md +84 -0
  762. package/skills/global_legacy/web-artifacts-builder/scripts/bundle-artifact.sh +54 -0
  763. package/skills/global_legacy/web-artifacts-builder/scripts/init-artifact.sh +322 -0
  764. package/skills/global_legacy/web-artifacts-builder/scripts/shadcn-components.tar.gz +0 -0
  765. package/skills/global_legacy/web-performance-optimization/SKILL.md +654 -0
  766. package/skills/global_legacy/web-scraper/SKILL.md +757 -0
  767. package/skills/global_legacy/web-scraper/references/data-transforms.md +397 -0
  768. package/skills/global_legacy/web-scraper/references/extraction-patterns.md +475 -0
  769. package/skills/global_legacy/web-scraper/references/output-templates.md +481 -0
  770. package/skills/global_legacy/webapp-testing/LICENSE.txt +202 -0
  771. package/skills/global_legacy/webapp-testing/SKILL.md +106 -0
  772. package/skills/global_legacy/webapp-testing/scripts/with_server.py +106 -0
  773. package/skills/global_legacy/writing-plans/SKILL.md +127 -0
  774. package/skills/global_legacy/zustand-store-ts/SKILL.md +79 -0
  775. package/skills/workspace_agents/firecrawl/SKILL.md +148 -0
  776. package/skills/workspace_agents/firecrawl/rules/install.md +82 -0
  777. package/skills/workspace_agents/firecrawl/rules/security.md +26 -0
  778. package/skills/workspace_agents/firecrawl-agent/SKILL.md +57 -0
  779. package/skills/workspace_agents/firecrawl-build/SKILL.md +38 -0
  780. package/skills/workspace_agents/firecrawl-build-interact/SKILL.md +67 -0
  781. package/skills/workspace_agents/firecrawl-build-onboarding/SKILL.md +102 -0
  782. package/skills/workspace_agents/firecrawl-build-onboarding/references/auth-flow.md +39 -0
  783. package/skills/workspace_agents/firecrawl-build-onboarding/references/project-setup.md +20 -0
  784. package/skills/workspace_agents/firecrawl-build-onboarding/references/sdk-installation.md +17 -0
  785. package/skills/workspace_agents/firecrawl-build-scrape/SKILL.md +68 -0
  786. package/skills/workspace_agents/firecrawl-build-search/SKILL.md +68 -0
  787. package/skills/workspace_agents/firecrawl-crawl/SKILL.md +58 -0
  788. package/skills/workspace_agents/firecrawl-download/SKILL.md +69 -0
  789. package/skills/workspace_agents/firecrawl-interact/SKILL.md +83 -0
  790. package/skills/workspace_agents/firecrawl-map/SKILL.md +50 -0
  791. package/skills/workspace_agents/firecrawl-scrape/SKILL.md +68 -0
  792. package/skills/workspace_agents/firecrawl-search/SKILL.md +59 -0
@@ -0,0 +1,109 @@
1
+ # Landing Page SEO Checklist
2
+
3
+ ## Overview
4
+
5
+ This checklist ensures landing pages are optimized for search engine visibility while maintaining conversion focus. Apply these checks before launching any landing page.
6
+
7
+ ## Meta Tags
8
+
9
+ - [ ] **Title tag**: Under 60 characters, includes primary keyword, ends with brand name
10
+ - [ ] **Meta description**: 150-160 characters, includes CTA language, unique per page
11
+ - [ ] **Canonical URL**: Set to prevent duplicate content issues
12
+ - [ ] **Robots meta**: Ensure page is indexable (`index, follow`) unless intentionally noindex
13
+ - [ ] **Open Graph tags**: og:title, og:description, og:image, og:url for social sharing
14
+ - [ ] **Twitter Card tags**: twitter:card, twitter:title, twitter:description, twitter:image
15
+ - [ ] **Viewport meta**: `<meta name="viewport" content="width=device-width, initial-scale=1">`
16
+
17
+ ## Structured Data
18
+
19
+ - [ ] **Organization schema**: Company name, logo, social profiles
20
+ - [ ] **Product schema**: Name, description, price, availability (for product pages)
21
+ - [ ] **FAQ schema**: For pages with FAQ sections (rich snippet opportunity)
22
+ - [ ] **Breadcrumb schema**: Navigation path for deep pages
23
+ - [ ] **Review schema**: Aggregate rating if testimonials present (use carefully per guidelines)
24
+ - [ ] **Validate**: Test all structured data with Google Rich Results Test
25
+
26
+ ## Core Web Vitals Targets
27
+
28
+ ### Largest Contentful Paint (LCP) - Target: < 2.5s
29
+ - [ ] Optimize hero image (WebP format, proper dimensions)
30
+ - [ ] Preload critical resources (`<link rel="preload">`)
31
+ - [ ] Use CDN for static assets
32
+ - [ ] Minimize render-blocking CSS and JavaScript
33
+
34
+ ### First Input Delay (FID) / Interaction to Next Paint (INP) - Target: < 200ms
35
+ - [ ] Defer non-critical JavaScript
36
+ - [ ] Break up long tasks (>50ms)
37
+ - [ ] Minimize third-party script impact
38
+ - [ ] Use `requestAnimationFrame` for visual updates
39
+
40
+ ### Cumulative Layout Shift (CLS) - Target: < 0.1
41
+ - [ ] Set explicit width/height on images and videos
42
+ - [ ] Reserve space for dynamic content (ads, embeds)
43
+ - [ ] Use `font-display: swap` for web fonts
44
+ - [ ] Avoid inserting content above existing content
45
+
46
+ ## Keyword Placement
47
+
48
+ - [ ] **H1 tag**: Contains primary keyword, one per page only
49
+ - [ ] **H2 tags**: Include secondary keywords naturally
50
+ - [ ] **First paragraph**: Primary keyword appears in first 100 words
51
+ - [ ] **Body copy**: Natural keyword density (1-2%), no stuffing
52
+ - [ ] **Image alt text**: Descriptive, includes keyword where relevant
53
+ - [ ] **URL slug**: Short, keyword-rich, hyphen-separated
54
+ - [ ] **CTA text**: Consider keyword inclusion where natural
55
+
56
+ ## Internal Linking
57
+
58
+ - [ ] Link to relevant product/feature pages
59
+ - [ ] Link to blog content that supports the page topic
60
+ - [ ] Use descriptive anchor text (not "click here")
61
+ - [ ] Ensure landing page is linked from main navigation or sitemap
62
+ - [ ] Link to pricing page if applicable
63
+ - [ ] Limit links to avoid diluting page authority (15-20 max)
64
+
65
+ ## Image Optimization
66
+
67
+ - [ ] **Format**: Use WebP with JPEG/PNG fallback
68
+ - [ ] **Compression**: Lossy compression for photos, lossless for graphics
69
+ - [ ] **Dimensions**: Serve at exact display size (no CSS resizing)
70
+ - [ ] **Alt text**: Descriptive, 125 characters max, natural keyword inclusion
71
+ - [ ] **File names**: Descriptive, hyphenated (e.g., `product-dashboard-screenshot.webp`)
72
+ - [ ] **Lazy loading**: Apply to images below the fold (`loading="lazy"`)
73
+ - [ ] **Responsive images**: Use `srcset` for different viewport sizes
74
+
75
+ ## Canonical URLs
76
+
77
+ - [ ] Self-referencing canonical on every page
78
+ - [ ] Consistent protocol (https) and trailing slash usage
79
+ - [ ] Canonical points to preferred URL version (www vs non-www)
80
+ - [ ] UTM parameters excluded from canonical URL
81
+ - [ ] Pagination handled with rel="next"/"prev" or single-page canonical
82
+
83
+ ## Mobile Responsiveness
84
+
85
+ - [ ] **Mobile-friendly test**: Pass Google Mobile-Friendly Test
86
+ - [ ] **Touch targets**: Minimum 44x44px, 8px spacing between targets
87
+ - [ ] **Font size**: Minimum 16px base font, no pinch-to-zoom needed
88
+ - [ ] **Content parity**: All critical content accessible on mobile
89
+ - [ ] **Horizontal scroll**: None present at any viewport width
90
+ - [ ] **Form usability**: Appropriate input types (email, tel), autocomplete attributes
91
+ - [ ] **Media queries**: Breakpoints at 480px, 768px, 1024px, 1200px minimum
92
+
93
+ ## Technical SEO
94
+
95
+ - [ ] **HTTPS**: SSL certificate valid and active
96
+ - [ ] **Page speed**: < 3s load time on mobile (test with PageSpeed Insights)
97
+ - [ ] **XML sitemap**: Page included in sitemap.xml
98
+ - [ ] **Robots.txt**: Page not blocked by robots.txt
99
+ - [ ] **404 handling**: Custom 404 page with navigation
100
+ - [ ] **Redirect chains**: No more than 1 redirect hop
101
+ - [ ] **Hreflang**: Set for multi-language landing pages
102
+
103
+ ## Content Quality Signals
104
+
105
+ - [ ] **Unique content**: No duplicate content from other pages
106
+ - [ ] **Content depth**: Sufficient content for topic coverage (500+ words for SEO pages)
107
+ - [ ] **Readability**: Grade level 6-8 for broad audiences
108
+ - [ ] **Freshness**: Last modified date reflects recent updates
109
+ - [ ] **E-E-A-T signals**: Author expertise, company authority, trust indicators
@@ -0,0 +1,568 @@
1
+ #!/usr/bin/env python3
2
+ """Landing Page Scaffolder — Generate landing pages as HTML or Next.js TSX from config.
3
+
4
+ Creates production-ready landing pages with hero sections, features,
5
+ testimonials, pricing, CTAs, and responsive design.
6
+
7
+ Usage:
8
+ python landing_page_scaffolder.py config.json --format html --output page.html
9
+ python landing_page_scaffolder.py config.json --format tsx --output LandingPage.tsx
10
+ python landing_page_scaffolder.py config.json --format json
11
+ """
12
+
13
+ import argparse
14
+ import json
15
+ import sys
16
+ from typing import Dict, List, Any, Optional
17
+ from datetime import datetime
18
+ import html as html_module
19
+
20
+
21
+ def escape(text: str) -> str:
22
+ """HTML-escape text."""
23
+ return html_module.escape(str(text))
24
+
25
+
26
+ # ---------------------------------------------------------------------------
27
+ # Tailwind style mappings for TSX output
28
+ # ---------------------------------------------------------------------------
29
+
30
+ DESIGN_STYLES = {
31
+ "dark-saas": {
32
+ "bg": "bg-gray-950", "text": "text-white",
33
+ "accent": "violet", "card_bg": "bg-gray-900 border border-gray-800",
34
+ "btn": "bg-violet-600 hover:bg-violet-500 text-white",
35
+ "btn_secondary": "border border-gray-700 text-gray-300 hover:bg-gray-800",
36
+ "section_alt": "bg-gray-900/50", "muted": "text-gray-400",
37
+ "border": "border-gray-800",
38
+ },
39
+ "clean-minimal": {
40
+ "bg": "bg-white", "text": "text-gray-900",
41
+ "accent": "blue", "card_bg": "bg-gray-50 border border-gray-200 rounded-2xl",
42
+ "btn": "bg-blue-600 hover:bg-blue-700 text-white",
43
+ "btn_secondary": "border border-gray-300 text-gray-700 hover:bg-gray-50",
44
+ "section_alt": "bg-gray-50", "muted": "text-gray-500",
45
+ "border": "border-gray-200",
46
+ },
47
+ "bold-startup": {
48
+ "bg": "bg-white", "text": "text-gray-900",
49
+ "accent": "orange", "card_bg": "shadow-xl rounded-3xl bg-white",
50
+ "btn": "bg-orange-500 hover:bg-orange-600 text-white",
51
+ "btn_secondary": "border-2 border-orange-500 text-orange-600 hover:bg-orange-50",
52
+ "section_alt": "bg-orange-50/30", "muted": "text-gray-500",
53
+ "border": "border-gray-200",
54
+ },
55
+ "enterprise": {
56
+ "bg": "bg-slate-50", "text": "text-slate-900",
57
+ "accent": "slate", "card_bg": "bg-white border border-slate-200 shadow-sm",
58
+ "btn": "bg-slate-900 hover:bg-slate-800 text-white",
59
+ "btn_secondary": "border border-slate-300 text-slate-700 hover:bg-slate-100",
60
+ "section_alt": "bg-white", "muted": "text-slate-500",
61
+ "border": "border-slate-200",
62
+ },
63
+ }
64
+
65
+
66
+ # ---------------------------------------------------------------------------
67
+ # TSX generators
68
+ # ---------------------------------------------------------------------------
69
+
70
+ def tsx_nav(config: Dict[str, Any], style: Dict[str, str]) -> str:
71
+ brand = config.get("brand", "Brand")
72
+ nav_links = config.get("nav_links", [])
73
+ cta = config.get("nav_cta", {"text": "Get Started", "url": "#"})
74
+ links_jsx = "\n ".join(
75
+ f'<a href="{l.get("url", "#")}" className="{style["muted"]} hover:{style["text"]} font-medium transition-colors">{l.get("text", "")}</a>'
76
+ for l in nav_links
77
+ )
78
+ return f'''function Navbar() {{
79
+ return (
80
+ <nav className="sticky top-0 z-50 {style["bg"]} border-b {style["border"]} backdrop-blur-sm">
81
+ <div className="mx-auto flex max-w-7xl items-center justify-between px-6 py-4">
82
+ <a href="#" className="text-xl font-bold {style["text"]}">{brand}</a>
83
+ <div className="hidden items-center gap-8 md:flex">
84
+ {links_jsx}
85
+ <a href="{cta.get("url", "#")}" className="rounded-lg {style["btn"]} px-5 py-2.5 text-sm font-semibold transition-colors">
86
+ {cta.get("text", "Get Started")}
87
+ </a>
88
+ </div>
89
+ </div>
90
+ </nav>
91
+ );
92
+ }}'''
93
+
94
+
95
+ def tsx_hero(hero: Dict[str, Any], style: Dict[str, str]) -> str:
96
+ h1 = hero.get("headline", "Your Headline Here")
97
+ sub = hero.get("subheadline", "")
98
+ primary_cta = hero.get("primary_cta", {"text": "Get Started", "url": "#"})
99
+ secondary_cta = hero.get("secondary_cta", None)
100
+ secondary_jsx = ""
101
+ if secondary_cta:
102
+ secondary_jsx = f'''
103
+ <a href="{secondary_cta.get("url", "#")}" className="rounded-lg {style["btn_secondary"]} px-8 py-3 text-lg font-semibold transition-colors">
104
+ {secondary_cta.get("text", "Learn More")}
105
+ </a>'''
106
+ return f'''function Hero() {{
107
+ return (
108
+ <section className="flex min-h-[80vh] flex-col items-center justify-center px-6 py-24 text-center {style["bg"]}">
109
+ <div className="mx-auto max-w-4xl">
110
+ <h1 className="mb-6 text-5xl font-bold tracking-tight {style["text"]} md:text-7xl">
111
+ {h1}
112
+ </h1>
113
+ <p className="mx-auto mb-10 max-w-2xl text-xl {style["muted"]}">
114
+ {sub}
115
+ </p>
116
+ <div className="flex flex-col items-center gap-4 sm:flex-row sm:justify-center">
117
+ <a href="{primary_cta.get("url", "#")}" className="rounded-lg {style["btn"]} px-8 py-3 text-lg font-semibold transition-colors">
118
+ {primary_cta.get("text", "Get Started")}
119
+ </a>{secondary_jsx}
120
+ </div>
121
+ </div>
122
+ </section>
123
+ );
124
+ }}'''
125
+
126
+
127
+ def tsx_features(features: Dict[str, Any], style: Dict[str, str]) -> str:
128
+ title = features.get("title", "Features")
129
+ subtitle = features.get("subtitle", "")
130
+ items = features.get("items", [])
131
+ cards_jsx = "\n ".join(
132
+ f'''<div className="{style["card_bg"]} rounded-xl p-8">
133
+ <div className="mb-4 text-3xl">{f.get("icon", "")}</div>
134
+ <h3 className="mb-3 text-xl font-semibold {style["text"]}">{f.get("title", "")}</h3>
135
+ <p className="{style["muted"]}">{f.get("description", "")}</p>
136
+ </div>'''
137
+ for f in items
138
+ )
139
+ return f'''function Features() {{
140
+ return (
141
+ <section className="{style["section_alt"]} px-6 py-24">
142
+ <div className="mx-auto max-w-7xl">
143
+ <h2 className="mb-4 text-center text-4xl font-bold {style["text"]}">{title}</h2>
144
+ <p className="mx-auto mb-16 max-w-2xl text-center text-lg {style["muted"]}">{subtitle}</p>
145
+ <div className="grid gap-8 md:grid-cols-2 lg:grid-cols-3">
146
+ {cards_jsx}
147
+ </div>
148
+ </div>
149
+ </section>
150
+ );
151
+ }}'''
152
+
153
+
154
+ def tsx_testimonials(testimonials: Dict[str, Any], style: Dict[str, str]) -> str:
155
+ title = testimonials.get("title", "What Our Customers Say")
156
+ items = testimonials.get("items", [])
157
+ if not items:
158
+ return ""
159
+ cards_jsx = "\n ".join(
160
+ f'''<div className="rounded-xl border {style["border"]} p-8">
161
+ <p className="mb-6 text-lg italic {style["muted"]}">"{t.get("quote", "")}"</p>
162
+ <div>
163
+ <p className="font-semibold {style["text"]}">{t.get("name", "")}</p>
164
+ <p className="text-sm {style["muted"]}">{t.get("title", "")}, {t.get("company", "")}</p>
165
+ </div>
166
+ </div>'''
167
+ for t in items
168
+ )
169
+ return f'''function Testimonials() {{
170
+ return (
171
+ <section className="px-6 py-24 {style["bg"]}">
172
+ <div className="mx-auto max-w-7xl">
173
+ <h2 className="mb-16 text-center text-4xl font-bold {style["text"]}">{title}</h2>
174
+ <div className="grid gap-8 md:grid-cols-2 lg:grid-cols-3">
175
+ {cards_jsx}
176
+ </div>
177
+ </div>
178
+ </section>
179
+ );
180
+ }}'''
181
+
182
+
183
+ def tsx_pricing(pricing: Dict[str, Any], style: Dict[str, str]) -> str:
184
+ title = pricing.get("title", "Pricing")
185
+ plans = pricing.get("plans", [])
186
+ if not plans:
187
+ return ""
188
+ accent = style["accent"]
189
+ cards = []
190
+ for p in plans:
191
+ featured = p.get("featured", False)
192
+ border_cls = f"border-2 border-{accent}-500 ring-4 ring-{accent}-500/20" if featured else f"border {style['border']}"
193
+ badge = f'\n <div className="absolute -top-3 left-1/2 -translate-x-1/2 rounded-full bg-{accent}-600 px-4 py-1 text-xs font-semibold text-white">Most Popular</div>' if featured else ""
194
+ features_jsx = "\n ".join(
195
+ f'<li className="flex items-center gap-2 py-2"><span className="text-{accent}-500 font-bold">&#10003;</span> {feat}</li>'
196
+ for feat in p.get("features", [])
197
+ )
198
+ cards.append(f'''<div className="relative rounded-2xl {border_cls} {style["card_bg"]} p-8 text-center">{badge}
199
+ <h3 className="mb-2 text-xl font-semibold {style["text"]}">{p.get("name", "")}</h3>
200
+ <div className="my-6 text-5xl font-extrabold {style["text"]}">${p.get("price", "0")}<span className="text-base font-normal {style["muted"]}">/mo</span></div>
201
+ <p className="{style["muted"]} mb-6">{p.get("description", "")}</p>
202
+ <ul className="mb-8 space-y-1 text-left {style["muted"]}">
203
+ {features_jsx}
204
+ </ul>
205
+ <a href="{p.get("cta_url", "#")}" className="block w-full rounded-lg {style["btn"]} py-3 text-center font-semibold transition-colors">
206
+ {p.get("cta_text", "Choose Plan")}
207
+ </a>
208
+ </div>''')
209
+ cards_jsx = "\n ".join(cards)
210
+ return f'''function Pricing() {{
211
+ return (
212
+ <section className="{style["section_alt"]} px-6 py-24">
213
+ <div className="mx-auto max-w-5xl">
214
+ <h2 className="mb-16 text-center text-4xl font-bold {style["text"]}">{title}</h2>
215
+ <div className="grid gap-8 lg:grid-cols-{min(len(plans), 3)}">
216
+ {cards_jsx}
217
+ </div>
218
+ </div>
219
+ </section>
220
+ );
221
+ }}'''
222
+
223
+
224
+ def tsx_cta(cta: Dict[str, Any], style: Dict[str, str]) -> str:
225
+ accent = style["accent"]
226
+ return f'''function CTASection() {{
227
+ return (
228
+ <section className="bg-{accent}-600 px-6 py-24 text-center text-white">
229
+ <div className="mx-auto max-w-3xl">
230
+ <h2 className="mb-4 text-4xl font-bold">{cta.get("headline", "Ready to get started?")}</h2>
231
+ <p className="mb-10 text-xl opacity-90">{cta.get("subheadline", "")}</p>
232
+ <a href="{cta.get("url", "#")}" className="rounded-lg bg-white px-8 py-3 text-lg font-semibold text-{accent}-600 transition-colors hover:bg-gray-100">
233
+ {cta.get("text", "Start Free Trial")}
234
+ </a>
235
+ </div>
236
+ </section>
237
+ );
238
+ }}'''
239
+
240
+
241
+ def tsx_footer(config: Dict[str, Any], style: Dict[str, str]) -> str:
242
+ brand = config.get("brand", "Company")
243
+ year = datetime.now().year
244
+ footer_text = config.get("footer_text", f"{year} {brand}. All rights reserved.")
245
+ return f'''function Footer() {{
246
+ return (
247
+ <footer className="border-t {style["border"]} {style["bg"]} px-6 py-10 text-center {style["muted"]}">
248
+ <p>&copy; {footer_text}</p>
249
+ </footer>
250
+ );
251
+ }}'''
252
+
253
+
254
+ def generate_tsx(config: Dict[str, Any]) -> str:
255
+ """Generate complete Next.js/React TSX landing page with Tailwind CSS."""
256
+ style_name = config.get("design_style", "clean-minimal")
257
+ style = DESIGN_STYLES.get(style_name, DESIGN_STYLES["clean-minimal"])
258
+
259
+ components = []
260
+ component_names = []
261
+
262
+ components.append(tsx_nav(config, style))
263
+ component_names.append("Navbar")
264
+
265
+ if config.get("hero"):
266
+ components.append(tsx_hero(config["hero"], style))
267
+ component_names.append("Hero")
268
+
269
+ if config.get("features"):
270
+ components.append(tsx_features(config["features"], style))
271
+ component_names.append("Features")
272
+
273
+ if config.get("testimonials") and config["testimonials"].get("items"):
274
+ components.append(tsx_testimonials(config["testimonials"], style))
275
+ component_names.append("Testimonials")
276
+
277
+ if config.get("pricing") and config["pricing"].get("plans"):
278
+ components.append(tsx_pricing(config["pricing"], style))
279
+ component_names.append("Pricing")
280
+
281
+ if config.get("cta"):
282
+ components.append(tsx_cta(config["cta"], style))
283
+ component_names.append("CTASection")
284
+
285
+ components.append(tsx_footer(config, style))
286
+ component_names.append("Footer")
287
+
288
+ title = config.get("title", "Landing Page")
289
+ meta_desc = config.get("meta_description", "")
290
+
291
+ page_body = "\n ".join(f"<{name} />" for name in component_names)
292
+ all_components = "\n\n".join(components)
293
+
294
+ return f'''// Generated by Landing Page Scaffolder — {datetime.now().strftime("%Y-%m-%d")}
295
+ // Stack: Next.js 14+ App Router, React, Tailwind CSS
296
+ // Design style: {style_name}
297
+
298
+ import type {{ Metadata }} from "next";
299
+
300
+ export const metadata: Metadata = {{
301
+ title: "{title}",
302
+ description: "{meta_desc}",
303
+ openGraph: {{
304
+ title: "{title}",
305
+ description: "{meta_desc}",
306
+ type: "website",
307
+ }},
308
+ }};
309
+
310
+ {all_components}
311
+
312
+ export default function LandingPage() {{
313
+ return (
314
+ <main>
315
+ {page_body}
316
+ </main>
317
+ );
318
+ }}
319
+ '''
320
+
321
+
322
+ # ---------------------------------------------------------------------------
323
+ # HTML generators (existing)
324
+ # ---------------------------------------------------------------------------
325
+
326
+ def generate_css(config: Dict[str, Any]) -> str:
327
+ """Generate responsive CSS from config theme."""
328
+ theme = config.get("theme", {})
329
+ primary = theme.get("primary_color", "#2563eb")
330
+ secondary = theme.get("secondary_color", "#1e40af")
331
+ bg = theme.get("background", "#ffffff")
332
+ text_color = theme.get("text_color", "#1f2937")
333
+ font = theme.get("font", "Inter, system-ui, -apple-system, sans-serif")
334
+
335
+ return f"""
336
+ * {{ margin: 0; padding: 0; box-sizing: border-box; }}
337
+ body {{ font-family: {font}; color: {text_color}; background: {bg}; line-height: 1.6; }}
338
+ .container {{ max-width: 1200px; margin: 0 auto; padding: 0 24px; }}
339
+ nav {{ padding: 16px 0; border-bottom: 1px solid #e5e7eb; position: sticky; top: 0; background: {bg}; z-index: 100; }}
340
+ nav .container {{ display: flex; justify-content: space-between; align-items: center; }}
341
+ .nav-logo {{ font-size: 1.5rem; font-weight: 700; color: {primary}; text-decoration: none; }}
342
+ .nav-links {{ display: flex; gap: 24px; list-style: none; }}
343
+ .nav-links a {{ text-decoration: none; color: {text_color}; font-weight: 500; }}
344
+ .nav-cta {{ background: {primary}; color: white; padding: 8px 20px; border-radius: 6px; text-decoration: none; font-weight: 600; }}
345
+ .hero {{ padding: 80px 0; text-align: center; }}
346
+ .hero h1 {{ font-size: 3.5rem; font-weight: 800; line-height: 1.1; margin-bottom: 24px; max-width: 800px; margin-left: auto; margin-right: auto; }}
347
+ .hero p {{ font-size: 1.25rem; color: #6b7280; max-width: 600px; margin: 0 auto 32px; }}
348
+ .hero-cta {{ display: inline-flex; gap: 16px; }}
349
+ .btn-primary {{ background: {primary}; color: white; padding: 14px 32px; border-radius: 8px; text-decoration: none; font-weight: 600; font-size: 1.1rem; }}
350
+ .btn-secondary {{ background: transparent; color: {primary}; padding: 14px 32px; border-radius: 8px; text-decoration: none; font-weight: 600; font-size: 1.1rem; border: 2px solid {primary}; }}
351
+ .features {{ padding: 80px 0; background: #f9fafb; }}
352
+ .section-title {{ text-align: center; font-size: 2.5rem; font-weight: 700; margin-bottom: 16px; }}
353
+ .section-subtitle {{ text-align: center; color: #6b7280; font-size: 1.1rem; margin-bottom: 48px; max-width: 600px; margin-left: auto; margin-right: auto; }}
354
+ .features-grid {{ display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: 32px; }}
355
+ .feature-card {{ background: white; padding: 32px; border-radius: 12px; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }}
356
+ .feature-icon {{ font-size: 2rem; margin-bottom: 16px; }}
357
+ .feature-card h3 {{ font-size: 1.25rem; margin-bottom: 12px; }}
358
+ .feature-card p {{ color: #6b7280; }}
359
+ .testimonials {{ padding: 80px 0; }}
360
+ .testimonials-grid {{ display: grid; grid-template-columns: repeat(auto-fit, minmax(350px, 1fr)); gap: 24px; }}
361
+ .testimonial-card {{ padding: 32px; border: 1px solid #e5e7eb; border-radius: 12px; }}
362
+ .testimonial-text {{ font-size: 1.1rem; font-style: italic; margin-bottom: 20px; }}
363
+ .testimonial-author {{ display: flex; align-items: center; gap: 12px; }}
364
+ .author-info strong {{ display: block; }}
365
+ .author-info span {{ color: #6b7280; font-size: 0.9rem; }}
366
+ .pricing {{ padding: 80px 0; background: #f9fafb; }}
367
+ .pricing-grid {{ display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: 24px; max-width: 900px; margin: 0 auto; }}
368
+ .pricing-card {{ background: white; padding: 32px; border-radius: 12px; border: 2px solid #e5e7eb; text-align: center; }}
369
+ .pricing-card.featured {{ border-color: {primary}; position: relative; }}
370
+ .pricing-card.featured::before {{ content: "Most Popular"; position: absolute; top: -12px; left: 50%; transform: translateX(-50%); background: {primary}; color: white; padding: 4px 16px; border-radius: 20px; font-size: 0.8rem; font-weight: 600; }}
371
+ .pricing-name {{ font-size: 1.25rem; font-weight: 600; margin-bottom: 8px; }}
372
+ .pricing-price {{ font-size: 3rem; font-weight: 800; margin: 16px 0; }}
373
+ .pricing-price span {{ font-size: 1rem; font-weight: 400; color: #6b7280; }}
374
+ .pricing-features {{ list-style: none; text-align: left; margin: 24px 0; }}
375
+ .pricing-features li {{ padding: 8px 0; border-bottom: 1px solid #f3f4f6; }}
376
+ .pricing-features li::before {{ content: "\\2713 "; color: {primary}; font-weight: 700; }}
377
+ .cta-section {{ padding: 80px 0; text-align: center; background: {primary}; color: white; }}
378
+ .cta-section h2 {{ font-size: 2.5rem; margin-bottom: 16px; }}
379
+ .cta-section p {{ font-size: 1.1rem; opacity: 0.9; margin-bottom: 32px; }}
380
+ .btn-white {{ background: white; color: {primary}; padding: 14px 32px; border-radius: 8px; text-decoration: none; font-weight: 600; font-size: 1.1rem; }}
381
+ footer {{ padding: 40px 0; border-top: 1px solid #e5e7eb; color: #6b7280; text-align: center; }}
382
+ @media (max-width: 768px) {{
383
+ .hero h1 {{ font-size: 2.25rem; }}
384
+ .hero-cta {{ flex-direction: column; align-items: center; }}
385
+ .nav-links {{ display: none; }}
386
+ .features-grid {{ grid-template-columns: 1fr; }}
387
+ .pricing-grid {{ grid-template-columns: 1fr; }}
388
+ }}
389
+ """
390
+
391
+
392
+ def render_nav(config: Dict[str, Any]) -> str:
393
+ brand = escape(config.get("brand", "Brand"))
394
+ nav_links = config.get("nav_links", [])
395
+ cta = config.get("nav_cta", {"text": "Get Started", "url": "#"})
396
+ links = "\n".join(
397
+ f'<li><a href="{escape(l.get("url", "#"))}">{escape(l.get("text", ""))}</a></li>'
398
+ for l in nav_links
399
+ )
400
+ return f"""
401
+ <nav><div class="container">
402
+ <a href="#" class="nav-logo">{brand}</a>
403
+ <ul class="nav-links">{links}</ul>
404
+ <a href="{escape(cta.get('url', '#'))}" class="nav-cta">{escape(cta.get('text', 'Get Started'))}</a>
405
+ </div></nav>"""
406
+
407
+
408
+ def render_hero(hero: Dict[str, Any]) -> str:
409
+ h1 = escape(hero.get("headline", "Your Headline Here"))
410
+ sub = escape(hero.get("subheadline", ""))
411
+ primary_cta = hero.get("primary_cta", {"text": "Get Started", "url": "#"})
412
+ secondary_cta = hero.get("secondary_cta", None)
413
+ cta_html = f'<a href="{escape(primary_cta.get("url", "#"))}" class="btn-primary">{escape(primary_cta.get("text", "Get Started"))}</a>'
414
+ if secondary_cta:
415
+ cta_html += f'\n<a href="{escape(secondary_cta.get("url", "#"))}" class="btn-secondary">{escape(secondary_cta.get("text", "Learn More"))}</a>'
416
+ return f"""
417
+ <section class="hero"><div class="container">
418
+ <h1>{h1}</h1>
419
+ <p>{sub}</p>
420
+ <div class="hero-cta">{cta_html}</div>
421
+ </div></section>"""
422
+
423
+
424
+ def render_features(features: Dict[str, Any]) -> str:
425
+ title = escape(features.get("title", "Features"))
426
+ subtitle = escape(features.get("subtitle", ""))
427
+ items = features.get("items", [])
428
+ cards = "\n".join(f"""
429
+ <div class="feature-card">
430
+ <div class="feature-icon">{escape(f.get('icon', ''))}</div>
431
+ <h3>{escape(f.get('title', ''))}</h3>
432
+ <p>{escape(f.get('description', ''))}</p>
433
+ </div>""" for f in items)
434
+ return f"""
435
+ <section class="features"><div class="container">
436
+ <h2 class="section-title">{title}</h2>
437
+ <p class="section-subtitle">{subtitle}</p>
438
+ <div class="features-grid">{cards}</div>
439
+ </div></section>"""
440
+
441
+
442
+ def render_testimonials(testimonials: Dict[str, Any]) -> str:
443
+ title = escape(testimonials.get("title", "What Our Customers Say"))
444
+ items = testimonials.get("items", [])
445
+ if not items:
446
+ return ""
447
+ cards = "\n".join(f"""
448
+ <div class="testimonial-card">
449
+ <p class="testimonial-text">"{escape(t.get('quote', ''))}"</p>
450
+ <div class="testimonial-author">
451
+ <div class="author-info">
452
+ <strong>{escape(t.get('name', ''))}</strong>
453
+ <span>{escape(t.get('title', ''))}, {escape(t.get('company', ''))}</span>
454
+ </div>
455
+ </div>
456
+ </div>""" for t in items)
457
+ return f"""
458
+ <section class="testimonials"><div class="container">
459
+ <h2 class="section-title">{title}</h2>
460
+ <div class="testimonials-grid">{cards}</div>
461
+ </div></section>"""
462
+
463
+
464
+ def render_pricing(pricing: Dict[str, Any]) -> str:
465
+ title = escape(pricing.get("title", "Pricing"))
466
+ plans = pricing.get("plans", [])
467
+ if not plans:
468
+ return ""
469
+ cards = "\n".join(f"""
470
+ <div class="pricing-card {'featured' if p.get('featured') else ''}">
471
+ <div class="pricing-name">{escape(p.get('name', ''))}</div>
472
+ <div class="pricing-price">${escape(str(p.get('price', '0')))}<span>/mo</span></div>
473
+ <p>{escape(p.get('description', ''))}</p>
474
+ <ul class="pricing-features">
475
+ {"".join(f'<li>{escape(f)}</li>' for f in p.get('features', []))}
476
+ </ul>
477
+ <a href="{escape(p.get('cta_url', '#'))}" class="btn-primary">{escape(p.get('cta_text', 'Choose Plan'))}</a>
478
+ </div>""" for p in plans)
479
+ return f"""
480
+ <section class="pricing"><div class="container">
481
+ <h2 class="section-title">{title}</h2>
482
+ <div class="pricing-grid">{cards}</div>
483
+ </div></section>"""
484
+
485
+
486
+ def render_cta(cta: Dict[str, Any]) -> str:
487
+ return f"""
488
+ <section class="cta-section"><div class="container">
489
+ <h2>{escape(cta.get('headline', 'Ready to get started?'))}</h2>
490
+ <p>{escape(cta.get('subheadline', ''))}</p>
491
+ <a href="{escape(cta.get('url', '#'))}" class="btn-white">{escape(cta.get('text', 'Start Free Trial'))}</a>
492
+ </div></section>"""
493
+
494
+
495
+ def generate_html(config: Dict[str, Any]) -> str:
496
+ """Generate complete HTML landing page."""
497
+ title = escape(config.get("title", "Landing Page"))
498
+ css = generate_css(config)
499
+ sections = []
500
+ sections.append(render_nav(config))
501
+ if config.get("hero"):
502
+ sections.append(render_hero(config["hero"]))
503
+ if config.get("features"):
504
+ sections.append(render_features(config["features"]))
505
+ if config.get("testimonials"):
506
+ sections.append(render_testimonials(config["testimonials"]))
507
+ if config.get("pricing"):
508
+ sections.append(render_pricing(config["pricing"]))
509
+ if config.get("cta"):
510
+ sections.append(render_cta(config["cta"]))
511
+ sections.append(f"""
512
+ <footer><div class="container">
513
+ <p>{escape(config.get('footer_text', f'{datetime.now().year} {config.get("brand", "Company")}. All rights reserved.'))}</p>
514
+ </div></footer>""")
515
+ return f"""<!DOCTYPE html>
516
+ <html lang="en">
517
+ <head>
518
+ <meta charset="UTF-8">
519
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
520
+ <title>{title}</title>
521
+ <meta name="description" content="{escape(config.get('meta_description', ''))}">
522
+ <style>{css}</style>
523
+ </head>
524
+ <body>
525
+ {"".join(sections)}
526
+ </body>
527
+ </html>"""
528
+
529
+
530
+ def main():
531
+ parser = argparse.ArgumentParser(
532
+ description="Generate landing pages as HTML or Next.js TSX with Tailwind CSS"
533
+ )
534
+ parser.add_argument("input", help="Path to page config JSON")
535
+ parser.add_argument(
536
+ "--format", choices=["html", "tsx", "json"], default="tsx",
537
+ help="Output format: tsx (Next.js + Tailwind), html (standalone), json (metadata)"
538
+ )
539
+ parser.add_argument("--output", type=str, default=None, help="Output file path")
540
+
541
+ args = parser.parse_args()
542
+
543
+ with open(args.input) as f:
544
+ config = json.load(f)
545
+
546
+ if args.format == "json":
547
+ output = json.dumps({
548
+ "generated_at": datetime.now().isoformat(),
549
+ "config": config,
550
+ "formats_available": ["html", "tsx"],
551
+ "sections": [k for k in ["nav", "hero", "features", "testimonials", "pricing", "cta", "footer"]
552
+ if config.get(k) or k in ("nav", "footer")]
553
+ }, indent=2)
554
+ elif args.format == "tsx":
555
+ output = generate_tsx(config)
556
+ else:
557
+ output = generate_html(config)
558
+
559
+ if args.output:
560
+ with open(args.output, "w") as f:
561
+ f.write(output)
562
+ print(f"Landing page written to {args.output}")
563
+ else:
564
+ print(output)
565
+
566
+
567
+ if __name__ == "__main__":
568
+ main()