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,508 @@
1
+ """Browser cookie extraction for last30days.
2
+
3
+ Extracts cookies from local browser databases (Firefox, Chrome, Brave, Safari)
4
+ to enable zero-config authentication for services like X/Twitter.
5
+ Note: Chrome/Brave extraction is macOS-only; Windows Chrome/Edge use
6
+ DPAPI-encrypted stores that are not yet supported.
7
+
8
+ Only uses Python stdlib — no external dependencies.
9
+ """
10
+
11
+ import configparser
12
+ import functools
13
+ import logging
14
+ import os
15
+ import platform
16
+ import shutil
17
+ import sqlite3
18
+ import tempfile
19
+ from pathlib import Path
20
+ from typing import Dict, List, Optional
21
+
22
+ logger = logging.getLogger(__name__)
23
+
24
+
25
+ def _lock_temp_cookie_copy(path: str) -> None:
26
+ """Restrict copied cookie DB temp files to the current user on POSIX."""
27
+ if os.name == "nt":
28
+ return
29
+ Path(path).chmod(0o600)
30
+
31
+
32
+ @functools.lru_cache(maxsize=1)
33
+ def _is_wsl() -> bool:
34
+ """Detect if running under Windows Subsystem for Linux.
35
+
36
+ Cached after the first call since /proc/version doesn't change at runtime.
37
+ """
38
+ try:
39
+ return "microsoft" in Path("/proc/version").read_text().lower()
40
+ except OSError:
41
+ return False
42
+
43
+
44
+ def _get_wsl_firefox_profiles_dir() -> Optional[Path]:
45
+ """Find Firefox profiles directory on the Windows host from WSL.
46
+
47
+ Scans /mnt/c/Users/*/AppData/Roaming/Mozilla/Firefox for real user
48
+ directories (skips Public, Default, etc.).
49
+ """
50
+ mnt_users = Path("/mnt/c/Users")
51
+ if not mnt_users.is_dir():
52
+ return None
53
+ skip = {"Public", "Default", "Default User", "All Users"}
54
+ try:
55
+ for user_dir in sorted(mnt_users.iterdir()):
56
+ if user_dir.name in skip or not user_dir.is_dir():
57
+ continue
58
+ ff_dir = user_dir / "AppData" / "Roaming" / "Mozilla" / "Firefox"
59
+ if ff_dir.is_dir():
60
+ return ff_dir
61
+ except OSError:
62
+ pass
63
+ return None
64
+
65
+
66
+ def _get_firefox_profiles_dir() -> Optional[Path]:
67
+ """Return the Firefox profiles directory for the current platform, or None."""
68
+ system = platform.system()
69
+ if system == "Darwin":
70
+ path = Path.home() / "Library" / "Application Support" / "Firefox"
71
+ elif system == "Linux":
72
+ # Default location for most distros
73
+ path = Path.home() / ".mozilla" / "firefox"
74
+ if path.is_dir():
75
+ return path
76
+ # Some distros (e.g. Fedora) honour $XDG_CONFIG_HOME
77
+ xdg_config = os.environ.get("XDG_CONFIG_HOME")
78
+ if xdg_config and os.path.isabs(xdg_config):
79
+ path = Path(xdg_config) / "mozilla" / "firefox"
80
+ else:
81
+ path = Path.home() / ".config" / "mozilla" / "firefox"
82
+ else:
83
+ # Windows: %APPDATA%\Mozilla\Firefox — best-effort
84
+ appdata = Path.home() / "AppData" / "Roaming" / "Mozilla" / "Firefox"
85
+ path = appdata
86
+ return path if path.is_dir() else None
87
+
88
+
89
+ def _find_default_profile(profiles_dir: Path) -> Optional[Path]:
90
+ """Parse profiles.ini to find the default profile directory.
91
+
92
+ Looks for a section with Default=1. Falls back to the first profile
93
+ directory found on disk if profiles.ini is missing or malformed.
94
+ """
95
+ ini_path = profiles_dir / "profiles.ini"
96
+
97
+ if ini_path.is_file():
98
+ try:
99
+ config = configparser.ConfigParser()
100
+ config.read(str(ini_path), encoding="utf-8")
101
+
102
+ # First pass: Install* section (Firefox >= 67 format, takes priority)
103
+ for section in config.sections():
104
+ if section.startswith("Install") and config.has_option(section, "Default"):
105
+ raw = config.get(section, "Default")
106
+ candidate = profiles_dir / raw
107
+ if candidate.is_dir():
108
+ return candidate
109
+
110
+ # Second pass: Profile section with Default=1
111
+ for section in config.sections():
112
+ if section.startswith("Profile") and config.has_option(section, "Default") and config.get(section, "Default") == "1":
113
+ return _resolve_profile_path(profiles_dir, config, section)
114
+
115
+ # Third pass: first Profile section that exists on disk
116
+ for section in config.sections():
117
+ if section.startswith("Profile"):
118
+ resolved = _resolve_profile_path(profiles_dir, config, section)
119
+ if resolved and resolved.is_dir():
120
+ return resolved
121
+ except (configparser.Error, OSError) as exc:
122
+ logger.debug("Failed to parse profiles.ini: %s", exc)
123
+
124
+ # Fallback: scan directory for anything that looks like a profile
125
+ return _fallback_find_profile(profiles_dir)
126
+
127
+
128
+ def _resolve_profile_path(
129
+ profiles_dir: Path, config: configparser.ConfigParser, section: str
130
+ ) -> Optional[Path]:
131
+ """Resolve a profile path from a ConfigParser section."""
132
+ if not config.has_option(section, "Path"):
133
+ return None
134
+ raw_path = config.get(section, "Path")
135
+ is_relative = config.has_option(section, "IsRelative") and config.get(section, "IsRelative") == "1"
136
+ if is_relative:
137
+ candidate = profiles_dir / raw_path
138
+ else:
139
+ candidate = Path(raw_path)
140
+ return candidate if candidate.is_dir() else None
141
+
142
+
143
+ def _fallback_find_profile(profiles_dir: Path) -> Optional[Path]:
144
+ """Find the first directory that contains cookies.sqlite."""
145
+ try:
146
+ for child in sorted(profiles_dir.iterdir()):
147
+ if child.is_dir() and (child / "cookies.sqlite").is_file():
148
+ return child
149
+ except OSError:
150
+ pass
151
+ return None
152
+
153
+
154
+ def _query_cookies_db(
155
+ db_path: Path, domain: str, cookie_names: List[str]
156
+ ) -> Optional[Dict[str, str]]:
157
+ """Copy the cookies database to a temp file and query it.
158
+
159
+ Firefox locks cookies.sqlite while running, so we copy first.
160
+ Returns {name: value} dict or None if no matching cookies found.
161
+ """
162
+ if not db_path.is_file():
163
+ return None
164
+
165
+ tmp_fd = None
166
+ tmp_path = None
167
+ try:
168
+ tmp_fd, tmp_path = tempfile.mkstemp(suffix=".sqlite")
169
+ # mkstemp creates the file 0600. copy2 would copy the source's mode
170
+ # (Firefox cookies.sqlite is commonly 0644, looser on WSL /mnt/c) onto
171
+ # the temp file, leaving live session secrets world-readable in shared
172
+ # /tmp until the chmod below runs. copyfile writes content only and
173
+ # leaves the 0600 perms intact, closing that window.
174
+ shutil.copyfile(str(db_path), tmp_path)
175
+ _lock_temp_cookie_copy(tmp_path)
176
+
177
+ conn = sqlite3.connect(tmp_path)
178
+ try:
179
+ # Build parameterized query — SQLite doesn't support array params,
180
+ # so we build the IN clause with individual placeholders.
181
+ placeholders = ",".join("?" for _ in cookie_names)
182
+ query = (
183
+ f"SELECT name, value FROM moz_cookies "
184
+ f"WHERE host LIKE ? AND name IN ({placeholders})"
185
+ )
186
+ # domain pattern: match .x.com, x.com, etc.
187
+ domain_pattern = f"%{domain}"
188
+ params = [domain_pattern] + list(cookie_names)
189
+
190
+ cursor = conn.execute(query, params)
191
+ rows = cursor.fetchall()
192
+ finally:
193
+ conn.close()
194
+
195
+ if not rows:
196
+ return None
197
+ return {name: value for name, value in rows}
198
+
199
+ except (sqlite3.Error, OSError) as exc:
200
+ logger.debug("Failed to query cookies database %s: %s", db_path, exc)
201
+ return None
202
+ finally:
203
+ if tmp_path:
204
+ try:
205
+ Path(tmp_path).unlink(missing_ok=True)
206
+ except OSError:
207
+ pass
208
+ if tmp_fd is not None:
209
+ try:
210
+ import os
211
+ os.close(tmp_fd)
212
+ except OSError:
213
+ pass
214
+
215
+
216
+ def _try_firefox_dir(profiles_dir: Path, domain: str, cookie_names: List[str]) -> Optional[Dict[str, str]]:
217
+ """Try to extract cookies from a Firefox profiles directory.
218
+
219
+ Tries the default profile first, then falls back to scanning all
220
+ profiles for matching cookies. This handles multi-profile setups
221
+ where the user is logged into x.com on a non-default profile.
222
+ """
223
+ default_profile = _find_default_profile(profiles_dir)
224
+ profiles_tried = 0
225
+ if default_profile is not None:
226
+ result = _query_cookies_db(default_profile / "cookies.sqlite", domain, cookie_names)
227
+ if result is not None:
228
+ return result
229
+ profiles_tried = 1
230
+ # Fallback: scan every profile directory for matching cookies
231
+ try:
232
+ for child in sorted(profiles_dir.iterdir()):
233
+ if not child.is_dir():
234
+ continue
235
+ if default_profile is not None and child == default_profile:
236
+ continue
237
+ db = child / "cookies.sqlite"
238
+ if db.is_file():
239
+ result = _query_cookies_db(db, domain, cookie_names)
240
+ if result is not None:
241
+ return result
242
+ profiles_tried += 1
243
+ except OSError:
244
+ pass
245
+ logger.debug("No matching cookies found in %d Firefox profile(s)", profiles_tried)
246
+ return None
247
+
248
+
249
+ def extract_firefox_cookies(
250
+ domain: str, cookie_names: List[str]
251
+ ) -> Optional[Dict[str, str]]:
252
+ """Extract cookies from Firefox for the given domain and cookie names.
253
+
254
+ Finds the default Firefox profile, copies cookies.sqlite to a temp file
255
+ (to avoid lock conflicts), and queries for the requested cookies.
256
+
257
+ On WSL2, falls back to Windows Firefox if native Linux Firefox has no
258
+ matching cookies. Windows Firefox cookies are unencrypted, so this works
259
+ without DPAPI or any Windows-side helpers.
260
+
261
+ Args:
262
+ domain: The cookie domain to match (e.g. ".x.com"). Matched with LIKE %domain.
263
+ cookie_names: List of cookie names to extract (e.g. ["auth_token", "ct0"]).
264
+
265
+ Returns:
266
+ Dict of {cookie_name: cookie_value} or None if extraction fails.
267
+ """
268
+ profiles_dir = _get_firefox_profiles_dir()
269
+ if profiles_dir is not None:
270
+ result = _try_firefox_dir(profiles_dir, domain, cookie_names)
271
+ if result is not None:
272
+ return result
273
+
274
+ if platform.system() == "Linux" and _is_wsl():
275
+ wsl_dir = _get_wsl_firefox_profiles_dir()
276
+ if wsl_dir is not None:
277
+ logger.debug("Trying Windows Firefox via WSL: %s", wsl_dir)
278
+ return _try_firefox_dir(wsl_dir, domain, cookie_names)
279
+
280
+ if profiles_dir is None:
281
+ logger.debug("Firefox profiles directory not found")
282
+ return None
283
+
284
+
285
+ def extract_chrome_cookies(
286
+ domain: str, cookie_names: List[str]
287
+ ) -> Optional[Dict[str, str]]:
288
+ """Extract cookies from Chrome for the given domain and cookie names.
289
+
290
+ macOS only — uses Keychain + system openssl for AES-128-CBC decryption.
291
+ Linux/Windows not supported (Chrome uses platform-specific encryption).
292
+
293
+ Returns:
294
+ Dict of {cookie_name: cookie_value} or None if extraction fails.
295
+ """
296
+ if platform.system() != "Darwin":
297
+ logger.debug("Chrome cookie extraction only supported on macOS")
298
+ return None
299
+ try:
300
+ from .chrome_cookies import extract_chrome_cookies_macos
301
+ return extract_chrome_cookies_macos(domain, cookie_names)
302
+ except Exception as exc:
303
+ logger.debug("Chrome cookie extraction failed: %s", exc)
304
+ return None
305
+
306
+
307
+ def extract_brave_cookies(
308
+ domain: str, cookie_names: List[str]
309
+ ) -> Optional[Dict[str, str]]:
310
+ """Extract cookies from Brave for the given domain and cookie names.
311
+
312
+ macOS only — Brave uses the same v10 AES-128-CBC encryption as Chrome,
313
+ with a different DB path and Keychain service name ("Brave Safe Storage").
314
+ Tries the Default profile first, then scans numbered Profile directories.
315
+
316
+ Returns:
317
+ Dict of {cookie_name: cookie_value} or None if extraction fails.
318
+ """
319
+ if platform.system() != "Darwin":
320
+ logger.debug("Brave cookie extraction only supported on macOS")
321
+ return None
322
+ try:
323
+ from .chrome_cookies import extract_brave_cookies_macos
324
+ return extract_brave_cookies_macos(domain, cookie_names)
325
+ except Exception as exc:
326
+ logger.debug("Brave cookie extraction failed: %s", exc)
327
+ return None
328
+
329
+
330
+ def _extract_chromium_family_cookies(
331
+ browser: str, domain: str, cookie_names: List[str]
332
+ ) -> Optional[Dict[str, str]]:
333
+ """Extract cookies from a non-Chrome/Brave Chromium browser on macOS.
334
+
335
+ macOS only — Edge, Vivaldi, Opera, Arc, and Chromium all reuse Chrome's
336
+ v10 AES-128-CBC encryption, with their own profile path and Keychain
337
+ service name (see chrome_cookies.CHROMIUM_BROWSER_PROFILES).
338
+ """
339
+ if platform.system() != "Darwin":
340
+ logger.debug("%s cookie extraction only supported on macOS", browser)
341
+ return None
342
+ try:
343
+ from .chrome_cookies import extract_chromium_browser_cookies_macos
344
+ return extract_chromium_browser_cookies_macos(browser, domain, cookie_names)
345
+ except Exception as exc:
346
+ logger.debug("%s cookie extraction failed: %s", browser, exc)
347
+ return None
348
+
349
+
350
+ def extract_edge_cookies(domain: str, cookie_names: List[str]) -> Optional[Dict[str, str]]:
351
+ """Extract cookies from Microsoft Edge for the given domain (macOS only)."""
352
+ return _extract_chromium_family_cookies("edge", domain, cookie_names)
353
+
354
+
355
+ def extract_vivaldi_cookies(domain: str, cookie_names: List[str]) -> Optional[Dict[str, str]]:
356
+ """Extract cookies from Vivaldi for the given domain (macOS only)."""
357
+ return _extract_chromium_family_cookies("vivaldi", domain, cookie_names)
358
+
359
+
360
+ def extract_opera_cookies(domain: str, cookie_names: List[str]) -> Optional[Dict[str, str]]:
361
+ """Extract cookies from Opera for the given domain (macOS only)."""
362
+ return _extract_chromium_family_cookies("opera", domain, cookie_names)
363
+
364
+
365
+ def extract_arc_cookies(domain: str, cookie_names: List[str]) -> Optional[Dict[str, str]]:
366
+ """Extract cookies from Arc for the given domain (macOS only)."""
367
+ return _extract_chromium_family_cookies("arc", domain, cookie_names)
368
+
369
+
370
+ def extract_chromium_cookies(domain: str, cookie_names: List[str]) -> Optional[Dict[str, str]]:
371
+ """Extract cookies from open-source Chromium for the given domain (macOS only)."""
372
+ return _extract_chromium_family_cookies("chromium", domain, cookie_names)
373
+
374
+
375
+ def extract_safari_cookies(
376
+ domain: str, cookie_names: List[str]
377
+ ) -> Optional[Dict[str, str]]:
378
+ """Extract cookies from Safari for the given domain and cookie names.
379
+
380
+ macOS only — parses the unencrypted binary cookie file.
381
+
382
+ Returns:
383
+ Dict of {cookie_name: cookie_value} or None if extraction fails.
384
+ """
385
+ if platform.system() != "Darwin":
386
+ logger.debug("Safari cookie extraction only supported on macOS")
387
+ return None
388
+ try:
389
+ from .safari_cookies import extract_safari_cookies_macos
390
+ return extract_safari_cookies_macos(domain, cookie_names)
391
+ except Exception as exc:
392
+ logger.debug("Safari cookie extraction failed: %s", exc)
393
+ return None
394
+
395
+
396
+ def extract_cookies(
397
+ browser: str, domain: str, cookie_names: list[str]
398
+ ) -> Optional[dict[str, str]]:
399
+ """Extract cookies from the specified browser.
400
+
401
+ Args:
402
+ browser: One of 'firefox', 'chrome', 'brave', 'edge', 'vivaldi',
403
+ 'opera', 'arc', 'chromium', 'safari', or 'auto'.
404
+ 'auto' tries browsers in platform-appropriate order:
405
+ - macOS: Chrome -> Brave -> Edge -> Vivaldi -> Opera -> Arc -> Chromium -> Firefox -> Safari
406
+ - Linux: Firefox only
407
+ domain: The cookie domain to match (e.g. ".x.com").
408
+ cookie_names: List of cookie names to extract.
409
+
410
+ Returns:
411
+ Dict of {cookie_name: cookie_value} or None if extraction fails.
412
+ """
413
+ result = extract_cookies_with_source(browser, domain, cookie_names)
414
+ if result is None:
415
+ return None
416
+ cookies, _browser_name = result
417
+ return cookies
418
+
419
+
420
+ def _extract_firefox_with_source(
421
+ domain: str, cookie_names: List[str]
422
+ ) -> Optional[tuple[Dict[str, str], str]]:
423
+ """Extract Firefox cookies and report whether they came from native or WSL.
424
+
425
+ Returns (cookies, "firefox") for native Linux/macOS Firefox, or
426
+ (cookies, "firefox-wsl") for Windows Firefox accessed via WSL2.
427
+ """
428
+ profiles_dir = _get_firefox_profiles_dir()
429
+ if profiles_dir is not None:
430
+ result = _try_firefox_dir(profiles_dir, domain, cookie_names)
431
+ if result is not None:
432
+ return (result, "firefox")
433
+
434
+ if platform.system() == "Linux" and _is_wsl():
435
+ wsl_dir = _get_wsl_firefox_profiles_dir()
436
+ if wsl_dir is not None:
437
+ logger.debug("Trying Windows Firefox via WSL: %s", wsl_dir)
438
+ result = _try_firefox_dir(wsl_dir, domain, cookie_names)
439
+ if result is not None:
440
+ return (result, "firefox-wsl")
441
+
442
+ return None
443
+
444
+
445
+ def extract_cookies_with_source(
446
+ browser: str, domain: str, cookie_names: list[str]
447
+ ) -> Optional[tuple[dict[str, str], str]]:
448
+ """Extract cookies and report which browser they came from.
449
+
450
+ Same as extract_cookies() but returns a (cookies, browser_name) tuple
451
+ so callers can track the source.
452
+
453
+ Args:
454
+ browser: One of 'firefox', 'chrome', 'brave', 'edge', 'vivaldi',
455
+ 'opera', 'arc', 'chromium', 'safari', or 'auto'.
456
+ domain: The cookie domain to match (e.g. ".x.com").
457
+ cookie_names: List of cookie names to extract.
458
+
459
+ Returns:
460
+ Tuple of ({cookie_name: cookie_value}, browser_name) or None.
461
+ browser_name is "firefox-wsl" when cookies came from Windows Firefox via WSL2.
462
+ """
463
+ extractors = {
464
+ "firefox": extract_firefox_cookies,
465
+ "chrome": extract_chrome_cookies,
466
+ "brave": extract_brave_cookies,
467
+ "edge": extract_edge_cookies,
468
+ "vivaldi": extract_vivaldi_cookies,
469
+ "opera": extract_opera_cookies,
470
+ "arc": extract_arc_cookies,
471
+ "chromium": extract_chromium_cookies,
472
+ "safari": extract_safari_cookies,
473
+ }
474
+
475
+ if browser != "auto":
476
+ if browser == "firefox":
477
+ return _extract_firefox_with_source(domain, cookie_names)
478
+ extractor = extractors.get(browser)
479
+ if extractor is None:
480
+ logger.warning("Unknown browser: %s", browser)
481
+ return None
482
+ result = extractor(domain, cookie_names)
483
+ return (result, browser) if result is not None else None
484
+
485
+ # Auto mode: try browsers in platform-appropriate order.
486
+ # Note: the skill's own entry point (env.extract_browser_credentials) builds
487
+ # its own list that tries the SILENT browsers (Firefox, Safari) first to
488
+ # avoid macOS Keychain prompts. This standalone "auto" is Chromium-first; the
489
+ # two orderings are intentional for their respective callers.
490
+ system = platform.system()
491
+ if system == "Darwin":
492
+ order = ["chrome", "brave", "edge", "vivaldi", "opera", "arc", "chromium", "firefox", "safari"]
493
+ elif system == "Linux":
494
+ order = ["firefox"]
495
+ else:
496
+ order = ["firefox"]
497
+
498
+ for name in order:
499
+ if name == "firefox":
500
+ result = _extract_firefox_with_source(domain, cookie_names)
501
+ if result is not None:
502
+ return result
503
+ else:
504
+ result = extractors[name](domain, cookie_names)
505
+ if result is not None:
506
+ return (result, name)
507
+
508
+ return None
@@ -0,0 +1,169 @@
1
+ """Date utilities for last30days skill."""
2
+
3
+ from datetime import datetime, timedelta, timezone
4
+ from typing import Optional, Tuple
5
+
6
+
7
+ def parse_as_of_date(as_of_date: Optional[str]) -> Optional[str]:
8
+ """Validate and normalize an --as-of date.
9
+
10
+ Args:
11
+ as_of_date: Date string in YYYY-MM-DD format.
12
+
13
+ Returns:
14
+ Normalized YYYY-MM-DD string, or None when no date was provided.
15
+
16
+ Raises:
17
+ ValueError: If the date is not in YYYY-MM-DD format.
18
+ """
19
+ if as_of_date is None:
20
+ return None
21
+
22
+ if not as_of_date.strip():
23
+ raise ValueError("--as-of must be in YYYY-MM-DD format.")
24
+
25
+ try:
26
+ parsed = datetime.strptime(as_of_date, "%Y-%m-%d").date()
27
+ except ValueError as exc:
28
+ raise ValueError(
29
+ f"Invalid --as-of date: {as_of_date}. Expected YYYY-MM-DD."
30
+ ) from exc
31
+
32
+ return parsed.isoformat()
33
+
34
+
35
+ def get_date_range(days: int = 30, as_of_date: Optional[str] = None) -> Tuple[str, str]:
36
+ """Get the date range for the last N days.
37
+
38
+ When as_of_date is provided, the range ends at that date instead of today.
39
+
40
+ Args:
41
+ days: Number of days to look back.
42
+ as_of_date: Optional end date in YYYY-MM-DD format.
43
+
44
+ Returns:
45
+ Tuple of (from_date, to_date) as YYYY-MM-DD strings.
46
+ """
47
+ normalized_as_of = parse_as_of_date(as_of_date)
48
+
49
+ if normalized_as_of:
50
+ to_date = datetime.strptime(normalized_as_of, "%Y-%m-%d").date()
51
+ else:
52
+ to_date = datetime.now(timezone.utc).date()
53
+
54
+ from_date = to_date - timedelta(days=days)
55
+ return from_date.isoformat(), to_date.isoformat()
56
+
57
+
58
+ def parse_date(date_str: Optional[str]) -> Optional[datetime]:
59
+ """Parse a date string in various formats.
60
+
61
+ Supports: YYYY-MM-DD, ISO 8601, Unix timestamp
62
+ """
63
+ if not date_str:
64
+ return None
65
+
66
+ # Try Unix timestamp (from Reddit)
67
+ try:
68
+ ts = float(date_str)
69
+ return datetime.fromtimestamp(ts, tz=timezone.utc)
70
+ except (ValueError, TypeError):
71
+ pass
72
+
73
+ # Try ISO formats
74
+ formats = [
75
+ "%Y-%m-%d",
76
+ "%Y-%m-%dT%H:%M:%S",
77
+ "%Y-%m-%dT%H:%M:%SZ",
78
+ "%Y-%m-%dT%H:%M:%S%z",
79
+ "%Y-%m-%dT%H:%M:%S.%f%z",
80
+ ]
81
+
82
+ for fmt in formats:
83
+ try:
84
+ dt = datetime.strptime(date_str, fmt)
85
+ if dt.tzinfo is not None:
86
+ return dt.astimezone(timezone.utc)
87
+ return dt.replace(tzinfo=timezone.utc)
88
+ except ValueError:
89
+ continue
90
+
91
+ return None
92
+
93
+
94
+ def timestamp_to_date(ts: Optional[float]) -> Optional[str]:
95
+ """Convert Unix timestamp to YYYY-MM-DD string."""
96
+ if ts is None:
97
+ return None
98
+ try:
99
+ dt = datetime.fromtimestamp(ts, tz=timezone.utc)
100
+ return dt.date().isoformat()
101
+ except (ValueError, TypeError, OSError):
102
+ return None
103
+
104
+
105
+ def get_date_confidence(date_str: Optional[str], from_date: str, to_date: str) -> str:
106
+ """Determine confidence level for a date.
107
+
108
+ Args:
109
+ date_str: The date to check (YYYY-MM-DD or None)
110
+ from_date: Start of valid range (YYYY-MM-DD)
111
+ to_date: End of valid range (YYYY-MM-DD)
112
+
113
+ Returns:
114
+ 'high', 'med', or 'low'
115
+ """
116
+ if not date_str:
117
+ return 'low'
118
+
119
+ try:
120
+ dt = datetime.strptime(date_str, "%Y-%m-%d").date()
121
+ start = datetime.strptime(from_date, "%Y-%m-%d").date()
122
+ end = datetime.strptime(to_date, "%Y-%m-%d").date()
123
+
124
+ return 'high' if start <= dt <= end else 'low'
125
+ except ValueError:
126
+ return 'low'
127
+
128
+
129
+ def days_ago(date_str: Optional[str], reference_date: Optional[str] = None) -> Optional[int]:
130
+ """Calculate how many days before the reference date a date is.
131
+
132
+ If reference_date is None, use real today for backward compatibility.
133
+ Returns None if date is invalid or missing.
134
+ """
135
+ if not date_str:
136
+ return None
137
+
138
+ try:
139
+ dt = datetime.strptime(date_str, "%Y-%m-%d").date()
140
+ if reference_date:
141
+ today = datetime.strptime(reference_date, "%Y-%m-%d").date()
142
+ else:
143
+ today = datetime.now(timezone.utc).date()
144
+ delta = today - dt
145
+ return delta.days
146
+ except ValueError:
147
+ return None
148
+
149
+
150
+ def recency_score(
151
+ date_str: Optional[str],
152
+ max_days: int = 30,
153
+ reference_date: Optional[str] = None,
154
+ ) -> int:
155
+ """Calculate recency score (0-100).
156
+
157
+ 0 days before reference_date = 100, max_days before reference_date = 0.
158
+ If reference_date is None, use real today for backward compatibility.
159
+ """
160
+ age = days_ago(date_str, reference_date=reference_date)
161
+ if age is None:
162
+ return 0
163
+
164
+ if age < 0:
165
+ return 100
166
+ if age >= max_days:
167
+ return 0
168
+
169
+ return int(100 * (1 - age / max_days))