luckiest-co 1.0.1 → 1.0.3

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 (618) hide show
  1. package/.claude-plugin/marketplace.json +16 -0
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/LICENSE +24 -0
  4. package/bin/install.js +6 -4
  5. package/commands/{luckiest/finish.md → finish.md} +2 -0
  6. package/commands/go.md +53 -0
  7. package/commands/plan.md +66 -0
  8. package/package.json +3 -2
  9. package/skills/brainstorm/ATTRIBUTION.md +27 -0
  10. package/skills/brainstorm/SKILL.md +139 -0
  11. package/skills/luckiest-ab-testing/ATTRIBUTION.md +35 -0
  12. package/skills/luckiest-ab-testing/CHANGELOG.md +27 -0
  13. package/skills/luckiest-ab-testing/SKILL.md +379 -0
  14. package/skills/luckiest-ab-testing/evals/evals.json +118 -0
  15. package/skills/luckiest-ab-testing/references/sample-size-guide.md +290 -0
  16. package/skills/luckiest-ab-testing/references/test-templates.md +284 -0
  17. package/skills/luckiest-ad-creative/ATTRIBUTION.md +35 -0
  18. package/skills/luckiest-ad-creative/CHANGELOG.md +23 -0
  19. package/skills/luckiest-ad-creative/SKILL.md +393 -0
  20. package/skills/luckiest-ad-creative/evals/evals.json +90 -0
  21. package/skills/luckiest-ad-creative/references/generative-tools.md +637 -0
  22. package/skills/luckiest-ad-creative/references/platform-specs.md +213 -0
  23. package/skills/luckiest-ads/ATTRIBUTION.md +36 -0
  24. package/skills/luckiest-ads/CHANGELOG.md +24 -0
  25. package/skills/luckiest-ads/LICENSE +21 -0
  26. package/skills/luckiest-ads/SKILL.md +434 -0
  27. package/skills/luckiest-ads/evals/evals.json +90 -0
  28. package/skills/luckiest-ads/references/ad-copy-templates.md +207 -0
  29. package/skills/luckiest-ads/references/audience-targeting.md +243 -0
  30. package/skills/luckiest-ads/references/conversion-tracking.md +361 -0
  31. package/skills/luckiest-ads/references/platform-setup-checklists.md +277 -0
  32. package/skills/luckiest-advisors/ATTRIBUTION.md +16 -0
  33. package/skills/luckiest-advisors/CHANGELOG.md +99 -0
  34. package/skills/luckiest-advisors/SKILL.md +151 -0
  35. package/skills/luckiest-aeo-grader/ATTRIBUTION.md +19 -0
  36. package/skills/luckiest-aeo-grader/CHANGELOG.md +52 -0
  37. package/skills/luckiest-aeo-grader/SKILL.md +200 -0
  38. package/skills/luckiest-aeo-grader/evals/evals.json +19 -0
  39. package/skills/luckiest-aeo-grader/references/rubric.md +72 -0
  40. package/skills/luckiest-aeo-grader/scripts/scan.py +265 -0
  41. package/skills/luckiest-ai-seo/ATTRIBUTION.md +38 -0
  42. package/skills/luckiest-ai-seo/CHANGELOG.md +23 -0
  43. package/skills/luckiest-ai-seo/SKILL.md +510 -0
  44. package/skills/luckiest-ai-seo/evals/evals.json +90 -0
  45. package/skills/luckiest-ai-seo/references/content-patterns.md +285 -0
  46. package/skills/luckiest-ai-seo/references/content-types.md +71 -0
  47. package/skills/luckiest-ai-seo/references/okf.md +104 -0
  48. package/skills/luckiest-ai-seo/references/platform-ranking-factors.md +154 -0
  49. package/skills/luckiest-analytics/ATTRIBUTION.md +42 -0
  50. package/skills/luckiest-analytics/CHANGELOG.md +36 -0
  51. package/skills/luckiest-analytics/SKILL.md +380 -0
  52. package/skills/luckiest-analytics/evals/evals.json +90 -0
  53. package/skills/luckiest-analytics/references/event-library.md +260 -0
  54. package/skills/luckiest-analytics/references/ga4-implementation.md +300 -0
  55. package/skills/luckiest-analytics/references/gtm-implementation.md +390 -0
  56. package/skills/luckiest-aso/ATTRIBUTION.md +40 -0
  57. package/skills/luckiest-aso/CHANGELOG.md +33 -0
  58. package/skills/luckiest-aso/SKILL.md +327 -0
  59. package/skills/luckiest-aso/evals/evals.json +91 -0
  60. package/skills/luckiest-aso/references/apple-specs.md +107 -0
  61. package/skills/luckiest-aso/references/benchmarks.md +129 -0
  62. package/skills/luckiest-aso/references/google-play-specs.md +131 -0
  63. package/skills/luckiest-aso/references/report-template.md +213 -0
  64. package/skills/luckiest-aso/references/scoring-criteria.md +213 -0
  65. package/skills/luckiest-churn-prevention/ATTRIBUTION.md +41 -0
  66. package/skills/luckiest-churn-prevention/CHANGELOG.md +24 -0
  67. package/skills/luckiest-churn-prevention/SKILL.md +445 -0
  68. package/skills/luckiest-churn-prevention/evals/evals.json +93 -0
  69. package/skills/luckiest-churn-prevention/references/cancel-flow-patterns.md +316 -0
  70. package/skills/luckiest-churn-prevention/references/dunning-playbook.md +408 -0
  71. package/skills/luckiest-co-marketing/ATTRIBUTION.md +38 -0
  72. package/skills/luckiest-co-marketing/CHANGELOG.md +25 -0
  73. package/skills/luckiest-co-marketing/SKILL.md +331 -0
  74. package/skills/luckiest-co-marketing/evals/evals.json +84 -0
  75. package/skills/luckiest-coder/ATTRIBUTION.md +26 -0
  76. package/skills/luckiest-coder/CHANGELOG.md +30 -0
  77. package/skills/luckiest-coder/SKILL.md +77 -0
  78. package/skills/luckiest-coder/references/antigravity-tools.md +23 -0
  79. package/skills/luckiest-coder/references/codex-tools.md +39 -0
  80. package/skills/luckiest-coder/references/pi-tools.md +16 -0
  81. package/skills/luckiest-coder-brainstorming/ATTRIBUTION.md +26 -0
  82. package/skills/luckiest-coder-brainstorming/CHANGELOG.md +31 -0
  83. package/skills/luckiest-coder-brainstorming/SKILL.md +173 -0
  84. package/skills/luckiest-coder-brainstorming/scripts/frame-template.html +213 -0
  85. package/skills/luckiest-coder-brainstorming/scripts/helper.js +168 -0
  86. package/skills/luckiest-coder-brainstorming/scripts/server.cjs +721 -0
  87. package/skills/luckiest-coder-brainstorming/scripts/start-server.sh +209 -0
  88. package/skills/luckiest-coder-brainstorming/scripts/stop-server.sh +120 -0
  89. package/skills/luckiest-coder-brainstorming/spec-document-reviewer-prompt.md +49 -0
  90. package/skills/luckiest-coder-brainstorming/visual-companion.md +291 -0
  91. package/skills/luckiest-coder-consistency/ATTRIBUTION.md +30 -0
  92. package/skills/luckiest-coder-consistency/CHANGELOG.md +26 -0
  93. package/skills/luckiest-coder-consistency/SKILL.md +98 -0
  94. package/skills/luckiest-coder-constitution/ATTRIBUTION.md +28 -0
  95. package/skills/luckiest-coder-constitution/CHANGELOG.md +25 -0
  96. package/skills/luckiest-coder-constitution/SKILL.md +115 -0
  97. package/skills/luckiest-coder-debugging/ATTRIBUTION.md +26 -0
  98. package/skills/luckiest-coder-debugging/CHANGELOG.md +22 -0
  99. package/skills/luckiest-coder-debugging/CREATION-LOG.md +119 -0
  100. package/skills/luckiest-coder-debugging/SKILL.md +309 -0
  101. package/skills/luckiest-coder-debugging/condition-based-waiting-example.ts +158 -0
  102. package/skills/luckiest-coder-debugging/condition-based-waiting.md +115 -0
  103. package/skills/luckiest-coder-debugging/defense-in-depth.md +122 -0
  104. package/skills/luckiest-coder-debugging/find-polluter.sh +63 -0
  105. package/skills/luckiest-coder-debugging/root-cause-tracing.md +169 -0
  106. package/skills/luckiest-coder-debugging/test-academic.md +14 -0
  107. package/skills/luckiest-coder-debugging/test-pressure-1.md +58 -0
  108. package/skills/luckiest-coder-debugging/test-pressure-2.md +68 -0
  109. package/skills/luckiest-coder-debugging/test-pressure-3.md +69 -0
  110. package/skills/luckiest-coder-dispatching-parallel-agents/ATTRIBUTION.md +26 -0
  111. package/skills/luckiest-coder-dispatching-parallel-agents/CHANGELOG.md +23 -0
  112. package/skills/luckiest-coder-dispatching-parallel-agents/SKILL.md +198 -0
  113. package/skills/luckiest-coder-executing-plans/ATTRIBUTION.md +26 -0
  114. package/skills/luckiest-coder-executing-plans/CHANGELOG.md +22 -0
  115. package/skills/luckiest-coder-executing-plans/SKILL.md +83 -0
  116. package/skills/luckiest-coder-finishing-a-branch/ATTRIBUTION.md +26 -0
  117. package/skills/luckiest-coder-finishing-a-branch/CHANGELOG.md +22 -0
  118. package/skills/luckiest-coder-finishing-a-branch/SKILL.md +258 -0
  119. package/skills/luckiest-coder-git-worktrees/ATTRIBUTION.md +26 -0
  120. package/skills/luckiest-coder-git-worktrees/CHANGELOG.md +22 -0
  121. package/skills/luckiest-coder-git-worktrees/SKILL.md +215 -0
  122. package/skills/luckiest-coder-guard/ATTRIBUTION.md +29 -0
  123. package/skills/luckiest-coder-guard/CHANGELOG.md +48 -0
  124. package/skills/luckiest-coder-guard/LICENSE +21 -0
  125. package/skills/luckiest-coder-guard/SKILL.md +126 -0
  126. package/skills/luckiest-coder-guard/bin/check-careful.sh +65 -0
  127. package/skills/luckiest-coder-guard/bin/check-freeze.sh +48 -0
  128. package/skills/luckiest-coder-qa/ATTRIBUTION.md +28 -0
  129. package/skills/luckiest-coder-qa/CHANGELOG.md +49 -0
  130. package/skills/luckiest-coder-qa/LICENSE +21 -0
  131. package/skills/luckiest-coder-qa/SKILL.md +160 -0
  132. package/skills/luckiest-coder-qa/references/issue-taxonomy.md +85 -0
  133. package/skills/luckiest-coder-qa/references/qa-report-template.md +126 -0
  134. package/skills/luckiest-coder-receiving-code-review/ATTRIBUTION.md +26 -0
  135. package/skills/luckiest-coder-receiving-code-review/CHANGELOG.md +28 -0
  136. package/skills/luckiest-coder-receiving-code-review/SKILL.md +226 -0
  137. package/skills/luckiest-coder-requesting-code-review/ATTRIBUTION.md +26 -0
  138. package/skills/luckiest-coder-requesting-code-review/CHANGELOG.md +31 -0
  139. package/skills/luckiest-coder-requesting-code-review/SKILL.md +118 -0
  140. package/skills/luckiest-coder-requesting-code-review/code-reviewer.md +172 -0
  141. package/skills/luckiest-coder-shipping/ATTRIBUTION.md +26 -0
  142. package/skills/luckiest-coder-shipping/CHANGELOG.md +48 -0
  143. package/skills/luckiest-coder-shipping/LICENSE +21 -0
  144. package/skills/luckiest-coder-shipping/SKILL.md +148 -0
  145. package/skills/luckiest-coder-shipping/references/canary.md +44 -0
  146. package/skills/luckiest-coder-shipping/references/test-and-coverage.md +91 -0
  147. package/skills/luckiest-coder-subagent-driven-development/ATTRIBUTION.md +26 -0
  148. package/skills/luckiest-coder-subagent-driven-development/CHANGELOG.md +28 -0
  149. package/skills/luckiest-coder-subagent-driven-development/SKILL.md +439 -0
  150. package/skills/luckiest-coder-subagent-driven-development/implementer-prompt.md +139 -0
  151. package/skills/luckiest-coder-subagent-driven-development/scripts/review-package +44 -0
  152. package/skills/luckiest-coder-subagent-driven-development/scripts/sdd-workspace +22 -0
  153. package/skills/luckiest-coder-subagent-driven-development/scripts/task-brief +40 -0
  154. package/skills/luckiest-coder-subagent-driven-development/task-reviewer-prompt.md +188 -0
  155. package/skills/luckiest-coder-tdd/ATTRIBUTION.md +26 -0
  156. package/skills/luckiest-coder-tdd/CHANGELOG.md +26 -0
  157. package/skills/luckiest-coder-tdd/SKILL.md +384 -0
  158. package/skills/luckiest-coder-tdd/testing-anti-patterns.md +299 -0
  159. package/skills/luckiest-coder-verification/ATTRIBUTION.md +26 -0
  160. package/skills/luckiest-coder-verification/CHANGELOG.md +22 -0
  161. package/skills/luckiest-coder-verification/SKILL.md +152 -0
  162. package/skills/luckiest-coder-writing-plans/ATTRIBUTION.md +26 -0
  163. package/skills/luckiest-coder-writing-plans/CHANGELOG.md +22 -0
  164. package/skills/luckiest-coder-writing-plans/SKILL.md +191 -0
  165. package/skills/luckiest-coder-writing-plans/plan-document-reviewer-prompt.md +49 -0
  166. package/skills/luckiest-coder-writing-skills/ATTRIBUTION.md +26 -0
  167. package/skills/luckiest-coder-writing-skills/CHANGELOG.md +31 -0
  168. package/skills/luckiest-coder-writing-skills/SKILL.md +702 -0
  169. package/skills/luckiest-coder-writing-skills/anthropic-best-practices.md +1150 -0
  170. package/skills/luckiest-coder-writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  171. package/skills/luckiest-coder-writing-skills/graphviz-conventions.dot +172 -0
  172. package/skills/luckiest-coder-writing-skills/persuasion-principles.md +187 -0
  173. package/skills/luckiest-coder-writing-skills/render-graphs.js +168 -0
  174. package/skills/luckiest-coder-writing-skills/testing-skills-with-subagents.md +384 -0
  175. package/skills/luckiest-cold-email/ATTRIBUTION.md +36 -0
  176. package/skills/luckiest-cold-email/CHANGELOG.md +24 -0
  177. package/skills/luckiest-cold-email/SKILL.md +213 -0
  178. package/skills/luckiest-cold-email/evals/evals.json +94 -0
  179. package/skills/luckiest-cold-email/references/benchmarks.md +83 -0
  180. package/skills/luckiest-cold-email/references/follow-up-sequences.md +81 -0
  181. package/skills/luckiest-cold-email/references/frameworks.md +90 -0
  182. package/skills/luckiest-cold-email/references/personalization.md +79 -0
  183. package/skills/luckiest-cold-email/references/subject-lines.md +53 -0
  184. package/skills/luckiest-community-marketing/ATTRIBUTION.md +41 -0
  185. package/skills/luckiest-community-marketing/CHANGELOG.md +35 -0
  186. package/skills/luckiest-community-marketing/SKILL.md +200 -0
  187. package/skills/luckiest-community-marketing/evals/evals.json +89 -0
  188. package/skills/luckiest-competitor-profiling/ATTRIBUTION.md +36 -0
  189. package/skills/luckiest-competitor-profiling/CHANGELOG.md +24 -0
  190. package/skills/luckiest-competitor-profiling/SKILL.md +443 -0
  191. package/skills/luckiest-competitor-profiling/evals/evals.json +85 -0
  192. package/skills/luckiest-competitor-profiling/references/templates.md +167 -0
  193. package/skills/luckiest-competitor-profiling/references/tool-reference.md +179 -0
  194. package/skills/luckiest-competitors/ATTRIBUTION.md +36 -0
  195. package/skills/luckiest-competitors/CHANGELOG.md +25 -0
  196. package/skills/luckiest-competitors/SKILL.md +171 -0
  197. package/skills/luckiest-competitors/evals/evals.json +93 -0
  198. package/skills/luckiest-competitors/references/content-architecture.md +271 -0
  199. package/skills/luckiest-competitors/references/templates.md +223 -0
  200. package/skills/luckiest-content-strategy/ATTRIBUTION.md +39 -0
  201. package/skills/luckiest-content-strategy/CHANGELOG.md +23 -0
  202. package/skills/luckiest-content-strategy/SKILL.md +395 -0
  203. package/skills/luckiest-content-strategy/evals/evals.json +90 -0
  204. package/skills/luckiest-content-strategy/references/headless-cms.md +194 -0
  205. package/skills/luckiest-copy-editing/ATTRIBUTION.md +41 -0
  206. package/skills/luckiest-copy-editing/CHANGELOG.md +31 -0
  207. package/skills/luckiest-copy-editing/SKILL.md +491 -0
  208. package/skills/luckiest-copy-editing/evals/evals.json +89 -0
  209. package/skills/luckiest-copy-editing/references/checklist.md +66 -0
  210. package/skills/luckiest-copy-editing/references/content-refresh.md +38 -0
  211. package/skills/luckiest-copy-editing/references/plain-english-alternatives.md +394 -0
  212. package/skills/luckiest-copywriting/ATTRIBUTION.md +35 -0
  213. package/skills/luckiest-copywriting/CHANGELOG.md +23 -0
  214. package/skills/luckiest-copywriting/SKILL.md +296 -0
  215. package/skills/luckiest-copywriting/evals/evals.json +111 -0
  216. package/skills/luckiest-copywriting/references/copy-frameworks.md +344 -0
  217. package/skills/luckiest-copywriting/references/natural-transitions.md +272 -0
  218. package/skills/luckiest-cro/ATTRIBUTION.md +34 -0
  219. package/skills/luckiest-cro/CHANGELOG.md +23 -0
  220. package/skills/luckiest-cro/SKILL.md +215 -0
  221. package/skills/luckiest-cro/evals/evals.json +111 -0
  222. package/skills/luckiest-cro/references/experiments.md +248 -0
  223. package/skills/luckiest-cro/references/form.md +422 -0
  224. package/skills/luckiest-customer-research/ATTRIBUTION.md +40 -0
  225. package/skills/luckiest-customer-research/CHANGELOG.md +26 -0
  226. package/skills/luckiest-customer-research/SKILL.md +293 -0
  227. package/skills/luckiest-customer-research/evals/evals.json +162 -0
  228. package/skills/luckiest-customer-research/references/source-guides.md +401 -0
  229. package/skills/luckiest-directory-submissions/ATTRIBUTION.md +40 -0
  230. package/skills/luckiest-directory-submissions/CHANGELOG.md +33 -0
  231. package/skills/luckiest-directory-submissions/SKILL.md +419 -0
  232. package/skills/luckiest-directory-submissions/evals/evals.json +94 -0
  233. package/skills/luckiest-directory-submissions/references/directory-list.md +477 -0
  234. package/skills/luckiest-directory-submissions/references/positioning-variations.md +232 -0
  235. package/skills/luckiest-directory-submissions/references/submission-tracker-template.csv +266 -0
  236. package/skills/luckiest-emails/ATTRIBUTION.md +42 -0
  237. package/skills/luckiest-emails/CHANGELOG.md +33 -0
  238. package/skills/luckiest-emails/SKILL.md +220 -0
  239. package/skills/luckiest-emails/evals/evals.json +93 -0
  240. package/skills/luckiest-emails/references/copy-guidelines.md +120 -0
  241. package/skills/luckiest-emails/references/email-types.md +515 -0
  242. package/skills/luckiest-emails/references/sequence-templates.md +168 -0
  243. package/skills/luckiest-extract-design-system/ATTRIBUTION.md +8 -0
  244. package/skills/luckiest-extract-design-system/CHANGELOG.md +37 -0
  245. package/skills/luckiest-extract-design-system/SKILL.md +83 -0
  246. package/skills/luckiest-free-tools/ATTRIBUTION.md +43 -0
  247. package/skills/luckiest-free-tools/CHANGELOG.md +25 -0
  248. package/skills/luckiest-free-tools/SKILL.md +220 -0
  249. package/skills/luckiest-free-tools/evals/evals.json +90 -0
  250. package/skills/luckiest-free-tools/references/tool-types.md +217 -0
  251. package/skills/luckiest-image/ATTRIBUTION.md +43 -0
  252. package/skills/luckiest-image/CHANGELOG.md +23 -0
  253. package/skills/luckiest-image/SKILL.md +376 -0
  254. package/skills/luckiest-image/evals/evals.json +89 -0
  255. package/skills/luckiest-image/references/ai-image-prompting.md +229 -0
  256. package/skills/luckiest-launch/ATTRIBUTION.md +40 -0
  257. package/skills/luckiest-launch/CHANGELOG.md +43 -0
  258. package/skills/luckiest-launch/SKILL.md +385 -0
  259. package/skills/luckiest-launch/evals/evals.json +91 -0
  260. package/skills/luckiest-lead-magnets/ATTRIBUTION.md +35 -0
  261. package/skills/luckiest-lead-magnets/CHANGELOG.md +23 -0
  262. package/skills/luckiest-lead-magnets/SKILL.md +331 -0
  263. package/skills/luckiest-lead-magnets/evals/evals.json +87 -0
  264. package/skills/luckiest-lead-magnets/references/benchmarks.md +129 -0
  265. package/skills/luckiest-lead-magnets/references/format-guide.md +196 -0
  266. package/skills/luckiest-marketing-ideas/ATTRIBUTION.md +39 -0
  267. package/skills/luckiest-marketing-ideas/CHANGELOG.md +33 -0
  268. package/skills/luckiest-marketing-ideas/SKILL.md +191 -0
  269. package/skills/luckiest-marketing-ideas/evals/evals.json +90 -0
  270. package/skills/luckiest-marketing-ideas/references/ideas-by-category.md +366 -0
  271. package/skills/luckiest-marketing-plan/ATTRIBUTION.md +40 -0
  272. package/skills/luckiest-marketing-plan/CHANGELOG.md +23 -0
  273. package/skills/luckiest-marketing-plan/SKILL.md +285 -0
  274. package/skills/luckiest-marketing-plan/evals/evals.json +96 -0
  275. package/skills/luckiest-marketing-plan/references/aarrr-framework.md +180 -0
  276. package/skills/luckiest-marketing-plan/references/budget-planning.md +168 -0
  277. package/skills/luckiest-marketing-plan/references/client-types.md +373 -0
  278. package/skills/luckiest-marketing-plan/references/current-state-rubric.md +255 -0
  279. package/skills/luckiest-marketing-plan/references/example-quietude.md +972 -0
  280. package/skills/luckiest-marketing-plan/references/funding-stage-unlocks.md +230 -0
  281. package/skills/luckiest-marketing-plan/references/growth-patterns.md +148 -0
  282. package/skills/luckiest-marketing-plan/references/idea-cross-reference.md +265 -0
  283. package/skills/luckiest-marketing-plan/references/measurement-framework.md +213 -0
  284. package/skills/luckiest-marketing-plan/references/methodology.md +363 -0
  285. package/skills/luckiest-marketing-plan/references/ops-stack-mapping.md +197 -0
  286. package/skills/luckiest-marketing-plan/references/plan-template.md +494 -0
  287. package/skills/luckiest-marketing-plan/references/team-and-agency-model.md +278 -0
  288. package/skills/luckiest-marketing-psychology/ATTRIBUTION.md +31 -0
  289. package/skills/luckiest-marketing-psychology/CHANGELOG.md +32 -0
  290. package/skills/luckiest-marketing-psychology/SKILL.md +202 -0
  291. package/skills/luckiest-marketing-psychology/evals.json +88 -0
  292. package/skills/luckiest-model-router/ATTRIBUTION.md +11 -0
  293. package/skills/luckiest-model-router/CHANGELOG.md +45 -0
  294. package/skills/luckiest-model-router/SKILL.md +74 -0
  295. package/skills/luckiest-model-router/scripts/route.py +145 -0
  296. package/skills/luckiest-offers/ATTRIBUTION.md +39 -0
  297. package/skills/luckiest-offers/CHANGELOG.md +23 -0
  298. package/skills/luckiest-offers/SKILL.md +167 -0
  299. package/skills/luckiest-offers/references/bonus-stacking.md +150 -0
  300. package/skills/luckiest-offers/references/examples.md +215 -0
  301. package/skills/luckiest-offers/references/guarantee-design.md +172 -0
  302. package/skills/luckiest-offers/references/offer-anatomy.md +203 -0
  303. package/skills/luckiest-offers/references/offer-formats.md +240 -0
  304. package/skills/luckiest-offers/references/scarcity-urgency.md +175 -0
  305. package/skills/luckiest-offers/references/value-equation.md +134 -0
  306. package/skills/luckiest-onboarding/ATTRIBUTION.md +43 -0
  307. package/skills/luckiest-onboarding/CHANGELOG.md +31 -0
  308. package/skills/luckiest-onboarding/SKILL.md +243 -0
  309. package/skills/luckiest-onboarding/references/experiments.md +258 -0
  310. package/skills/luckiest-paywalls/ATTRIBUTION.md +39 -0
  311. package/skills/luckiest-paywalls/CHANGELOG.md +25 -0
  312. package/skills/luckiest-paywalls/SKILL.md +256 -0
  313. package/skills/luckiest-paywalls/evals/evals.json +93 -0
  314. package/skills/luckiest-paywalls/references/experiments.md +164 -0
  315. package/skills/luckiest-popups/ATTRIBUTION.md +35 -0
  316. package/skills/luckiest-popups/CHANGELOG.md +27 -0
  317. package/skills/luckiest-popups/SKILL.md +477 -0
  318. package/skills/luckiest-popups/evals/evals.json +107 -0
  319. package/skills/luckiest-pricing/ATTRIBUTION.md +35 -0
  320. package/skills/luckiest-pricing/CHANGELOG.md +31 -0
  321. package/skills/luckiest-pricing/SKILL.md +283 -0
  322. package/skills/luckiest-pricing/evals/evals.json +90 -0
  323. package/skills/luckiest-pricing/references/research-methods.md +152 -0
  324. package/skills/luckiest-pricing/references/tier-structure.md +232 -0
  325. package/skills/luckiest-product-marketing/ATTRIBUTION.md +38 -0
  326. package/skills/luckiest-product-marketing/CHANGELOG.md +23 -0
  327. package/skills/luckiest-product-marketing/SKILL.md +256 -0
  328. package/skills/luckiest-product-marketing/evals/evals.json +85 -0
  329. package/skills/luckiest-programmatic-seo/ATTRIBUTION.md +35 -0
  330. package/skills/luckiest-programmatic-seo/CHANGELOG.md +24 -0
  331. package/skills/luckiest-programmatic-seo/SKILL.md +286 -0
  332. package/skills/luckiest-programmatic-seo/evals/evals.json +95 -0
  333. package/skills/luckiest-programmatic-seo/references/playbooks.md +308 -0
  334. package/skills/luckiest-prompt-rewrite/ATTRIBUTION.md +39 -0
  335. package/skills/luckiest-prompt-rewrite/CHANGELOG.md +70 -0
  336. package/skills/luckiest-prompt-rewrite/LICENSE +21 -0
  337. package/skills/luckiest-prompt-rewrite/SKILL.md +494 -0
  338. package/skills/luckiest-prompt-rewrite/references/patterns.md +82 -0
  339. package/skills/luckiest-prompt-rewrite/references/templates.md +454 -0
  340. package/skills/luckiest-prospecting/ATTRIBUTION.md +29 -0
  341. package/skills/luckiest-prospecting/CHANGELOG.md +24 -0
  342. package/skills/luckiest-prospecting/SKILL.md +275 -0
  343. package/skills/luckiest-prospecting/evals/evals.json +107 -0
  344. package/skills/luckiest-prospecting/references/b2b-prospecting.md +106 -0
  345. package/skills/luckiest-prospecting/references/compliance.md +123 -0
  346. package/skills/luckiest-prospecting/references/data-sources.md +287 -0
  347. package/skills/luckiest-prospecting/references/local-prospecting.md +165 -0
  348. package/skills/luckiest-prospecting/references/saas-prospecting.md +123 -0
  349. package/skills/luckiest-public-relations/ATTRIBUTION.md +34 -0
  350. package/skills/luckiest-public-relations/CHANGELOG.md +23 -0
  351. package/skills/luckiest-public-relations/SKILL.md +154 -0
  352. package/skills/luckiest-public-relations/references/journalist-pitching.md +368 -0
  353. package/skills/luckiest-public-relations/references/media-outlets.md +207 -0
  354. package/skills/luckiest-public-relations/references/newsjacking.md +218 -0
  355. package/skills/luckiest-public-relations/references/press-platforms.md +188 -0
  356. package/skills/luckiest-referrals/ATTRIBUTION.md +41 -0
  357. package/skills/luckiest-referrals/CHANGELOG.md +23 -0
  358. package/skills/luckiest-referrals/SKILL.md +292 -0
  359. package/skills/luckiest-referrals/evals/evals.json +90 -0
  360. package/skills/luckiest-referrals/references/affiliate-programs.md +167 -0
  361. package/skills/luckiest-referrals/references/program-examples.md +143 -0
  362. package/skills/luckiest-revops/ATTRIBUTION.md +40 -0
  363. package/skills/luckiest-revops/CHANGELOG.md +24 -0
  364. package/skills/luckiest-revops/SKILL.md +362 -0
  365. package/skills/luckiest-revops/evals/evals.json +91 -0
  366. package/skills/luckiest-revops/references/automation-playbooks.md +290 -0
  367. package/skills/luckiest-revops/references/lifecycle-definitions.md +278 -0
  368. package/skills/luckiest-revops/references/routing-rules.md +203 -0
  369. package/skills/luckiest-revops/references/scoring-models.md +247 -0
  370. package/skills/luckiest-sales-enablement/ATTRIBUTION.md +39 -0
  371. package/skills/luckiest-sales-enablement/CHANGELOG.md +23 -0
  372. package/skills/luckiest-sales-enablement/SKILL.md +379 -0
  373. package/skills/luckiest-sales-enablement/evals/evals.json +91 -0
  374. package/skills/luckiest-sales-enablement/references/deck-frameworks.md +263 -0
  375. package/skills/luckiest-sales-enablement/references/demo-scripts.md +355 -0
  376. package/skills/luckiest-sales-enablement/references/objection-library.md +270 -0
  377. package/skills/luckiest-sales-enablement/references/one-pager-templates.md +208 -0
  378. package/skills/luckiest-schema/ATTRIBUTION.md +39 -0
  379. package/skills/luckiest-schema/CHANGELOG.md +25 -0
  380. package/skills/luckiest-schema/SKILL.md +209 -0
  381. package/skills/luckiest-schema/evals/evals.json +88 -0
  382. package/skills/luckiest-schema/references/schema-examples.md +398 -0
  383. package/skills/luckiest-seo-audit/ATTRIBUTION.md +39 -0
  384. package/skills/luckiest-seo-audit/CHANGELOG.md +23 -0
  385. package/skills/luckiest-seo-audit/SKILL.md +529 -0
  386. package/skills/luckiest-seo-audit/evals/evals.json +136 -0
  387. package/skills/luckiest-seo-audit/references/ai-writing-detection.md +200 -0
  388. package/skills/luckiest-seo-audit/references/international-seo.md +230 -0
  389. package/skills/luckiest-session-handoff/ATTRIBUTION.md +14 -0
  390. package/skills/luckiest-session-handoff/CHANGELOG.md +30 -0
  391. package/skills/luckiest-session-handoff/SKILL.md +96 -0
  392. package/skills/luckiest-signup/ATTRIBUTION.md +48 -0
  393. package/skills/luckiest-signup/CHANGELOG.md +24 -0
  394. package/skills/luckiest-signup/SKILL.md +382 -0
  395. package/skills/luckiest-signup/evals/evals.json +88 -0
  396. package/skills/luckiest-site-architecture/ATTRIBUTION.md +38 -0
  397. package/skills/luckiest-site-architecture/CHANGELOG.md +23 -0
  398. package/skills/luckiest-site-architecture/SKILL.md +383 -0
  399. package/skills/luckiest-site-architecture/evals/evals.json +88 -0
  400. package/skills/luckiest-site-architecture/references/mermaid-templates.md +216 -0
  401. package/skills/luckiest-site-architecture/references/navigation-patterns.md +305 -0
  402. package/skills/luckiest-site-architecture/references/site-type-templates.md +293 -0
  403. package/skills/luckiest-sms/ATTRIBUTION.md +27 -0
  404. package/skills/luckiest-sms/CHANGELOG.md +24 -0
  405. package/skills/luckiest-sms/SKILL.md +400 -0
  406. package/skills/luckiest-sms/evals/evals.json +100 -0
  407. package/skills/luckiest-sms/references/compliance.md +202 -0
  408. package/skills/luckiest-sms/references/platforms.md +318 -0
  409. package/skills/luckiest-sms/references/sequence-templates.md +282 -0
  410. package/skills/luckiest-social/ATTRIBUTION.md +27 -0
  411. package/skills/luckiest-social/CHANGELOG.md +24 -0
  412. package/skills/luckiest-social/SKILL.md +430 -0
  413. package/skills/luckiest-social/evals/evals.json +92 -0
  414. package/skills/luckiest-social/references/listening-sources-template.md +123 -0
  415. package/skills/luckiest-social/references/listening.md +283 -0
  416. package/skills/luckiest-social/references/platform-limits.md +110 -0
  417. package/skills/luckiest-social/references/platforms.md +170 -0
  418. package/skills/luckiest-social/references/post-templates.md +177 -0
  419. package/skills/luckiest-social/references/reverse-engineering.md +195 -0
  420. package/skills/luckiest-social/references/short-form-video.md +237 -0
  421. package/skills/luckiest-thinker/ATTRIBUTION.md +16 -0
  422. package/skills/luckiest-thinker/CHANGELOG.md +20 -0
  423. package/skills/luckiest-thinker/LICENSE +21 -0
  424. package/skills/luckiest-thinker/SKILL.md +92 -0
  425. package/skills/luckiest-thinker/references/distribution-calibration.md +106 -0
  426. package/skills/luckiest-thinker/references/research-foundations.md +214 -0
  427. package/skills/luckiest-thinker/references/thinking-patterns.md +138 -0
  428. package/skills/luckiest-trends/.skillignore +10 -0
  429. package/skills/luckiest-trends/ATTRIBUTION.md +43 -0
  430. package/skills/luckiest-trends/CHANGELOG.md +86 -0
  431. package/skills/luckiest-trends/LICENSE +21 -0
  432. package/skills/luckiest-trends/SKILL.md +194 -0
  433. package/skills/luckiest-trends/agents/openai.yaml +8 -0
  434. package/skills/luckiest-trends/references/engine-contract.md +2041 -0
  435. package/skills/luckiest-trends/references/save-html-brief.md +206 -0
  436. package/skills/luckiest-trends/scripts/briefing.py +272 -0
  437. package/skills/luckiest-trends/scripts/build-skill.sh +39 -0
  438. package/skills/luckiest-trends/scripts/compare.sh +61 -0
  439. package/skills/luckiest-trends/scripts/evaluate_search_quality.py +573 -0
  440. package/skills/luckiest-trends/scripts/last30days.py +1467 -0
  441. package/skills/luckiest-trends/scripts/lib/__init__.py +1 -0
  442. package/skills/luckiest-trends/scripts/lib/__pycache__/__init__.cpython-313.pyc +0 -0
  443. package/skills/luckiest-trends/scripts/lib/__pycache__/arxiv.cpython-313.pyc +0 -0
  444. package/skills/luckiest-trends/scripts/lib/__pycache__/bird_x.cpython-313.pyc +0 -0
  445. package/skills/luckiest-trends/scripts/lib/__pycache__/bluesky.cpython-313.pyc +0 -0
  446. package/skills/luckiest-trends/scripts/lib/__pycache__/categories.cpython-313.pyc +0 -0
  447. package/skills/luckiest-trends/scripts/lib/__pycache__/cjk.cpython-313.pyc +0 -0
  448. package/skills/luckiest-trends/scripts/lib/__pycache__/cluster.cpython-313.pyc +0 -0
  449. package/skills/luckiest-trends/scripts/lib/__pycache__/dates.cpython-313.pyc +0 -0
  450. package/skills/luckiest-trends/scripts/lib/__pycache__/dedupe.cpython-313.pyc +0 -0
  451. package/skills/luckiest-trends/scripts/lib/__pycache__/digg.cpython-313.pyc +0 -0
  452. package/skills/luckiest-trends/scripts/lib/__pycache__/entity_extract.cpython-313.pyc +0 -0
  453. package/skills/luckiest-trends/scripts/lib/__pycache__/env.cpython-313.pyc +0 -0
  454. package/skills/luckiest-trends/scripts/lib/__pycache__/fusion.cpython-313.pyc +0 -0
  455. package/skills/luckiest-trends/scripts/lib/__pycache__/github.cpython-313.pyc +0 -0
  456. package/skills/luckiest-trends/scripts/lib/__pycache__/grounding.cpython-313.pyc +0 -0
  457. package/skills/luckiest-trends/scripts/lib/__pycache__/hackernews.cpython-313.pyc +0 -0
  458. package/skills/luckiest-trends/scripts/lib/__pycache__/hiring_signals.cpython-313.pyc +0 -0
  459. package/skills/luckiest-trends/scripts/lib/__pycache__/html_render.cpython-313.pyc +0 -0
  460. package/skills/luckiest-trends/scripts/lib/__pycache__/http.cpython-313.pyc +0 -0
  461. package/skills/luckiest-trends/scripts/lib/__pycache__/instagram.cpython-313.pyc +0 -0
  462. package/skills/luckiest-trends/scripts/lib/__pycache__/jobs.cpython-313.pyc +0 -0
  463. package/skills/luckiest-trends/scripts/lib/__pycache__/linkedin.cpython-313.pyc +0 -0
  464. package/skills/luckiest-trends/scripts/lib/__pycache__/log.cpython-313.pyc +0 -0
  465. package/skills/luckiest-trends/scripts/lib/__pycache__/normalize.cpython-313.pyc +0 -0
  466. package/skills/luckiest-trends/scripts/lib/__pycache__/permission_preflight.cpython-313.pyc +0 -0
  467. package/skills/luckiest-trends/scripts/lib/__pycache__/perplexity.cpython-313.pyc +0 -0
  468. package/skills/luckiest-trends/scripts/lib/__pycache__/pinterest.cpython-313.pyc +0 -0
  469. package/skills/luckiest-trends/scripts/lib/__pycache__/pipeline.cpython-313.pyc +0 -0
  470. package/skills/luckiest-trends/scripts/lib/__pycache__/planner.cpython-313.pyc +0 -0
  471. package/skills/luckiest-trends/scripts/lib/__pycache__/polymarket.cpython-313.pyc +0 -0
  472. package/skills/luckiest-trends/scripts/lib/__pycache__/preflight.cpython-313.pyc +0 -0
  473. package/skills/luckiest-trends/scripts/lib/__pycache__/providers.cpython-313.pyc +0 -0
  474. package/skills/luckiest-trends/scripts/lib/__pycache__/quality_nudge.cpython-313.pyc +0 -0
  475. package/skills/luckiest-trends/scripts/lib/__pycache__/query.cpython-313.pyc +0 -0
  476. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit.cpython-313.pyc +0 -0
  477. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_arctic.cpython-313.pyc +0 -0
  478. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_enrich.cpython-313.pyc +0 -0
  479. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_keyless.cpython-313.pyc +0 -0
  480. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_listing.cpython-313.pyc +0 -0
  481. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_public.cpython-313.pyc +0 -0
  482. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_rss.cpython-313.pyc +0 -0
  483. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_shreddit.cpython-313.pyc +0 -0
  484. package/skills/luckiest-trends/scripts/lib/__pycache__/relevance.cpython-313.pyc +0 -0
  485. package/skills/luckiest-trends/scripts/lib/__pycache__/render.cpython-313.pyc +0 -0
  486. package/skills/luckiest-trends/scripts/lib/__pycache__/rerank.cpython-313.pyc +0 -0
  487. package/skills/luckiest-trends/scripts/lib/__pycache__/resolve.cpython-313.pyc +0 -0
  488. package/skills/luckiest-trends/scripts/lib/__pycache__/schema.cpython-313.pyc +0 -0
  489. package/skills/luckiest-trends/scripts/lib/__pycache__/signals.cpython-313.pyc +0 -0
  490. package/skills/luckiest-trends/scripts/lib/__pycache__/skill_meta.cpython-313.pyc +0 -0
  491. package/skills/luckiest-trends/scripts/lib/__pycache__/snippet.cpython-313.pyc +0 -0
  492. package/skills/luckiest-trends/scripts/lib/__pycache__/subproc.cpython-313.pyc +0 -0
  493. package/skills/luckiest-trends/scripts/lib/__pycache__/techmeme.cpython-313.pyc +0 -0
  494. package/skills/luckiest-trends/scripts/lib/__pycache__/threads.cpython-313.pyc +0 -0
  495. package/skills/luckiest-trends/scripts/lib/__pycache__/tiktok.cpython-313.pyc +0 -0
  496. package/skills/luckiest-trends/scripts/lib/__pycache__/trustpilot.cpython-313.pyc +0 -0
  497. package/skills/luckiest-trends/scripts/lib/__pycache__/truthsocial.cpython-313.pyc +0 -0
  498. package/skills/luckiest-trends/scripts/lib/__pycache__/ui.cpython-313.pyc +0 -0
  499. package/skills/luckiest-trends/scripts/lib/__pycache__/web_search_keyless.cpython-313.pyc +0 -0
  500. package/skills/luckiest-trends/scripts/lib/__pycache__/xai_x.cpython-313.pyc +0 -0
  501. package/skills/luckiest-trends/scripts/lib/__pycache__/xiaohongshu_api.cpython-313.pyc +0 -0
  502. package/skills/luckiest-trends/scripts/lib/__pycache__/xquik.cpython-313.pyc +0 -0
  503. package/skills/luckiest-trends/scripts/lib/__pycache__/xurl_x.cpython-313.pyc +0 -0
  504. package/skills/luckiest-trends/scripts/lib/__pycache__/youtube_yt.cpython-313.pyc +0 -0
  505. package/skills/luckiest-trends/scripts/lib/arxiv.py +290 -0
  506. package/skills/luckiest-trends/scripts/lib/bird_x.py +639 -0
  507. package/skills/luckiest-trends/scripts/lib/bluesky.py +323 -0
  508. package/skills/luckiest-trends/scripts/lib/categories.py +283 -0
  509. package/skills/luckiest-trends/scripts/lib/chrome_cookies.py +414 -0
  510. package/skills/luckiest-trends/scripts/lib/cjk.py +107 -0
  511. package/skills/luckiest-trends/scripts/lib/cluster.py +271 -0
  512. package/skills/luckiest-trends/scripts/lib/competitors.py +198 -0
  513. package/skills/luckiest-trends/scripts/lib/cookie_extract.py +508 -0
  514. package/skills/luckiest-trends/scripts/lib/dates.py +169 -0
  515. package/skills/luckiest-trends/scripts/lib/dedupe.py +145 -0
  516. package/skills/luckiest-trends/scripts/lib/digg.py +440 -0
  517. package/skills/luckiest-trends/scripts/lib/entity_extract.py +127 -0
  518. package/skills/luckiest-trends/scripts/lib/env.py +1073 -0
  519. package/skills/luckiest-trends/scripts/lib/fanout.py +84 -0
  520. package/skills/luckiest-trends/scripts/lib/fusion.py +207 -0
  521. package/skills/luckiest-trends/scripts/lib/github.py +996 -0
  522. package/skills/luckiest-trends/scripts/lib/grounding.py +331 -0
  523. package/skills/luckiest-trends/scripts/lib/hackernews.py +357 -0
  524. package/skills/luckiest-trends/scripts/lib/health.py +92 -0
  525. package/skills/luckiest-trends/scripts/lib/hiring_signals.py +326 -0
  526. package/skills/luckiest-trends/scripts/lib/html_publish.py +73 -0
  527. package/skills/luckiest-trends/scripts/lib/html_render.py +738 -0
  528. package/skills/luckiest-trends/scripts/lib/http.py +372 -0
  529. package/skills/luckiest-trends/scripts/lib/instagram.py +521 -0
  530. package/skills/luckiest-trends/scripts/lib/jobs.py +708 -0
  531. package/skills/luckiest-trends/scripts/lib/linkedin.py +363 -0
  532. package/skills/luckiest-trends/scripts/lib/log.py +35 -0
  533. package/skills/luckiest-trends/scripts/lib/normalize.py +759 -0
  534. package/skills/luckiest-trends/scripts/lib/permission_preflight.py +242 -0
  535. package/skills/luckiest-trends/scripts/lib/perplexity.py +745 -0
  536. package/skills/luckiest-trends/scripts/lib/pinterest.py +154 -0
  537. package/skills/luckiest-trends/scripts/lib/pipeline.py +1720 -0
  538. package/skills/luckiest-trends/scripts/lib/planner.py +763 -0
  539. package/skills/luckiest-trends/scripts/lib/polymarket.py +794 -0
  540. package/skills/luckiest-trends/scripts/lib/preflight.py +119 -0
  541. package/skills/luckiest-trends/scripts/lib/providers.py +380 -0
  542. package/skills/luckiest-trends/scripts/lib/quality_nudge.py +383 -0
  543. package/skills/luckiest-trends/scripts/lib/query.py +202 -0
  544. package/skills/luckiest-trends/scripts/lib/reddit.py +731 -0
  545. package/skills/luckiest-trends/scripts/lib/reddit_arctic.py +92 -0
  546. package/skills/luckiest-trends/scripts/lib/reddit_enrich.py +322 -0
  547. package/skills/luckiest-trends/scripts/lib/reddit_keyless.py +329 -0
  548. package/skills/luckiest-trends/scripts/lib/reddit_listing.py +188 -0
  549. package/skills/luckiest-trends/scripts/lib/reddit_public.py +275 -0
  550. package/skills/luckiest-trends/scripts/lib/reddit_rss.py +224 -0
  551. package/skills/luckiest-trends/scripts/lib/reddit_shreddit.py +184 -0
  552. package/skills/luckiest-trends/scripts/lib/relevance.py +200 -0
  553. package/skills/luckiest-trends/scripts/lib/render.py +2130 -0
  554. package/skills/luckiest-trends/scripts/lib/rerank.py +708 -0
  555. package/skills/luckiest-trends/scripts/lib/resolve.py +345 -0
  556. package/skills/luckiest-trends/scripts/lib/safari_cookies.py +193 -0
  557. package/skills/luckiest-trends/scripts/lib/schema.py +319 -0
  558. package/skills/luckiest-trends/scripts/lib/setup_wizard.py +843 -0
  559. package/skills/luckiest-trends/scripts/lib/signals.py +334 -0
  560. package/skills/luckiest-trends/scripts/lib/skill_meta.py +33 -0
  561. package/skills/luckiest-trends/scripts/lib/snippet.py +51 -0
  562. package/skills/luckiest-trends/scripts/lib/subproc.py +116 -0
  563. package/skills/luckiest-trends/scripts/lib/techmeme.py +239 -0
  564. package/skills/luckiest-trends/scripts/lib/threads.py +207 -0
  565. package/skills/luckiest-trends/scripts/lib/tiktok.py +596 -0
  566. package/skills/luckiest-trends/scripts/lib/transcribe.py +235 -0
  567. package/skills/luckiest-trends/scripts/lib/trustpilot.py +277 -0
  568. package/skills/luckiest-trends/scripts/lib/truthsocial.py +162 -0
  569. package/skills/luckiest-trends/scripts/lib/ui.py +626 -0
  570. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/LICENSE +21 -0
  571. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/bird-search.mjs +147 -0
  572. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/cookies.js +220 -0
  573. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/features.json +17 -0
  574. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/paginate-cursor.js +37 -0
  575. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/query-ids.json +20 -0
  576. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/runtime-features.js +151 -0
  577. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/runtime-query-ids.js +264 -0
  578. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-base.js +129 -0
  579. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-constants.js +50 -0
  580. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-features.js +347 -0
  581. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-search.js +157 -0
  582. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-types.js +2 -0
  583. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-utils.js +511 -0
  584. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/package.json +13 -0
  585. package/skills/luckiest-trends/scripts/lib/web_fetch_keyless.py +105 -0
  586. package/skills/luckiest-trends/scripts/lib/web_search_keyless.py +158 -0
  587. package/skills/luckiest-trends/scripts/lib/xai_x.py +236 -0
  588. package/skills/luckiest-trends/scripts/lib/xiaohongshu_api.py +162 -0
  589. package/skills/luckiest-trends/scripts/lib/xquik.py +404 -0
  590. package/skills/luckiest-trends/scripts/lib/xurl_x.py +171 -0
  591. package/skills/luckiest-trends/scripts/lib/youtube_yt.py +1365 -0
  592. package/skills/luckiest-trends/scripts/setup-keychain.sh +123 -0
  593. package/skills/luckiest-trends/scripts/setup-pass.sh +132 -0
  594. package/skills/luckiest-trends/scripts/store.py +1020 -0
  595. package/skills/luckiest-trends/scripts/test-v1-vs-v2.sh +220 -0
  596. package/skills/luckiest-trends/scripts/test_device_auth.py +128 -0
  597. package/skills/luckiest-trends/scripts/verify_v3.py +195 -0
  598. package/skills/luckiest-trends/scripts/watchlist.py +318 -0
  599. package/skills/luckiest-video/ATTRIBUTION.md +27 -0
  600. package/skills/luckiest-video/CHANGELOG.md +23 -0
  601. package/skills/luckiest-video/SKILL.md +371 -0
  602. package/skills/luckiest-video/evals/evals.json +88 -0
  603. package/skills/luckiest-video/references/ai-video-prompting.md +175 -0
  604. package/skills/remix/SKILL.md +32 -0
  605. package/commands/luckiest/go.md +0 -45
  606. package/commands/luckiest/plan.md +0 -55
  607. /package/commands/{luckiest/charms.md → charms.md} +0 -0
  608. /package/commands/{luckiest/helpers.md → helpers.md} +0 -0
  609. /package/commands/{luckiest/home.md → home.md} +0 -0
  610. /package/commands/{luckiest/leaderboard.md → leaderboard.md} +0 -0
  611. /package/commands/{luckiest/merge.md → merge.md} +0 -0
  612. /package/commands/{luckiest/overlaps.md → overlaps.md} +0 -0
  613. /package/commands/{luckiest/skills.md → skills.md} +0 -0
  614. /package/commands/{luckiest/start.md → start.md} +0 -0
  615. /package/commands/{luckiest/status.md → status.md} +0 -0
  616. /package/commands/{luckiest/updates.md → updates.md} +0 -0
  617. /package/commands/{luckiest/vouch.md → vouch.md} +0 -0
  618. /package/commands/{luckiest/wishes.md → wishes.md} +0 -0
@@ -0,0 +1,738 @@
1
+ """HTML rendering for shareable last30days reports."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import html
6
+ import re
7
+ from datetime import date
8
+
9
+ from . import render, schema
10
+
11
+
12
+ PROSE_LABELS = [
13
+ ("What I learned:", "What I learned"),
14
+ ("KEY PATTERNS from the research:", "Key patterns from the research"),
15
+ ]
16
+
17
+ INVITATION_PATTERN = re.compile(r"^---\nI'm now an expert.*?Just ask\.$", re.MULTILINE | re.DOTALL)
18
+ EVIDENCE_BLOCK_PATTERN = re.compile(r"<!-- EVIDENCE FOR SYNTHESIS.*?<!-- END EVIDENCE FOR SYNTHESIS -->", re.DOTALL)
19
+ PASS_THROUGH_FOOTER_PATTERN = re.compile(r"<!-- PASS-THROUGH FOOTER.*?-->\n(.*?)<!-- END PASS-THROUGH FOOTER -->", re.DOTALL)
20
+ CANONICAL_BOUNDARY_PATTERN = re.compile(r"\n?---\n# END OF last30days CANONICAL OUTPUT.*$", re.DOTALL)
21
+ # render_for_html emits metadata as <!-- META: ... --> so it survives the
22
+ # markdown converter (which escapes raw HTML inside paragraphs). Promoted to
23
+ # a styled <div class="meta"> after conversion.
24
+ META_MARKER_PATTERN = re.compile(r"<!--\s*META:\s*(.*?)\s*-->")
25
+
26
+ CSS = """
27
+ :root {
28
+ --bg: #0e0e10;
29
+ --bg-elev: #18181b;
30
+ --fg: #fafafa;
31
+ --fg-muted: #a1a1aa;
32
+ --fg-subtle: #71717a;
33
+ --accent: #a855f7;
34
+ --accent-soft: #c4b5fd;
35
+ --border: #27272a;
36
+ --code-bg: #1a1a1d;
37
+ --max-w: 720px;
38
+ }
39
+
40
+ @media (prefers-color-scheme: light) {
41
+ :root {
42
+ --bg: #ffffff;
43
+ --bg-elev: #fafafa;
44
+ --fg: #18181b;
45
+ --fg-muted: #52525b;
46
+ --fg-subtle: #71717a;
47
+ --accent: #7c3aed;
48
+ --accent-soft: #6d28d9;
49
+ --border: #e4e4e7;
50
+ --code-bg: #f4f4f5;
51
+ }
52
+ }
53
+
54
+ * { box-sizing: border-box; }
55
+
56
+ html, body {
57
+ margin: 0;
58
+ padding: 0;
59
+ background: var(--bg);
60
+ color: var(--fg);
61
+ font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, system-ui, sans-serif;
62
+ font-size: 17px;
63
+ line-height: 1.65;
64
+ -webkit-font-smoothing: antialiased;
65
+ -moz-osx-font-smoothing: grayscale;
66
+ text-rendering: optimizeLegibility;
67
+ }
68
+
69
+ body {
70
+ max-width: var(--max-w);
71
+ margin: 0 auto;
72
+ padding: 4rem 1.5rem 6rem;
73
+ }
74
+
75
+ .badge {
76
+ display: inline-block;
77
+ padding: 0.4rem 0.85rem;
78
+ margin-bottom: 2.5rem;
79
+ background: var(--bg-elev);
80
+ border: 1px solid var(--border);
81
+ border-radius: 999px;
82
+ font-family: 'JetBrains Mono', ui-monospace, 'SF Mono', 'Cascadia Code', Menlo, Consolas, monospace;
83
+ font-size: 13px;
84
+ font-weight: 500;
85
+ color: var(--fg-muted);
86
+ letter-spacing: 0;
87
+ }
88
+
89
+ .badge .accent { color: var(--accent); }
90
+
91
+ .meta {
92
+ margin: -1.5rem 0 2.5rem;
93
+ color: var(--fg-subtle);
94
+ font-family: 'JetBrains Mono', ui-monospace, 'SF Mono', 'Cascadia Code', Menlo, Consolas, monospace;
95
+ font-size: 13px;
96
+ letter-spacing: 0.01em;
97
+ }
98
+
99
+ h1 {
100
+ margin: 0 0 1.5rem;
101
+ color: var(--fg);
102
+ font-size: 30px;
103
+ font-weight: 700;
104
+ line-height: 1.2;
105
+ letter-spacing: 0;
106
+ }
107
+
108
+ h2,
109
+ .prose-label {
110
+ margin: 2.75rem 0 1.25rem;
111
+ color: var(--fg);
112
+ font-size: 20px;
113
+ font-weight: 600;
114
+ line-height: 1.35;
115
+ letter-spacing: 0;
116
+ }
117
+
118
+ .badge + h2,
119
+ .badge + .prose-label { margin-top: 0.5rem; }
120
+
121
+ h3 {
122
+ margin: 2rem 0 0.85rem;
123
+ color: var(--fg);
124
+ font-size: 17px;
125
+ font-weight: 600;
126
+ line-height: 1.4;
127
+ letter-spacing: 0;
128
+ }
129
+
130
+ p {
131
+ margin: 0 0 1.4rem;
132
+ color: var(--fg-muted);
133
+ }
134
+
135
+ p strong,
136
+ li strong,
137
+ td strong {
138
+ color: var(--fg);
139
+ font-weight: 600;
140
+ }
141
+
142
+ a {
143
+ color: var(--accent);
144
+ text-decoration: none;
145
+ border-bottom: 1px solid transparent;
146
+ transition: border-color 0.15s ease;
147
+ }
148
+
149
+ a:hover { border-bottom-color: var(--accent); }
150
+
151
+ ul,
152
+ ol {
153
+ margin: 0 0 1.6rem;
154
+ padding-left: 1.5rem;
155
+ color: var(--fg-muted);
156
+ }
157
+
158
+ li {
159
+ margin: 0.6rem 0;
160
+ padding-left: 0.4rem;
161
+ }
162
+
163
+ li::marker {
164
+ color: var(--accent);
165
+ font-weight: 600;
166
+ }
167
+
168
+ blockquote {
169
+ margin: 1.5rem 0;
170
+ padding-left: 1rem;
171
+ border-left: 3px solid var(--accent);
172
+ color: var(--fg-muted);
173
+ }
174
+
175
+ hr {
176
+ margin: 2.5rem 0;
177
+ border: 0;
178
+ border-top: 1px solid var(--border);
179
+ }
180
+
181
+ code {
182
+ font-family: 'JetBrains Mono', ui-monospace, 'SF Mono', 'Cascadia Code', Menlo, Consolas, monospace;
183
+ font-size: 0.92em;
184
+ background: var(--code-bg);
185
+ padding: 0.15rem 0.4rem;
186
+ border-radius: 4px;
187
+ color: var(--accent-soft);
188
+ }
189
+
190
+ pre {
191
+ margin: 1.4rem 0;
192
+ background: var(--code-bg);
193
+ border: 1px solid var(--border);
194
+ border-radius: 8px;
195
+ padding: 1rem 1.25rem;
196
+ overflow-x: auto;
197
+ font-size: 14px;
198
+ line-height: 1.6;
199
+ }
200
+
201
+ pre code {
202
+ background: none;
203
+ padding: 0;
204
+ color: var(--fg);
205
+ }
206
+
207
+ table {
208
+ width: 100%;
209
+ border-collapse: collapse;
210
+ margin: 1.5rem 0;
211
+ font-size: 15px;
212
+ }
213
+
214
+ th,
215
+ td {
216
+ text-align: left;
217
+ padding: 0.75rem 1rem;
218
+ border-bottom: 1px solid var(--border);
219
+ vertical-align: top;
220
+ }
221
+
222
+ th {
223
+ color: var(--fg-muted);
224
+ font-weight: 600;
225
+ font-size: 13px;
226
+ letter-spacing: 0;
227
+ text-transform: uppercase;
228
+ }
229
+
230
+ td { color: var(--fg-muted); }
231
+ td:first-child { color: var(--fg); font-weight: 500; }
232
+
233
+ .engine-footer {
234
+ margin: 3rem 0 2.5rem;
235
+ padding: 1.25rem 1.5rem;
236
+ background: var(--bg-elev);
237
+ border: 1px solid var(--border);
238
+ border-radius: 8px;
239
+ color: var(--fg-muted);
240
+ }
241
+
242
+ .engine-footer pre {
243
+ margin: 0;
244
+ padding: 0;
245
+ background: transparent;
246
+ border: 0;
247
+ border-radius: 0;
248
+ font-family: 'JetBrains Mono', ui-monospace, 'SF Mono', 'Cascadia Code', Menlo, Consolas, monospace;
249
+ font-size: 13.5px;
250
+ font-weight: 400;
251
+ line-height: 1.75;
252
+ color: inherit;
253
+ white-space: pre-wrap;
254
+ word-break: break-word;
255
+ }
256
+
257
+ .colophon {
258
+ margin-top: 4rem;
259
+ padding-top: 2rem;
260
+ border-top: 1px solid var(--border);
261
+ color: var(--fg-subtle);
262
+ font-size: 13px;
263
+ font-family: 'JetBrains Mono', ui-monospace, 'SF Mono', 'Cascadia Code', Menlo, Consolas, monospace;
264
+ line-height: 1.7;
265
+ }
266
+
267
+ .colophon .rerun {
268
+ display: inline-block;
269
+ padding: 0.15rem 0.5rem;
270
+ margin-left: 0.25rem;
271
+ background: var(--code-bg);
272
+ border-radius: 4px;
273
+ color: var(--accent-soft);
274
+ font-size: 0.95em;
275
+ }
276
+
277
+ @media print {
278
+ :root {
279
+ --bg: #ffffff;
280
+ --bg-elev: #f5f5f5;
281
+ --fg: #000000;
282
+ --fg-muted: #1f2937;
283
+ --fg-subtle: #4b5563;
284
+ --accent: #6d28d9;
285
+ --accent-soft: #6d28d9;
286
+ --border: #d4d4d8;
287
+ --code-bg: #f4f4f5;
288
+ }
289
+
290
+ @page { size: A4; margin: 1.5cm 2cm; }
291
+
292
+ body {
293
+ max-width: none;
294
+ padding: 0;
295
+ font-size: 11pt;
296
+ }
297
+
298
+ a {
299
+ color: inherit;
300
+ border-bottom: 0;
301
+ text-decoration: underline;
302
+ }
303
+
304
+ a[href]::after {
305
+ content: " (" attr(href) ")";
306
+ font-size: 0.85em;
307
+ color: var(--fg-subtle);
308
+ }
309
+
310
+ .engine-footer { page-break-inside: avoid; }
311
+ }
312
+
313
+ @media (max-width: 600px) {
314
+ body {
315
+ padding: 2.5rem 1.25rem 4rem;
316
+ font-size: 16px;
317
+ }
318
+
319
+ h1 { font-size: 25px; }
320
+ .badge { font-size: 12px; }
321
+ th, td { padding: 0.65rem 0.5rem; }
322
+ }
323
+ """.strip()
324
+
325
+ HTML_TEMPLATE = """<!DOCTYPE html>
326
+ <html lang="en">
327
+ <head>
328
+ <meta charset="utf-8">
329
+ <meta name="viewport" content="width=device-width, initial-scale=1">
330
+ <title>last30days · __TITLE__</title>
331
+ <style>
332
+ __CSS__
333
+ </style>
334
+ </head>
335
+ <body>
336
+ __BODY__
337
+ __COLOPHON__
338
+ </body>
339
+ </html>
340
+ """
341
+
342
+
343
+ def render_html(
344
+ report: schema.Report,
345
+ *,
346
+ fun_level: str = "medium",
347
+ save_path: str | None = None,
348
+ synthesis_md: str | None = None,
349
+ ) -> str:
350
+ _ = fun_level
351
+ md = render.render_for_html(report, synthesis_md=synthesis_md, save_path=save_path)
352
+ md = _strip_evidence_block(md)
353
+ md = _strip_invitation(md)
354
+ md = _strip_canonical_boundary(md)
355
+ md = _promote_prose_labels(md)
356
+ body = _markdown_to_html(md)
357
+ body = _wrap_engine_footer(body)
358
+ body = _promote_meta_marker(body)
359
+ colophon = _build_colophon(report)
360
+ return _wrap_in_template(body, colophon, report.topic)
361
+
362
+
363
+ def render_html_comparison(
364
+ entity_reports: list[tuple[str, schema.Report]],
365
+ *,
366
+ fun_level: str = "medium",
367
+ save_path: str | None = None,
368
+ synthesis_md: str | None = None,
369
+ ) -> str:
370
+ _ = fun_level
371
+ md = render.render_for_html_comparison(
372
+ entity_reports, synthesis_md=synthesis_md, save_path=save_path,
373
+ )
374
+ md = _strip_evidence_block(md)
375
+ md = _strip_invitation(md)
376
+ md = _strip_canonical_boundary(md)
377
+ md = _promote_prose_labels(md)
378
+ body = _markdown_to_html(md)
379
+ body = _wrap_engine_footer(body)
380
+ body = _promote_meta_marker(body)
381
+ topic = " vs ".join(label for label, _ in entity_reports)
382
+ colophon = _build_colophon(entity_reports[0][1], topic=topic)
383
+ return _wrap_in_template(body, colophon, topic)
384
+
385
+
386
+ def _strip_evidence_block(md: str) -> str:
387
+ return EVIDENCE_BLOCK_PATTERN.sub("", md)
388
+
389
+
390
+ def _strip_invitation(md: str) -> str:
391
+ return INVITATION_PATTERN.sub("", md)
392
+
393
+
394
+ def _strip_canonical_boundary(md: str) -> str:
395
+ return CANONICAL_BOUNDARY_PATTERN.sub("", md)
396
+
397
+
398
+ def _promote_prose_labels(md: str) -> str:
399
+ for source, normalized in PROSE_LABELS:
400
+ md = re.sub(
401
+ rf"^{re.escape(source)}$",
402
+ f"## {normalized}",
403
+ md,
404
+ flags=re.MULTILINE,
405
+ )
406
+ return md
407
+
408
+
409
+ def _markdown_to_html(md: str) -> str:
410
+ md, footers = _protect_engine_footers(md)
411
+ global _ENGINE_FOOTER_STORE
412
+ _ENGINE_FOOTER_STORE = footers
413
+ # Strip HTML comments EXCEPT preserved markers used for post-processing
414
+ # (META is promoted to <div class="meta"> after markdown conversion).
415
+ md = re.sub(r"<!--(?!\s*META:).*?-->", "", md, flags=re.DOTALL)
416
+ lines = md.splitlines()
417
+ out: list[str] = []
418
+ paragraph: list[str] = []
419
+ list_type: str | None = None
420
+ in_code = False
421
+ code_lines: list[str] = []
422
+ index = 0
423
+
424
+ def flush_paragraph() -> None:
425
+ nonlocal paragraph
426
+ if paragraph:
427
+ text = " ".join(part.strip() for part in paragraph).strip()
428
+ if text:
429
+ out.append(f"<p>{_inline_markdown(text)}</p>")
430
+ paragraph = []
431
+
432
+ def close_list() -> None:
433
+ nonlocal list_type
434
+ if list_type:
435
+ out.append(f"</{list_type}>")
436
+ list_type = None
437
+
438
+ while index < len(lines):
439
+ line = lines[index]
440
+ stripped = line.strip()
441
+
442
+ if in_code:
443
+ if stripped.startswith("```"):
444
+ out.append(f"<pre><code>{html.escape(chr(10).join(code_lines))}</code></pre>")
445
+ code_lines = []
446
+ in_code = False
447
+ else:
448
+ code_lines.append(line)
449
+ index += 1
450
+ continue
451
+
452
+ if stripped.startswith("```"):
453
+ flush_paragraph()
454
+ close_list()
455
+ in_code = True
456
+ code_lines = []
457
+ index += 1
458
+ continue
459
+
460
+ if stripped in footers:
461
+ flush_paragraph()
462
+ close_list()
463
+ out.append(stripped)
464
+ index += 1
465
+ continue
466
+
467
+ if not stripped:
468
+ flush_paragraph()
469
+ close_list()
470
+ index += 1
471
+ continue
472
+
473
+ if stripped == "---":
474
+ flush_paragraph()
475
+ close_list()
476
+ out.append("<hr>")
477
+ index += 1
478
+ continue
479
+
480
+ if index + 1 < len(lines) and _is_table_row(stripped) and _is_table_separator(lines[index + 1].strip()):
481
+ flush_paragraph()
482
+ close_list()
483
+ table_lines = [stripped]
484
+ index += 2
485
+ while index < len(lines) and _is_table_row(lines[index].strip()):
486
+ table_lines.append(lines[index].strip())
487
+ index += 1
488
+ out.append(_render_table(table_lines))
489
+ continue
490
+
491
+ heading = re.match(r"^(#{1,4})\s+(.+)$", stripped)
492
+ if heading:
493
+ flush_paragraph()
494
+ close_list()
495
+ level = min(len(heading.group(1)), 3)
496
+ out.append(f"<h{level}>{_inline_markdown(heading.group(2))}</h{level}>")
497
+ index += 1
498
+ continue
499
+
500
+ if stripped.startswith(">"):
501
+ flush_paragraph()
502
+ close_list()
503
+ quote_lines = []
504
+ while index < len(lines) and lines[index].strip().startswith(">"):
505
+ quote_lines.append(lines[index].strip().lstrip(">").strip())
506
+ index += 1
507
+ out.append(f"<blockquote>{_inline_markdown(' '.join(quote_lines))}</blockquote>")
508
+ continue
509
+
510
+ unordered = re.match(r"^[-*]\s+(.+)$", stripped)
511
+ ordered = re.match(r"^\d+[.)]\s+(.+)$", stripped)
512
+ if unordered or ordered:
513
+ flush_paragraph()
514
+ next_type = "ul" if unordered else "ol"
515
+ if list_type != next_type:
516
+ close_list()
517
+ out.append(f"<{next_type}>")
518
+ list_type = next_type
519
+ item = unordered.group(1) if unordered else ordered.group(1)
520
+ out.append(f"<li>{_inline_markdown(item)}</li>")
521
+ index += 1
522
+ continue
523
+
524
+ if stripped.startswith("🌐 luckiest-trends"):
525
+ flush_paragraph()
526
+ close_list()
527
+ badge_text = _inline_markdown(stripped.removeprefix("🌐").strip())
528
+ out.append(f'<div class="badge"><span class="accent">🌐</span> {badge_text}</div>')
529
+ index += 1
530
+ continue
531
+
532
+ paragraph.append(line)
533
+ index += 1
534
+
535
+ if in_code:
536
+ out.append(f"<pre><code>{html.escape(chr(10).join(code_lines))}</code></pre>")
537
+ flush_paragraph()
538
+ close_list()
539
+ return "\n".join(out).strip()
540
+
541
+
542
+ def _protect_engine_footers(md: str) -> tuple[str, dict[str, str]]:
543
+ footers: dict[str, str] = {}
544
+
545
+ def replace(match: re.Match[str]) -> str:
546
+ token = f"__LAST30DAYS_ENGINE_FOOTER_{len(footers)}__"
547
+ footers[token] = match.group(1).strip("\n")
548
+ return f"\n{token}\n"
549
+
550
+ return PASS_THROUGH_FOOTER_PATTERN.sub(replace, md), footers
551
+
552
+
553
+ def _wrap_engine_footer(body: str) -> str:
554
+ def replace(match: re.Match[str]) -> str:
555
+ footer = html.escape(_ENGINE_FOOTER_STORE.get(match.group(0), ""), quote=False)
556
+ return f'<div class="engine-footer"><pre>{footer}</pre></div>'
557
+
558
+ return re.sub(
559
+ r"__LAST30DAYS_ENGINE_FOOTER_\d+__",
560
+ replace,
561
+ body,
562
+ )
563
+
564
+
565
+ def _promote_meta_marker(body: str) -> str:
566
+ """Promote ``<!-- META: ... -->`` markers into a styled ``<div class="meta">``.
567
+
568
+ The marker is preserved through the comment-strip pass (see
569
+ _markdown_to_html exemption) but the markdown converter wraps it in
570
+ ``<p>`` and HTML-escapes the angle brackets. After conversion the body
571
+ contains shapes like:
572
+ <p>&lt;!-- META: TEXT --&gt;</p>
573
+ <p><!-- META: TEXT --></p> (when not escaped)
574
+ Both collapse to ``<div class="meta">TEXT</div>``.
575
+ """
576
+ def replace(match: re.Match[str]) -> str:
577
+ # The marker survives the comment-strip pass, and the markdown reaching
578
+ # this point can include LLM-synthesized content derived from untrusted
579
+ # web/social bodies. The escaped-form branches below carry text the
580
+ # markdown pass already entity-escaped, while the raw-form fallbacks do
581
+ # not — so normalize with unescape, then escape exactly once. A crafted
582
+ # `<!-- META: <img src=x onerror=...> -->` thus cannot render as live
583
+ # markup in the saved, shareable HTML artifact, and legitimate
584
+ # date/source-name markers render unchanged.
585
+ text = html.escape(html.unescape(match.group(1).strip()))
586
+ return f'<div class="meta">{text}</div>'
587
+
588
+ # Escaped form (most common after markdown conversion)
589
+ body = re.sub(
590
+ r"<p>\s*&lt;!--\s*META:\s*(.*?)\s*--&gt;\s*</p>",
591
+ replace,
592
+ body,
593
+ )
594
+ body = re.sub(r"&lt;!--\s*META:\s*(.*?)\s*--&gt;", replace, body)
595
+ # Unescaped form (paranoid fallback)
596
+ body = re.sub(r"<p>\s*<!--\s*META:\s*(.*?)\s*-->\s*</p>", replace, body)
597
+ body = re.sub(r"<!--\s*META:\s*(.*?)\s*-->", replace, body)
598
+ return body
599
+
600
+
601
+ _ENGINE_FOOTER_STORE: dict[str, str] = {}
602
+
603
+ # Schemes allowed in synthesized markdown links. The HTML artifact is opened in
604
+ # a browser, so a permissive link parser exposes a stored-XSS vector: a
605
+ # `[label](javascript:...)` or `[label](data:text/html,...)` link surviving the
606
+ # LLM synthesis would render as a clickable script payload in the saved file.
607
+ # Restrict link URLs to a small allowlist of schemes and accept relative URLs
608
+ # (no scheme, no `:` before the first `/` or `?`). Anything else is rendered as
609
+ # plain bracketed text so the label remains readable.
610
+ _SAFE_LINK_SCHEMES = frozenset({"http", "https", "mailto"})
611
+
612
+
613
+ def _is_safe_link_url(url: str) -> bool:
614
+ """Return True if a markdown link URL is safe to render as an `<a href>`.
615
+
616
+ A URL is safe if it either:
617
+ - has no scheme (relative URL, fragment, or path-only), or
618
+ - uses a scheme in the allowlist (http, https, mailto).
619
+
620
+ The scheme check is case-insensitive and tolerant of surrounding
621
+ whitespace per RFC 3986.
622
+
623
+ Precondition: ``url`` must already have been through ``html.escape`` (as it
624
+ is at the sole caller in ``_inline_markdown``). The safety of the no-scheme
625
+ branch relies on ``&`` having been escaped to ``&amp;`` so an entity-encoded
626
+ colon like ``&#58;`` cannot survive into the rendered ``href`` and be
627
+ decoded back to ``:`` by the browser. Passing a *raw* URL here (e.g.
628
+ ``javascript&#58;alert(1)``) would see no literal ``:``, return ``True``,
629
+ and emit a clickable payload — do not call this on un-escaped input.
630
+ """
631
+ stripped = url.strip()
632
+ if not stripped:
633
+ return False
634
+ # Reject any control characters (e.g. `java\x0Dscript:` where a bare CR is
635
+ # smuggled into the scheme name and stripped by the browser's URL parser).
636
+ if any(ord(ch) < 0x20 for ch in stripped):
637
+ return False
638
+ # No scheme — relative URL or fragment. Allow.
639
+ colon = stripped.find(":")
640
+ if colon == -1:
641
+ return True
642
+ slash = stripped.find("/")
643
+ question = stripped.find("?")
644
+ hash_ = stripped.find("#")
645
+ # The first `:` that comes after a `/`, `?`, or `#` is path/query/fragment,
646
+ # not a scheme separator. e.g. `/path:with:colons` is a relative URL.
647
+ earlier = [pos for pos in (slash, question, hash_) if 0 <= pos < colon]
648
+ if earlier:
649
+ return True
650
+ scheme = stripped[:colon].lower()
651
+ return scheme in _SAFE_LINK_SCHEMES
652
+
653
+
654
+ def _inline_markdown(text: str) -> str:
655
+ escaped = html.escape(text, quote=True)
656
+ code_tokens: dict[str, str] = {}
657
+
658
+ def code_replace(match: re.Match[str]) -> str:
659
+ token = f"__CODE_{len(code_tokens)}__"
660
+ code_tokens[token] = f"<code>{match.group(1)}</code>"
661
+ return token
662
+
663
+ escaped = re.sub(r"`([^`]+)`", code_replace, escaped)
664
+ escaped = re.sub(r"\*\*([^*]+)\*\*", r"<strong>\1</strong>", escaped)
665
+
666
+ def link_replace(match: re.Match[str]) -> str:
667
+ label = match.group(1)
668
+ url = match.group(2)
669
+ # `url` is HTML-escaped (so `"` is `&quot;`, etc.) but
670
+ # `html.unescape` decoding before the scheme check would let a
671
+ # `javascript&#58;alert(1)` payload through. Inspect the literal
672
+ # bytes the regex captured instead — that matches what the browser
673
+ # ultimately sees in the href attribute.
674
+ if not _is_safe_link_url(url):
675
+ return f"[{label}]({url})"
676
+ return f'<a href="{url}" rel="noopener noreferrer">{label}</a>'
677
+
678
+ escaped = re.sub(r"\[([^\]]+)\]\(([^)\s]+)\)", link_replace, escaped)
679
+ for token, value in code_tokens.items():
680
+ escaped = escaped.replace(token, value)
681
+ return escaped
682
+
683
+
684
+ def _is_table_row(line: str) -> bool:
685
+ return "|" in line and len(_split_table_cells(line)) >= 2
686
+
687
+
688
+ def _is_table_separator(line: str) -> bool:
689
+ cells = _split_table_cells(line)
690
+ return bool(cells) and all(re.fullmatch(r":?-{3,}:?", cell.strip()) for cell in cells)
691
+
692
+
693
+ def _split_table_cells(line: str) -> list[str]:
694
+ return [cell.strip() for cell in line.strip().strip("|").split("|")]
695
+
696
+
697
+ def _render_table(rows: list[str]) -> str:
698
+ header = _split_table_cells(rows[0])
699
+ body_rows = [_split_table_cells(row) for row in rows[1:]]
700
+ out = ["<table>", "<thead>", "<tr>"]
701
+ out.extend(f"<th>{_inline_markdown(cell)}</th>" for cell in header)
702
+ out.extend(["</tr>", "</thead>", "<tbody>"])
703
+ for row in body_rows:
704
+ out.append("<tr>")
705
+ out.extend(f"<td>{_inline_markdown(cell)}</td>" for cell in row)
706
+ out.append("</tr>")
707
+ out.extend(["</tbody>", "</table>"])
708
+ return "\n".join(out)
709
+
710
+
711
+ def _build_colophon(report: schema.Report, *, topic: str | None = None) -> str:
712
+ display_topic = topic or report.topic
713
+ generated = _generated_date(report)
714
+ version = render._skill_version()
715
+ escaped_topic = html.escape(display_topic)
716
+ rerun = html.escape(f"/last30days {display_topic}")
717
+ return (
718
+ '<div class="colophon">\n'
719
+ f" Generated {generated} by /last30days v{html.escape(version)} · topic: {escaped_topic}<br>\n"
720
+ f' Re-run for fresh data: <span class="rerun">{rerun}</span>\n'
721
+ "</div>"
722
+ )
723
+
724
+
725
+ def _generated_date(report: schema.Report) -> str:
726
+ if report.generated_at:
727
+ return report.generated_at[:10]
728
+ return date.today().strftime("%Y-%m-%d")
729
+
730
+
731
+ def _wrap_in_template(body: str, colophon: str, title: str) -> str:
732
+ return (
733
+ HTML_TEMPLATE
734
+ .replace("__TITLE__", html.escape(title))
735
+ .replace("__CSS__", CSS)
736
+ .replace("__BODY__", body)
737
+ .replace("__COLOPHON__", colophon)
738
+ )