luckiest-co 1.0.0 → 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 +7 -5
  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 +16 -5
  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,145 @@
1
+ """Within-source near-duplicate detection."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import re
6
+
7
+ from . import cjk, schema
8
+
9
+ STOPWORDS = frozenset(
10
+ {
11
+ "the",
12
+ "a",
13
+ "an",
14
+ "to",
15
+ "for",
16
+ "how",
17
+ "is",
18
+ "in",
19
+ "of",
20
+ "on",
21
+ "and",
22
+ "with",
23
+ "from",
24
+ "by",
25
+ "at",
26
+ "this",
27
+ "that",
28
+ "it",
29
+ "what",
30
+ "are",
31
+ "do",
32
+ "can",
33
+ }
34
+ ) | cjk.CHINESE_STOPWORDS
35
+
36
+
37
+ def normalize_text(text: str) -> str:
38
+ text = re.sub(r"[^\w\s]", " ", text.lower())
39
+ return re.sub(r"\s+", " ", text).strip()
40
+
41
+
42
+ def _ngrams_of_normalized(norm: str, n: int = 3) -> set[str]:
43
+ if len(norm) < n:
44
+ return {norm} if norm else set()
45
+ return {norm[index:index + n] for index in range(len(norm) - n + 1)}
46
+
47
+
48
+ def get_ngrams(text: str, n: int = 3) -> set[str]:
49
+ return _ngrams_of_normalized(normalize_text(text), n)
50
+
51
+
52
+ def jaccard_similarity(left: set[str], right: set[str]) -> float:
53
+ if not left or not right:
54
+ return 0.0
55
+ union = left | right
56
+ if not union:
57
+ return 0.0
58
+ return len(left & right) / len(union)
59
+
60
+
61
+ def token_jaccard(text_a: str, text_b: str) -> float:
62
+ tokens_a = {
63
+ token
64
+ for token in cjk.segment(normalize_text(text_a))
65
+ if len(token) > 1 and token not in STOPWORDS
66
+ }
67
+ tokens_b = {
68
+ token
69
+ for token in cjk.segment(normalize_text(text_b))
70
+ if len(token) > 1 and token not in STOPWORDS
71
+ }
72
+ return jaccard_similarity(tokens_a, tokens_b)
73
+
74
+
75
+ def hybrid_similarity(text_a: str, text_b: str) -> float:
76
+ return max(
77
+ jaccard_similarity(get_ngrams(text_a), get_ngrams(text_b)),
78
+ token_jaccard(text_a, text_b),
79
+ )
80
+
81
+
82
+ def _tokenize(normalized: str) -> frozenset[str]:
83
+ return frozenset(
84
+ tok for tok in cjk.segment(normalized)
85
+ if len(tok) > 1 and tok not in STOPWORDS
86
+ )
87
+
88
+
89
+ class _PreparedText:
90
+ """Pre-computed text representations for fast repeated similarity checks."""
91
+
92
+ __slots__ = ("ngrams", "tokens")
93
+
94
+ def __init__(self, raw: str) -> None:
95
+ norm = normalize_text(raw)
96
+ self.ngrams = _ngrams_of_normalized(norm)
97
+ self.tokens = _tokenize(norm)
98
+
99
+
100
+ def prepared_similarity(a: _PreparedText, b: _PreparedText) -> float:
101
+ return max(
102
+ jaccard_similarity(a.ngrams, b.ngrams),
103
+ jaccard_similarity(a.tokens, b.tokens),
104
+ )
105
+
106
+
107
+ def item_text(item: schema.SourceItem) -> str:
108
+ parts = [item.title, item.body, item.author or "", item.container or ""]
109
+ return " ".join(part for part in parts if part).strip()
110
+
111
+
112
+ def dedupe_items(items: list[schema.SourceItem], threshold: float = 0.7) -> list[schema.SourceItem]:
113
+ """Remove near-duplicates while keeping earlier, better-scored items.
114
+
115
+ Jobs are deduped by exact URL only: distinct postings on the same careers
116
+ board share heavy boilerplate (company intro, "TL;DR", benefits) that trips
117
+ fuzzy text similarity and collapses unrelated roles (a 26-role board fell to
118
+ 7). A unique posting URL is an unambiguous identity, so use it instead.
119
+ """
120
+ kept: list[schema.SourceItem] = []
121
+ kept_prepared: list[_PreparedText] = []
122
+ seen_job_urls: set[str] = set()
123
+ for item in items:
124
+ if item.source == "jobs":
125
+ url = (item.url or "").strip()
126
+ if url and url in seen_job_urls:
127
+ continue
128
+ if url:
129
+ seen_job_urls.add(url)
130
+ kept.append(item)
131
+ continue
132
+ text = item_text(item)
133
+ if not text:
134
+ kept.append(item)
135
+ continue
136
+ prep = _PreparedText(text)
137
+ is_duplicate = False
138
+ for existing_prep in kept_prepared:
139
+ if prepared_similarity(prep, existing_prep) >= threshold:
140
+ is_duplicate = True
141
+ break
142
+ if not is_duplicate:
143
+ kept.append(item)
144
+ kept_prepared.append(prep)
145
+ return kept
@@ -0,0 +1,440 @@
1
+ """Digg AI 1000 source for last30days.
2
+
3
+ Shells out to ``digg-pp-cli`` (read-only, no auth required) to surface
4
+ clustered stories curated from ~1000 high-signal AI accounts on X. Each
5
+ cluster carries a published TLDR, a curatorial rank, and a list of X
6
+ posts that can be fetched as inline quotes.
7
+
8
+ Activation gate: this source is only available when ``digg-pp-cli`` is
9
+ on PATH. ``pipeline.available_sources`` checks ``shutil.which`` before
10
+ including ``digg`` in the source list. The functions below also detect
11
+ the missing-binary case as a defensive fallback.
12
+
13
+ Primary path: ``digg-pp-cli search <topic> --since 30d --agent --limit N``.
14
+ Optional enrichment: ``digg-pp-cli posts <clusterUrlId> --agent --by rank
15
+ --limit M`` for the top K clusters in default/deep depth, attaching the
16
+ top-ranked X posts to each cluster's ``posts`` field.
17
+ """
18
+
19
+ from __future__ import annotations
20
+
21
+ import json
22
+ import shutil
23
+ from datetime import datetime, timedelta, timezone
24
+ from typing import Any, Dict, List, Optional
25
+ from urllib.parse import urlparse
26
+
27
+ from . import log, subproc
28
+ from .relevance import token_overlap_relevance
29
+
30
+
31
+ CLI_BIN = "digg-pp-cli"
32
+
33
+ # Per-depth knobs.
34
+ DEPTH_CONFIG = {
35
+ "quick": 8,
36
+ "default": 20,
37
+ "deep": 40,
38
+ }
39
+
40
+ # How many top-ranked clusters get post enrichment, per depth. Quick mode
41
+ # skips enrichment to keep latency low (clusters already carry a TLDR).
42
+ ENRICH_CONFIG = {
43
+ "quick": 0,
44
+ "default": 3,
45
+ "deep": 5,
46
+ }
47
+
48
+ # X posts pulled per enriched cluster. Matches the 5-comment cap used by
49
+ # Reddit/HN/YouTube/TikTok/GitHub enrichment.
50
+ POSTS_PER_CLUSTER = 5
51
+
52
+ SEARCH_TIMEOUT = 30
53
+ POSTS_TIMEOUT = 15
54
+
55
+
56
+ def _log(msg: str) -> None:
57
+ log.source_log("Digg", msg, tty_only=False)
58
+
59
+
60
+ def _is_available() -> bool:
61
+ """True when the digg-pp-cli binary is on PATH."""
62
+ return shutil.which(CLI_BIN) is not None
63
+
64
+
65
+ def _today() -> datetime:
66
+ return datetime.now(timezone.utc)
67
+
68
+
69
+ def _parse_first_post_age(age: Optional[str], today: Optional[datetime] = None) -> Optional[str]:
70
+ """Convert a digg firstPostAge token (e.g. '5d', '17d', '5h', '1w', '1m')
71
+ into a YYYY-MM-DD string. Returns None when the value is outside the
72
+ last-30-day window or cannot be parsed.
73
+
74
+ Digg uses minutes-symbol-collision for 'months' (per agent-context:
75
+ 'Nh, Nd, Nw, Nm (e.g. 30d, 1w, 12h, 1m)'), so 'Nm' is months ~30 days.
76
+ """
77
+ if not age or not isinstance(age, str):
78
+ return None
79
+ age = age.strip().lower()
80
+ if len(age) < 2:
81
+ return None
82
+ unit = age[-1]
83
+ try:
84
+ amount = int(age[:-1])
85
+ except (ValueError, TypeError):
86
+ return None
87
+ if amount < 0:
88
+ return None
89
+
90
+ base = today or _today()
91
+
92
+ if unit == "h":
93
+ delta = timedelta(hours=amount)
94
+ elif unit == "d":
95
+ delta = timedelta(days=amount)
96
+ elif unit == "w":
97
+ delta = timedelta(weeks=amount)
98
+ elif unit == "m":
99
+ delta = timedelta(days=amount * 30)
100
+ else:
101
+ return None
102
+
103
+ if delta > timedelta(days=30):
104
+ return None
105
+
106
+ point = base - delta
107
+ return point.date().isoformat()
108
+
109
+
110
+ def _build_search_args(query: str, limit: int) -> List[str]:
111
+ return [
112
+ CLI_BIN,
113
+ "search",
114
+ query,
115
+ "--since",
116
+ "30d",
117
+ "--agent",
118
+ "--limit",
119
+ str(limit),
120
+ ]
121
+
122
+
123
+ def _build_posts_args(cluster_url_id: str, posts_per: int) -> List[str]:
124
+ return [
125
+ CLI_BIN,
126
+ "posts",
127
+ cluster_url_id,
128
+ "--agent",
129
+ "--by",
130
+ "rank",
131
+ "--limit",
132
+ str(posts_per),
133
+ ]
134
+
135
+
136
+ def _run_cli(cmd: List[str], timeout: int) -> Dict[str, Any]:
137
+ """Invoke digg-pp-cli and parse the JSON envelope.
138
+
139
+ Returns ``{"results": [...]}`` on success, ``{"results": [], "error": "..."}``
140
+ on failure. Never raises; the pipeline relies on shape consistency.
141
+ """
142
+ if not _is_available():
143
+ return {"results": [], "error": f"{CLI_BIN} not on PATH"}
144
+ try:
145
+ result = subproc.run_with_timeout(cmd, timeout=timeout)
146
+ except subproc.SubprocTimeout as exc:
147
+ _log(f"Timeout: {exc}")
148
+ return {"results": [], "error": str(exc)}
149
+ except FileNotFoundError as exc:
150
+ _log(f"Binary missing: {exc}")
151
+ return {"results": [], "error": str(exc)}
152
+ except OSError as exc:
153
+ _log(f"Spawn failed: {exc}")
154
+ return {"results": [], "error": str(exc)}
155
+
156
+ if result.returncode != 0:
157
+ snippet = (result.stderr or "").strip().splitlines()[:1]
158
+ first = snippet[0] if snippet else f"exit {result.returncode}"
159
+ _log(f"CLI exit {result.returncode}: {first}")
160
+ return {"results": [], "error": first}
161
+
162
+ stdout = result.stdout or ""
163
+ if not stdout.strip():
164
+ return {"results": []}
165
+ try:
166
+ data = json.loads(stdout)
167
+ except json.JSONDecodeError as exc:
168
+ _log(f"JSON decode failed: {exc}")
169
+ return {"results": [], "error": f"json decode: {exc}"}
170
+
171
+ if not isinstance(data, dict):
172
+ return {"results": []}
173
+ results = data.get("results")
174
+ if not isinstance(results, list):
175
+ return {"results": []}
176
+ return data
177
+
178
+
179
+ def search_digg(
180
+ topic: str,
181
+ from_date: str,
182
+ to_date: str,
183
+ depth: str = "default",
184
+ ) -> Dict[str, Any]:
185
+ """Search Digg AI 1000 clusters via digg-pp-cli.
186
+
187
+ Args:
188
+ topic: search query.
189
+ from_date: YYYY-MM-DD start (advisory; --since 30d is the actual filter).
190
+ to_date: YYYY-MM-DD end (advisory; same).
191
+ depth: 'quick' | 'default' | 'deep'.
192
+
193
+ Returns:
194
+ Dict with ``results`` list. On failure, ``results`` is empty and an
195
+ ``error`` key carries a one-line description.
196
+ """
197
+ limit = DEPTH_CONFIG.get(depth, DEPTH_CONFIG["default"])
198
+ if not topic or not topic.strip():
199
+ return {"results": []}
200
+ cmd = _build_search_args(topic, limit)
201
+ _log(f"search '{topic}' (limit={limit}, since=30d)")
202
+ response = _run_cli(cmd, timeout=SEARCH_TIMEOUT)
203
+ n = len(response.get("results") or [])
204
+ _log(f"found {n} clusters")
205
+ return response
206
+
207
+
208
+ def _build_url(cluster_url_id: str) -> str:
209
+ return f"https://di.gg/ai/{cluster_url_id}"
210
+
211
+
212
+ def _rank_score(rank: Optional[int]) -> float:
213
+ """Convert Digg rank (lower is better, top 50 are notable) into a
214
+ positive engagement-style signal in [0, 50]. Anything off the top-50
215
+ leaderboard contributes 0.
216
+ """
217
+ if rank is None:
218
+ return 0.0
219
+ try:
220
+ r = int(rank)
221
+ except (TypeError, ValueError):
222
+ return 0.0
223
+ if r < 1 or r > 50:
224
+ return 0.0
225
+ return float(51 - r)
226
+
227
+
228
+ def parse_digg_response(
229
+ response: Dict[str, Any],
230
+ query: str = "",
231
+ ) -> List[Dict[str, Any]]:
232
+ """Parse a digg search envelope into normalized item dicts.
233
+
234
+ Args:
235
+ response: payload from ``search_digg``.
236
+ query: original search query, used for token-overlap relevance.
237
+
238
+ Returns:
239
+ List of dicts ready for ``normalize._normalize_digg``.
240
+ """
241
+ raw = response.get("results") if isinstance(response, dict) else None
242
+ if not isinstance(raw, list):
243
+ return []
244
+
245
+ items: List[Dict[str, Any]] = []
246
+ for i, cluster in enumerate(raw):
247
+ if not isinstance(cluster, dict):
248
+ continue
249
+ cluster_url_id = cluster.get("clusterUrlId")
250
+ if not cluster_url_id:
251
+ continue
252
+
253
+ title = str(cluster.get("title") or "").strip()
254
+ tldr = str(cluster.get("tldr") or "").strip()
255
+ rank = cluster.get("rank")
256
+ post_count = cluster.get("postCount") or 0
257
+ unique_authors = cluster.get("uniqueAuthors") or 0
258
+ first_post_age = cluster.get("firstPostAge")
259
+ date_str = _parse_first_post_age(first_post_age)
260
+ if date_str is None and first_post_age:
261
+ # firstPostAge present but outside 30d -> drop; last30days contract.
262
+ continue
263
+
264
+ rank_decay = max(0.3, 1.0 - (i * 0.02))
265
+ if query:
266
+ content_score = token_overlap_relevance(query, f"{title} {tldr}".strip())
267
+ else:
268
+ content_score = 0.5
269
+ rank_boost = min(0.2, _rank_score(rank) / 250.0)
270
+ relevance = min(1.0, 0.55 * rank_decay + 0.35 * content_score + rank_boost)
271
+
272
+ items.append(
273
+ {
274
+ "id": str(cluster_url_id),
275
+ "title": title or f"Digg cluster {i + 1}",
276
+ "url": _build_url(str(cluster_url_id)),
277
+ "tldr": tldr,
278
+ "author": "",
279
+ "date": date_str,
280
+ "engagement": {
281
+ "postCount": int(post_count) if isinstance(post_count, (int, float)) else 0,
282
+ "uniqueAuthors": int(unique_authors) if isinstance(unique_authors, (int, float)) else 0,
283
+ "rank": int(rank) if isinstance(rank, (int, float)) else None,
284
+ "rank_score": _rank_score(rank),
285
+ },
286
+ "first_post_age": first_post_age,
287
+ "posts": [],
288
+ "relevance": round(relevance, 2),
289
+ "why_relevant": (
290
+ f"Digg cluster (rank {rank}, {post_count} posts, {unique_authors} authors)"
291
+ if rank is not None
292
+ else f"Digg cluster ({post_count} posts, {unique_authors} authors)"
293
+ ),
294
+ }
295
+ )
296
+
297
+ return items
298
+
299
+
300
+ def _is_safe_http_url(url: str) -> bool:
301
+ """True iff ``url`` parses with an http or https scheme.
302
+
303
+ Used to reject upstream-supplied post URLs whose scheme would be
304
+ dangerous in a rendered ``<a href>`` (``javascript:``, ``data:``,
305
+ ``file:``, ``vbscript:``, ``about:``).
306
+ """
307
+ try:
308
+ scheme = urlparse(url).scheme.lower()
309
+ except ValueError:
310
+ return False
311
+ return scheme in ("http", "https")
312
+
313
+
314
+ def _parse_post(raw_post: Dict[str, Any]) -> Optional[Dict[str, Any]]:
315
+ """Reduce a digg post payload into the small dict render uses.
316
+
317
+ We deliberately keep this minimal: an inline quote needs the author
318
+ handle, the body, the post type, and the X URL.
319
+ """
320
+ if not isinstance(raw_post, dict):
321
+ return None
322
+ body = str(raw_post.get("body") or "").strip()
323
+ if not body:
324
+ return None
325
+ author = raw_post.get("author") or {}
326
+ if not isinstance(author, dict):
327
+ author = {}
328
+ username = str(author.get("username") or "").strip()
329
+ if not username:
330
+ return None
331
+ x_url = str(raw_post.get("xUrl") or "").strip()
332
+ if not x_url:
333
+ return None
334
+ if not _is_safe_http_url(x_url):
335
+ # Security-class drop: an upstream-supplied URL with a dangerous
336
+ # scheme. Force tty_only=False so the rejection is visible in
337
+ # non-interactive runs (Claude Code), which is the actual attack
338
+ # surface — the default tty_only=True would suppress it there.
339
+ log.source_log(
340
+ "Digg",
341
+ f"dropped post with unsafe xUrl scheme: {x_url!r}",
342
+ tty_only=False,
343
+ )
344
+ return None
345
+ return {
346
+ "username": username,
347
+ "display_name": str(author.get("display_name") or "").strip() or username,
348
+ "category": str(author.get("category") or "").strip(),
349
+ "rank": author.get("rank"),
350
+ "body": body,
351
+ "post_type": str(raw_post.get("post_type") or "tweet").strip(),
352
+ "x_url": x_url,
353
+ "posted_at": raw_post.get("posted_at"),
354
+ }
355
+
356
+
357
+ def fetch_top_posts(cluster_url_id: str, posts_per: int = POSTS_PER_CLUSTER) -> List[Dict[str, Any]]:
358
+ """Fetch top-ranked X posts attached to a cluster.
359
+
360
+ Returns an empty list on any failure (timeout, missing cluster, JSON
361
+ error). Never raises.
362
+ """
363
+ if posts_per <= 0:
364
+ return []
365
+ cmd = _build_posts_args(cluster_url_id, posts_per)
366
+ response = _run_cli(cmd, timeout=POSTS_TIMEOUT)
367
+ raw = response.get("results") or []
368
+ out: List[Dict[str, Any]] = []
369
+ for entry in raw:
370
+ post = _parse_post(entry)
371
+ if post is not None:
372
+ out.append(post)
373
+ return out
374
+
375
+
376
+ def enrich_with_top_posts(
377
+ items: List[Dict[str, Any]],
378
+ top_k: int = 3,
379
+ posts_per: int = POSTS_PER_CLUSTER,
380
+ ) -> List[Dict[str, Any]]:
381
+ """Attach top X posts to the first ``top_k`` clusters by Digg rank order.
382
+
383
+ Mutates and returns the same list. Items that already have posts, or
384
+ whose ``postCount`` is 0, are skipped.
385
+ """
386
+ if top_k <= 0 or posts_per <= 0:
387
+ return items
388
+ enriched = 0
389
+ for item in items:
390
+ if enriched >= top_k:
391
+ break
392
+ if item.get("posts"):
393
+ continue
394
+ engagement = item.get("engagement") or {}
395
+ if not engagement.get("postCount"):
396
+ continue
397
+ cluster_url_id = item.get("id")
398
+ if not cluster_url_id:
399
+ continue
400
+ posts = fetch_top_posts(str(cluster_url_id), posts_per=posts_per)
401
+ item["posts"] = posts
402
+ enriched += 1
403
+ if enriched:
404
+ _log(f"enriched {enriched} clusters with X posts")
405
+ return items
406
+
407
+
408
+ def enrich_source_items(items: list, top_k: int = 3, posts_per: int = POSTS_PER_CLUSTER) -> list:
409
+ """Attach top X posts to the first ``top_k`` SourceItems that survived dedupe.
410
+
411
+ Reads ``metadata['clusterUrlId']`` and writes ``metadata['posts']`` in
412
+ place. Skips items that already carry a non-empty ``metadata['posts']``,
413
+ items whose engagement ``postCount`` is 0, and items whose source is not
414
+ 'digg'. Designed to run from `_finalize_items_by_source` so enrichment
415
+ is spent on the items the brief actually shows.
416
+ """
417
+ if top_k <= 0 or posts_per <= 0:
418
+ return items
419
+ enriched = 0
420
+ for item in items:
421
+ if enriched >= top_k:
422
+ break
423
+ if getattr(item, "source", None) != "digg":
424
+ continue
425
+ metadata = getattr(item, "metadata", None) or {}
426
+ if metadata.get("posts"):
427
+ continue
428
+ engagement = getattr(item, "engagement", None) or {}
429
+ if not engagement.get("postCount"):
430
+ continue
431
+ cluster_url_id = metadata.get("clusterUrlId") or item.item_id
432
+ if not cluster_url_id:
433
+ continue
434
+ posts = fetch_top_posts(str(cluster_url_id), posts_per=posts_per)
435
+ if posts:
436
+ metadata["posts"] = posts
437
+ enriched += 1
438
+ if enriched:
439
+ _log(f"post-dedupe enriched {enriched} clusters with X posts")
440
+ return items
@@ -0,0 +1,127 @@
1
+ """Entity extraction from initial search results for supplemental searches."""
2
+
3
+ import re
4
+ from collections import Counter
5
+ from typing import Any, Dict, List
6
+
7
+ # Handles that appear too frequently to be useful for targeted search.
8
+ # These are generic/platform accounts, not topic-specific voices.
9
+ GENERIC_HANDLES = {
10
+ "elonmusk", "openai", "google", "microsoft", "apple", "meta",
11
+ "github", "youtube", "x", "twitter", "reddit", "wikipedia",
12
+ "nytimes", "washingtonpost", "cnn", "bbc", "reuters",
13
+ "verified", "jack", "sundarpichai",
14
+ }
15
+
16
+
17
+ def extract_entities(
18
+ reddit_items: List[Dict[str, Any]],
19
+ x_items: List[Dict[str, Any]],
20
+ max_handles: int = 5,
21
+ max_hashtags: int = 3,
22
+ max_subreddits: int = 5,
23
+ ) -> Dict[str, List[str]]:
24
+ """Extract key entities from Phase 1 results for supplemental searches.
25
+
26
+ Parses X results for @handles and #hashtags, Reddit results for subreddit
27
+ names and cross-referenced communities.
28
+
29
+ Args:
30
+ reddit_items: Raw Reddit item dicts from Phase 1
31
+ x_items: Raw X item dicts from Phase 1
32
+ max_handles: Maximum handles to return
33
+ max_hashtags: Maximum hashtags to return
34
+ max_subreddits: Maximum subreddits to return
35
+
36
+ Returns:
37
+ Dict with keys: x_handles, x_hashtags, reddit_subreddits
38
+ """
39
+ handles = _extract_x_handles(x_items)
40
+ hashtags = _extract_x_hashtags(x_items)
41
+ subreddits = _extract_subreddits(reddit_items)
42
+
43
+ return {
44
+ "x_handles": handles[:max_handles],
45
+ "x_hashtags": hashtags[:max_hashtags],
46
+ "reddit_subreddits": subreddits[:max_subreddits],
47
+ }
48
+
49
+
50
+ def _extract_x_handles(x_items: List[Dict[str, Any]]) -> List[str]:
51
+ """Extract and rank @handles from X results.
52
+
53
+ Sources handles from:
54
+ 1. author_handle field (who posted)
55
+ 2. @mentions in post text (who they're talking about/to)
56
+
57
+ Returns handles ranked by frequency, filtered for generic accounts.
58
+ """
59
+ handle_counts = Counter()
60
+
61
+ for item in x_items:
62
+ # Author handle
63
+ author = item.get("author_handle", "").strip().lstrip("@").lower()
64
+ if author and author not in GENERIC_HANDLES:
65
+ handle_counts[author] += 1
66
+
67
+ # @mentions in text
68
+ text = item.get("text", "")
69
+ mentions = re.findall(r'@(\w{1,15})', text)
70
+ for mention in mentions:
71
+ mention_lower = mention.lower()
72
+ if mention_lower not in GENERIC_HANDLES:
73
+ handle_counts[mention_lower] += 1
74
+
75
+ # Return all handles ranked by frequency
76
+ return [h for h, _ in handle_counts.most_common()]
77
+
78
+
79
+ def _extract_x_hashtags(x_items: List[Dict[str, Any]]) -> List[str]:
80
+ """Extract and rank #hashtags from X results.
81
+
82
+ Returns hashtags ranked by frequency.
83
+ """
84
+ hashtag_counts = Counter()
85
+
86
+ for item in x_items:
87
+ text = item.get("text", "")
88
+ tags = re.findall(r'#(\w{2,30})', text)
89
+ for tag in tags:
90
+ hashtag_counts[tag.lower()] += 1
91
+
92
+ # Return all hashtags ranked by frequency
93
+ return [f"#{t}" for t, _ in hashtag_counts.most_common()]
94
+
95
+
96
+ def _extract_subreddits(reddit_items: List[Dict[str, Any]]) -> List[str]:
97
+ """Extract and rank subreddits from Reddit results.
98
+
99
+ Sources from:
100
+ 1. subreddit field on each result
101
+ 2. Cross-references in comment text (e.g., "check out r/localLLaMA")
102
+
103
+ Returns subreddits ranked by frequency.
104
+ """
105
+ sub_counts = Counter()
106
+
107
+ for item in reddit_items:
108
+ # Primary subreddit
109
+ sub = item.get("subreddit", "").strip().removeprefix("r/")
110
+ if sub:
111
+ sub_counts[sub] += 1
112
+
113
+ # Cross-references in comment insights
114
+ for insight in item.get("comment_insights", []):
115
+ cross_refs = re.findall(r'r/(\w{2,30})', insight)
116
+ for ref in cross_refs:
117
+ sub_counts[ref] += 1
118
+
119
+ # Cross-references in top comments
120
+ for comment in item.get("top_comments", []):
121
+ excerpt = comment.get("excerpt", "")
122
+ cross_refs = re.findall(r'r/(\w{2,30})', excerpt)
123
+ for ref in cross_refs:
124
+ sub_counts[ref] += 1
125
+
126
+ # Return subreddits ranked by frequency
127
+ return [sub for sub, _ in sub_counts.most_common()]