@egbe-ai/opencode 0.0.0-stage → 0.1.8

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 (479) hide show
  1. package/LICENSE +4 -0
  2. package/README.md +124 -2
  3. package/index.js +5 -0
  4. package/package.json +55 -4
  5. package/plugin.js +230 -0
  6. package/session-log.js +315 -0
  7. package/skills/.egbe-catalog/manifest.json +1 -0
  8. package/skills/egbe-os-analytics/SKILL.md +499 -0
  9. package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
  10. package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
  11. package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
  12. package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
  13. package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
  14. package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
  15. package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
  16. package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
  17. package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
  18. package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
  19. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
  20. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
  21. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
  22. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
  23. package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
  24. package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
  25. package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
  26. package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
  27. package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
  28. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
  29. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
  30. package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
  31. package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
  32. package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
  33. package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
  34. package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
  35. package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
  36. package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
  37. package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
  38. package/skills/egbe-os-db/SKILL.md +174 -0
  39. package/skills/egbe-os-deploy/SKILL.md +412 -0
  40. package/skills/egbe-os-design/SKILL.md +182 -0
  41. package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
  42. package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
  43. package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
  44. package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
  45. package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
  46. package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
  47. package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
  48. package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
  49. package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
  50. package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
  51. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
  52. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
  53. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
  54. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
  55. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
  56. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
  57. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
  58. package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
  59. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
  60. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
  61. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
  62. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
  63. package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
  64. package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
  65. package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
  66. package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
  67. package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
  68. package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
  69. package/skills/egbe-os-destination-readiness/references/report.md +116 -0
  70. package/skills/egbe-os-domains/SKILL.md +189 -0
  71. package/skills/egbe-os-errors/SKILL.md +259 -0
  72. package/skills/egbe-os-git/SKILL.md +275 -0
  73. package/skills/egbe-os-git/references/issues.md +33 -0
  74. package/skills/egbe-os-google-ads/SKILL.md +163 -0
  75. package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
  76. package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
  77. package/skills/egbe-os-google-ads/references/conversions.md +153 -0
  78. package/skills/egbe-os-google-ads/references/delivery.md +128 -0
  79. package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
  80. package/skills/egbe-os-google-ads/references/reporting.md +105 -0
  81. package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
  82. package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
  83. package/skills/egbe-os-google-auth/SKILL.md +285 -0
  84. package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
  85. package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
  86. package/skills/egbe-os-images/SKILL.md +163 -0
  87. package/skills/egbe-os-images/references/stock-images.md +21 -0
  88. package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
  89. package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
  90. package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
  91. package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
  92. package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
  93. package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
  94. package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
  95. package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
  96. package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
  97. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
  98. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
  99. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
  100. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
  101. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
  102. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
  103. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
  104. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
  105. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
  106. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
  107. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
  108. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
  109. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
  110. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
  111. package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
  112. package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
  113. package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
  114. package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
  115. package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
  116. package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
  117. package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
  118. package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
  119. package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
  120. package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
  121. package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
  122. package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
  123. package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
  124. package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
  125. package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
  126. package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
  127. package/skills/egbe-os-llm/SKILL.md +160 -0
  128. package/skills/egbe-os-mail/SKILL.md +180 -0
  129. package/skills/egbe-os-me/SKILL.md +119 -0
  130. package/skills/egbe-os-meta-ads/SKILL.md +114 -0
  131. package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
  132. package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
  133. package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
  134. package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
  135. package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
  136. package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
  137. package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
  138. package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
  139. package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
  140. package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
  141. package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
  142. package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
  143. package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
  144. package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
  145. package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
  146. package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
  147. package/skills/egbe-os-notifications/SKILL.md +78 -0
  148. package/skills/egbe-os-openai-ads/SKILL.md +149 -0
  149. package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
  150. package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
  151. package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
  152. package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
  153. package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
  154. package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
  155. package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
  156. package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
  157. package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
  158. package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
  159. package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
  160. package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
  161. package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
  162. package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
  163. package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
  164. package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
  165. package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
  166. package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
  167. package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
  168. package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
  169. package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
  170. package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
  171. package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
  172. package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
  173. package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
  174. package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
  175. package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
  176. package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
  177. package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
  178. package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
  179. package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
  180. package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
  181. package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
  182. package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
  183. package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
  184. package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
  185. package/skills/egbe-os-payments/SKILL.md +215 -0
  186. package/skills/egbe-os-payments/agents/openai.yaml +4 -0
  187. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
  188. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
  189. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
  190. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
  191. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
  192. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
  193. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
  194. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
  195. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
  196. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
  197. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
  198. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
  199. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
  200. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
  201. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
  202. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
  203. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
  204. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
  205. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
  206. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
  207. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
  208. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
  209. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
  210. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
  211. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
  212. package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
  213. package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
  214. package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
  215. package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
  216. package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
  217. package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
  218. package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
  219. package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
  220. package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
  221. package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
  222. package/skills/egbe-os-playbook/SKILL.md +79 -0
  223. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
  224. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
  225. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
  226. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
  227. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
  228. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
  229. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
  230. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
  231. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
  232. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
  233. package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
  234. package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
  235. package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
  236. package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
  237. package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
  238. package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
  239. package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
  240. package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
  241. package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
  242. package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
  243. package/skills/egbe-os-playbook/playbooks/product.md +67 -0
  244. package/skills/egbe-os-playbook/references/catalog.md +127 -0
  245. package/skills/egbe-os-playbook/references/changes.md +167 -0
  246. package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
  247. package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
  248. package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
  249. package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
  250. package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
  251. package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
  252. package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
  253. package/skills/egbe-os-product-auth/SKILL.md +151 -0
  254. package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
  255. package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
  256. package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
  257. package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
  258. package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
  259. package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
  260. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
  261. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
  262. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
  263. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
  264. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
  265. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
  266. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
  267. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
  268. package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
  269. package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
  270. package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
  271. package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
  272. package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
  273. package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
  274. package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
  275. package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
  276. package/skills/egbe-os-product-build/SKILL.md +111 -0
  277. package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
  278. package/skills/egbe-os-product-build/references/capabilities.md +25 -0
  279. package/skills/egbe-os-product-build/references/engineering.md +72 -0
  280. package/skills/egbe-os-product-build/references/execution.md +55 -0
  281. package/skills/egbe-os-product-build/references/foundations.md +93 -0
  282. package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
  283. package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
  284. package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
  285. package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
  286. package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
  287. package/skills/egbe-os-product-market-research/SKILL.md +159 -0
  288. package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
  289. package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
  290. package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
  291. package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
  292. package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
  293. package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
  294. package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
  295. package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
  296. package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
  297. package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
  298. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
  299. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
  300. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
  301. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
  302. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
  303. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
  304. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
  305. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
  306. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
  307. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
  308. package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
  309. package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
  310. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
  311. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
  312. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
  313. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
  314. package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
  315. package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
  316. package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
  317. package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
  318. package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
  319. package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
  320. package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
  321. package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
  322. package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
  323. package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
  324. package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
  325. package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
  326. package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
  327. package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
  328. package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
  329. package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
  330. package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
  331. package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
  332. package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
  333. package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
  334. package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
  335. package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
  336. package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
  337. package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
  338. package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
  339. package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
  340. package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
  341. package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
  342. package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
  343. package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
  344. package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
  345. package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
  346. package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
  347. package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
  348. package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
  349. package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
  350. package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
  351. package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
  352. package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
  353. package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
  354. package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
  355. package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
  356. package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
  357. package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
  358. package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
  359. package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
  360. package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
  361. package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
  362. package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
  363. package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
  364. package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
  365. package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
  366. package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
  367. package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
  368. package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
  369. package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
  370. package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
  371. package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
  372. package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
  373. package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
  374. package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
  375. package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
  376. package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
  377. package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
  378. package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
  379. package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
  380. package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
  381. package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
  382. package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
  383. package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
  384. package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
  385. package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
  386. package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
  387. package/skills/egbe-os-product-report/SKILL.md +150 -0
  388. package/skills/egbe-os-product-report/references/artifacts.md +84 -0
  389. package/skills/egbe-os-product-report/references/brief.md +34 -0
  390. package/skills/egbe-os-product-report/references/daily.md +76 -0
  391. package/skills/egbe-os-product-report/references/sources.md +68 -0
  392. package/skills/egbe-os-product-routines/SKILL.md +166 -0
  393. package/skills/egbe-os-product-routines/references/catalog.md +22 -0
  394. package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
  395. package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
  396. package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
  397. package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
  398. package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
  399. package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
  400. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
  401. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
  402. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
  403. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
  404. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
  405. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
  406. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
  407. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
  408. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
  409. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
  410. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
  411. package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
  412. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
  413. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
  414. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
  415. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
  416. package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
  417. package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
  418. package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
  419. package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
  420. package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
  421. package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
  422. package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
  423. package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
  424. package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
  425. package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
  426. package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
  427. package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
  428. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
  429. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
  430. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
  431. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
  432. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
  433. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
  434. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
  435. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
  436. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
  437. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
  438. package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
  439. package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
  440. package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
  441. package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
  442. package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
  443. package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
  444. package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
  445. package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
  446. package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
  447. package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
  448. package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
  449. package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
  450. package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
  451. package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
  452. package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
  453. package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
  454. package/skills/egbe-os-report-ui/SKILL.md +133 -0
  455. package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
  456. package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
  457. package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
  458. package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
  459. package/skills/egbe-os-report-ui/references/components.md +209 -0
  460. package/skills/egbe-os-research/SKILL.md +125 -0
  461. package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
  462. package/skills/egbe-os-scrape/SKILL.md +160 -0
  463. package/skills/egbe-os-search/SKILL.md +182 -0
  464. package/skills/egbe-os-search/references/google-places.md +81 -0
  465. package/skills/egbe-os-support/SKILL.md +149 -0
  466. package/skills/egbe-os-telemetry/SKILL.md +344 -0
  467. package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
  468. package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
  469. package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
  470. package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
  471. package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
  472. package/skills/egbe-os-tools/SKILL.md +180 -0
  473. package/skills/egbe-os-tools/references/theona.md +26 -0
  474. package/skills/egbe-os-wallet/SKILL.md +181 -0
  475. package/skills/egbe-setup/EGBE.md +484 -0
  476. package/skills/egbe-setup/SKILL.md +116 -0
  477. package/skills/egbe-setup/references/project.md +80 -0
  478. package/state.js +37 -0
  479. package/update.js +361 -0
@@ -0,0 +1,125 @@
1
+ ---
2
+ name: egbe-os-research
3
+ description: Run and resume deep multi-source research.
4
+ metadata:
5
+ egbe-when: "Use when a question needs in-depth evidence or a research job needs continuation."
6
+ egbe-visible: "true"
7
+ egbe-title: "Deep research"
8
+ egbe-description: "Investigate a question across multiple sources and get a structured report with supporting evidence."
9
+ egbe-category: "AI & data"
10
+ ---
11
+
12
+ <!-- egbe-mcp-connection:v1 -->
13
+ This skill comes with the Egbe plugin. If this project has its own installed copy
14
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
15
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
16
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
17
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
18
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
19
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
20
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
21
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
22
+ holds one part of a long body; read the next part with `egbe_read`, the same
23
+ `path` and `business`, and that `continuation`.
24
+ Read bundled files beside this `SKILL.md`. For published skill resources on
25
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
26
+
27
+ Publishing works through the connector: commit the app's files with the JSON
28
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
29
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
30
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
31
+ set-up project workspace. In a persistent
32
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
33
+ project setup describes.
34
+ Without such a workspace, or if it refuses, tell the founder that this step needs
35
+ an agent with a set-up project folder, and continue with the rest of the work.
36
+
37
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
38
+ available, the plugin's connector is not signed in for this agent. Tell
39
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
40
+ saying Egbe is unavailable.
41
+
42
+ The connector's tools work even where this environment's shell cannot reach
43
+ Egbe: their calls travel through this agent's connection, not through the
44
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
45
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
46
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
47
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
48
+ the founder: they allow that host in this agent's network settings or continue
49
+ with an agent on their own computer. Code can also be published without the
50
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
51
+ Until the shell step or that commit and its deploy succeed, do not report the
52
+ work as published: a preview in this agent or on this computer is not an Egbe
53
+ deployment.
54
+
55
+
56
+ # Deep research
57
+
58
+ Use this capability when a task needs a cited, multi-source web research report.
59
+ OS owns the engine and model routing; callers provide the research question and
60
+ instructions, never a provider or model.
61
+
62
+ Research is asynchronous. Submit once with a stable idempotency key, persist the
63
+ returned job ID, and poll that job until it reaches a terminal state.
64
+
65
+ Authenticate with `Authorization: Bearer $OS_API_KEY`. Base URL: `$OS_URL`
66
+ (`https://os.hz.egbe.dev`).
67
+
68
+ ## Submit or recover a job
69
+
70
+ ```bash
71
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/research" -s -X POST \
72
+ -H 'Content-Type: application/json' \
73
+ -d '{
74
+ "query": "Market demand and competitors for AI tutoring apps for European teens in 2026",
75
+ "instructions": "Return cited Markdown. Separate verified facts, estimates, and evidence gaps.",
76
+ "depth": "deep",
77
+ "idempotency_key": "market-research:target-audience:INPUT_SHA256"
78
+ }'
79
+ ```
80
+
81
+ - `query` contains the question and relevant product context.
82
+ - `instructions` contains stable scope, evidence, and output requirements.
83
+ - `depth` is `standard` or `deep`.
84
+ - `idempotency_key` identifies this exact logical attempt. Repeating it returns
85
+ the same job and does not spend another quota unit.
86
+
87
+ Persist `data.id` before doing other work. Through the Egbe connector without a
88
+ project folder, persist it, and later the result you rely on, in Egbe's artifact
89
+ store (for example `research/<id>/job.json`), as `egbe-os-quickstart` →
90
+ `references/artifact-sync.md` ("Through the Egbe connector") describes. A job ID
91
+ kept only in the conversation cannot be recovered after it.
92
+
93
+ ## Poll
94
+
95
+ ```bash
96
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/research/<job-id>" -s
97
+ ```
98
+
99
+ Statuses are `queued`, `running`, `completed`, and `failed`.
100
+
101
+ When completed, read `data.result.markdown`. Do not fetch a public report URL as
102
+ an agent input. On failure, inspect `data.error.code` and
103
+ `data.error.retryable`; do not silently switch providers or write substitute
104
+ research.
105
+
106
+ ## Recover after an interruption or failure
107
+
108
+ - If submission/polling is interrupted, reuse the same payload and key (or poll
109
+ the saved job ID). A lost POST response does not mean the job was not accepted.
110
+ - `failed` is terminal. Repeating its key returns that failure, not a requeue;
111
+ HTTP 202 alone does not mean the engine is running. Read `data.status`.
112
+ - For `retryable: true`, a transient failure permits one deliberate new attempt
113
+ after a short wait. Persist a new stable key, e.g. append `:retry-1`, and reuse
114
+ that key for all submission/polling recovery. Stop and report repeated failure.
115
+ - For `retryable: false`, report the error and job ID. Model-access or upstream
116
+ authentication errors require Egbe to repair the service configuration. Start
117
+ a new attempt/key only after the cause is addressed.
118
+
119
+ ## Limits
120
+
121
+ Each newly accepted idempotent job consumes one of 20 monthly research jobs per
122
+ instance. Polls, result reads, and duplicate submissions with the same key do
123
+ not consume another unit.
124
+ Failed jobs receive a best-effort quota refund; a failed refund does not permit
125
+ bypassing the quota limit.
@@ -0,0 +1,188 @@
1
+ ---
2
+ name: egbe-os-saas-unit-economics
3
+ description: Calculate subscription customer value, acquisition costs and funnel requirements from grounded inputs.
4
+ metadata:
5
+ egbe-when: "Offer when pricing or acquisition decisions need a viability check."
6
+ version: "1.4.0"
7
+ egbe-visible: "true"
8
+ egbe-title: "SaaS unit economics"
9
+ egbe-description: "Check subscription economics with measured data, explicit scenarios and traceable calculations."
10
+ egbe-category: "Business operations"
11
+ openclaw:
12
+ requires:
13
+ env: ["OS_API_KEY", "OS_URL"]
14
+ bins: ["curl", "jq"]
15
+ primaryEnv: "OS_API_KEY"
16
+ emoji: "💰"
17
+ os: ["linux", "darwin"]
18
+ ---
19
+
20
+ <!-- egbe-mcp-connection:v1 -->
21
+ This skill comes with the Egbe plugin. If this project has its own installed copy
22
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
23
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
24
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
25
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
26
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
27
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
28
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
29
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
30
+ holds one part of a long body; read the next part with `egbe_read`, the same
31
+ `path` and `business`, and that `continuation`.
32
+ Read bundled files beside this `SKILL.md`. For published skill resources on
33
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
34
+
35
+ Publishing works through the connector: commit the app's files with the JSON
36
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
37
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
38
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
39
+ set-up project workspace. In a persistent
40
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
41
+ project setup describes.
42
+ Without such a workspace, or if it refuses, tell the founder that this step needs
43
+ an agent with a set-up project folder, and continue with the rest of the work.
44
+
45
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
46
+ available, the plugin's connector is not signed in for this agent. Tell
47
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
48
+ saying Egbe is unavailable.
49
+
50
+ The connector's tools work even where this environment's shell cannot reach
51
+ Egbe: their calls travel through this agent's connection, not through the
52
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
53
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
54
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
55
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
56
+ the founder: they allow that host in this agent's network settings or continue
57
+ with an agent on their own computer. Code can also be published without the
58
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
59
+ Until the shell step or that commit and its deploy succeed, do not report the
60
+ work as published: a preview in this agent or on this computer is not an Egbe
61
+ deployment.
62
+
63
+
64
+ # Subscription unit economics
65
+
66
+ Calculate the economics needed for the current question using product evidence,
67
+ applicable benchmarks and explicit assumptions. Take the question and acceptable
68
+ risk from the caller's concrete task or plan. This skill supplies
69
+ calculations and validity checks, not a standing target for LTV/CAC, channel mix,
70
+ spend or conversion.
71
+
72
+ Reuse the product's existing `egbe-docs/product/economics.md` or linked test
73
+ calculation. Preserve measured values, sources and relevant prior assumptions;
74
+ do not overwrite them with a fresh benchmark forecast. Save only the calculations
75
+ needed for the task, not a compulsory full metric table or new master report.
76
+
77
+ ## Establish the applicable inputs
78
+
79
+ Read the supplied brief, file, pricing page and existing records. Confirm which
80
+ product is meant only if ambiguous. Use an available browser when prices are
81
+ client-rendered; if unavailable, request the consequential missing price or leave
82
+ that scenario conditional. Do not infer current prices from search snippets.
83
+
84
+ These formulas apply to recurring monthly/annual subscription revenue. Identify
85
+ the actual billing, customer and cost units. A newsletter subscription and a
86
+ workflow SaaS can both recur but need different retention and cost evidence.
87
+ One-time purchases, transaction take-rates, ad revenue, and pure usage billing
88
+ need another model: explain the mismatch and do not force them into perpetual
89
+ monthly ARPU/churn. In a hybrid business, isolate the supported subscription
90
+ component and state what the calculation excludes.
91
+
92
+ Reuse observed cohort data when definitions, maturity and periods fit. Distinguish
93
+ observed values, externally observed benchmarks, product estimates and chosen
94
+ scenario assumptions. Do not invent a tier mix, churn adjustment, geography
95
+ discount, target ratio or conversion split to fill a table. Ask only for missing
96
+ inputs that would change the current decision; otherwise show a range, conditional
97
+ calculation or unavailable metric and explain what remains useful.
98
+
99
+ ## Ground research and costs
100
+
101
+ Research only decision-relevant gaps. Before using Egbe search, read the live
102
+ `GET /search/skill`; the configured `OS_URL` and project `OS_API_KEY` need `tools`
103
+ scope. Credentials stay out of artifacts. This is an example query, not a
104
+ mandatory research stage or claim about the category:
105
+
106
+ ```bash
107
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/brave" -fsS \
108
+ -H "Content-Type: application/json" \
109
+ -d '{"query":"monthly customer churn <relevant subscription category> cohort benchmark <current-year>","count":5}' \
110
+ | jq '.data.results[] | {title, url, snippet}'
111
+ ```
112
+
113
+ Results use `data.results` and `snippet`; OS does not expose Brave's raw
114
+ `freshness` option. Verify publication dates and definitions on original pages.
115
+ An unavailable search source is a coverage gap, not permission to invent figures
116
+ or discard valid product data already available.
117
+
118
+ Compare category, buyer, product maturity, billing interval, acquisition channel,
119
+ geography, date, and measurement definition before applying a benchmark. Keep
120
+ reported ranges and sample limitations. A best-in-class statistic is not typical;
121
+ neither the low end nor midpoint of a published range is automatically a product
122
+ estimate. Triangulate consequential uncertain inputs where useful, without a
123
+ fixed source quota or averaging incompatible channels/cohorts. Explain any chosen
124
+ summary and adjustment. No automatic geographic or maturity multipliers apply.
125
+
126
+ Build product-specific COGS from applicable costs: hosting, storage/database,
127
+ third-party/AI usage, payment fees, support, and recurring content production,
128
+ localization or licensing where relevant. Use actual contracts/usage or labeled
129
+ estimates at a stated scale. Do not assume future volume discounts or optimized
130
+ support costs already exist. Separate fixed and variable costs and avoid counting
131
+ them twice; scenario comparisons can expose scale sensitivity. Include payment
132
+ fees at the actual billing frequency and applicable fee schedule, not a universal
133
+ processor percentage. Preserve links or other provenance for cost inputs.
134
+
135
+ ## Calculations and validity
136
+
137
+ Use consistent currency, periods, population and gross/net revenue definitions.
138
+ Keep full precision internally and round for presentation. Rates below are
139
+ fractions, not percentage-point values.
140
+
141
+ | Quantity | Calculation | Conditions |
142
+ | --- | --- | --- |
143
+ | Monthly revenue per paying customer | recurring monthly revenue / paying customers | Same population and period; label a per-user denominator differently. Normalize annual revenue to monthly when comparing earned recurring revenue, not cash receipts. |
144
+ | Scenario ARPU from tiers | `sum(weight_i * monthly_price_i)` | Supported or explicitly proposed mix; nonnegative weights sum to one. Include discounts and billing mix where material. With no credible mix, show relevant tier/scenario values instead. |
145
+ | Gross margin | `(revenue - COGS) / revenue` | Positive revenue and compatible costs/periods. Negative margin is possible; do not clamp it or force a benchmark band. |
146
+ | Monthly customer churn | churned eligible customers / customers exposed to churn | Use a coherent cohort and exposure window; distinguish customer churn, revenue churn, refunds and net revenue retention. |
147
+ | Constant-hazard monthly equivalent | `1 - (1 - annual_customer_churn) ** (1/12)` | Only a conversion under constant monthly survival, not a measured monthly cohort rate or annual-contract cancellation cadence. |
148
+ | Approximate expected lifetime | `1 / monthly_customer_churn` months | Constant churn model with `0 < churn <= 1`; zero observed churn in a short/small cohort does not establish infinite lifetime. |
149
+ | Approximate gross-profit LTV | `ARPU * gross_margin / monthly_customer_churn` | Same steady-state model; excludes discounting, expansion and varying retention/cost. Label as a model, not guaranteed lifetime value. Use cohort/horizon contribution when this model does not fit. |
150
+ | Observed acquisition cost | attributable acquisition cost / acquired customers | State media-only vs fully loaded cost and comparable attribution/cohort window. No observed customers means undefined CAC, not zero or a fabricated finite number. |
151
+ | CPC | paid-media spend / measured ad clicks | Same source and window; zero clicks leaves CPC undefined. A click is not automatically a product visit. |
152
+ | Conditional required click-to-customer rate | `CPC / proposed_CAC` | Positive proposed CAC and consistent media-only cost basis. This is a requirement, not a forecast; greater than one is infeasible under the assumptions. |
153
+ | Conditional affordable CPC | `proposed_CAC * supported_click_to_customer_rate` | The conversion rate needs appropriate cohort evidence or an explicit scenario. It is not a provider bid recommendation. |
154
+
155
+ An affordable CAC is a plan decision, not LTV divided by a built-in constant.
156
+ If the plan chooses a positive LTV/CAC target `r`, its implied ceiling is `LTV/r`;
157
+ if it chooses a payback horizon, relate acquisition cost to contribution during
158
+ that horizon and state retention/cash-flow assumptions. Do not require either
159
+ target when the question can be answered without it. LTV-based sustainability
160
+ and a limited learning budget are different quantities.
161
+
162
+ Funnel stage probabilities can be multiplied only for linked conditional stages
163
+ of the same cohort: `P(signup | click) * P(paid | signup)` yields click-to-paid
164
+ when those stages cover the relevant path. Add arrival loss if starting at clicks
165
+ and the measured funnel starts at visits. Separate cohorts and unrelated period
166
+ totals do not establish these rates. A total conversion rate alone cannot identify
167
+ the stage split; leave it unidentified unless evidence or a labeled scenario
168
+ supplies an independent stage rate. There is no fixed signup/payment ratio.
169
+
170
+ Check finite values, positive denominators, rate bounds, weight sums and units.
171
+ An impossible required rate, nonpositive contribution or incompatible model is
172
+ an informative limitation, not a reason to hide the result or declare the whole
173
+ product unviable. Distinguish a mathematical error from an unsupported assumption.
174
+ Sensitivity cases should vary consequential assumptions coherently, not combine
175
+ every favorable cost with every unfavorable market statistic by rule.
176
+
177
+ ## Return a traceable answer
178
+
179
+ Show the relevant observed/scenario metrics with units, scope and calculation
180
+ inputs. Record source URLs or file references, collection dates, original ranges,
181
+ definitions, chosen assumptions and material exclusions beside the calculation
182
+ or in a short source log. Do not label modeled LTV a proven minimum, a required
183
+ conversion rate an expected result, or provider CPC a guaranteed future cost.
184
+
185
+ Explain which assumption changes the answer and which evidence would improve it.
186
+ Return the supported calculation and implications to the caller; do not
187
+ change prices, budgets or campaigns as part of this calculation. Match the
188
+ founder's language and preserve unknowns instead of requiring every metric.
@@ -0,0 +1,160 @@
1
+ ---
2
+ name: egbe-os-scrape
3
+ description: Extract structured data from websites and supported platforms.
4
+ metadata:
5
+ egbe-when: "Use when research needs collected web data rather than search results."
6
+ egbe-visible: "true"
7
+ egbe-title: "Web data extraction"
8
+ egbe-description: "Collect structured information from websites for research or data-powered product features."
9
+ egbe-category: "AI & data"
10
+ ---
11
+
12
+ <!-- egbe-mcp-connection:v1 -->
13
+ This skill comes with the Egbe plugin. If this project has its own installed copy
14
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
15
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
16
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
17
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
18
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
19
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
20
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
21
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
22
+ holds one part of a long body; read the next part with `egbe_read`, the same
23
+ `path` and `business`, and that `continuation`.
24
+ Read bundled files beside this `SKILL.md`. For published skill resources on
25
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
26
+
27
+ Publishing works through the connector: commit the app's files with the JSON
28
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
29
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
30
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
31
+ set-up project workspace. In a persistent
32
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
33
+ project setup describes.
34
+ Without such a workspace, or if it refuses, tell the founder that this step needs
35
+ an agent with a set-up project folder, and continue with the rest of the work.
36
+
37
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
38
+ available, the plugin's connector is not signed in for this agent. Tell
39
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
40
+ saying Egbe is unavailable.
41
+
42
+ The connector's tools work even where this environment's shell cannot reach
43
+ Egbe: their calls travel through this agent's connection, not through the
44
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
45
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
46
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
47
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
48
+ the founder: they allow that host in this agent's network settings or continue
49
+ with an agent on their own computer. Code can also be published without the
50
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
51
+ Until the shell step or that commit and its deploy succeed, do not report the
52
+ work as published: a preview in this agent or on this computer is not an Egbe
53
+ deployment.
54
+
55
+
56
+ # Scrape (Apify)
57
+
58
+ Structured web scraping behind one shape. Address everything as
59
+ `/scrape/{source}/...` where `source` is `apify` (the only source today; more drop
60
+ in later). Authenticate with `Authorization: Bearer $OS_API_KEY`.
61
+ Base URL: `https://os.hz.egbe.dev`.
62
+
63
+ Use only the `OS_URL` and `OS_API_KEY` supplied to the current workload. Product
64
+ server code reads those same names; the Site Gateway injects a separate product
65
+ identity automatically. Never mint or deploy an Apify-specific key, and never
66
+ introduce `APIFY_API_KEY` or a direct provider token for this OS capability.
67
+
68
+ The lifecycle is the same regardless of source:
69
+ **account → discover an actor → run it → read the rows.**
70
+
71
+ ## Account
72
+
73
+ ```bash
74
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/account" -s
75
+ ```
76
+
77
+ Returns the provider account (plan, usage, remaining credit) under `data.raw`.
78
+
79
+ ## Discover an actor
80
+
81
+ An "actor" is a ready-made scraper. Search the store, or skip straight to a known
82
+ actor id if you already know one (e.g. `apify/google-search-scraper`,
83
+ `compass/crawler-google-places`, `vdrmota/contact-info-scraper`).
84
+
85
+ ```bash
86
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/actors?query=google%20maps%20reviews&limit=5" -s
87
+ ```
88
+
89
+ `data.actors` is a compact `[{id, name, title, description}]` list. For the full
90
+ input schema of one actor:
91
+
92
+ ```bash
93
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/actors/apify/google-search-scraper" -s
94
+ ```
95
+
96
+ ## Run — synchronous (default)
97
+
98
+ The simplest path: `sync` is true by default, so the call blocks and returns the
99
+ scraped rows directly. Keep `limit` small to save credits, and always set the
100
+ actor's own cap field (`maxResults`, `maxPagesPerQuery`, …) inside `input`.
101
+ A synchronous run can wait up to about 5 minutes. Through the Egbe MCP
102
+ connection, start any run that may take over a minute asynchronously (below),
103
+ because the connector's client can stop waiting before a synchronous run returns.
104
+
105
+ ```bash
106
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/run" -s -X POST \
107
+ -H 'Content-Type: application/json' \
108
+ -d '{
109
+ "actor": "apify/google-search-scraper",
110
+ "input": {"queries": "best AI tools 2026", "maxPagesPerQuery": 1, "countryCode": "us"},
111
+ "limit": 20
112
+ }'
113
+ ```
114
+
115
+ `data` carries `rows` (the scraped records), `count`, and `raw`.
116
+
117
+ ## Run — asynchronous (long jobs)
118
+
119
+ For big crawls pass `"sync": false`. You get a run handle back instead of rows;
120
+ poll the run, then read its dataset when it's `SUCCEEDED`.
121
+
122
+ Send a stable `Idempotency-Key` for every logical actor run. Persist the returned
123
+ `run_id` and `dataset_id`, then reuse or poll them after a retry instead of
124
+ starting another paid run. The header is a best-effort retry identity, not a
125
+ durable exactly-once guarantee if the start response is lost before the handle
126
+ is persisted.
127
+
128
+ ```bash
129
+ # 1. start
130
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/run" -s -X POST \
131
+ -H 'Idempotency-Key: places-ramen-tokyo-v1' \
132
+ -H 'Content-Type: application/json' \
133
+ -d '{"actor":"compass/crawler-google-places","input":{"searchStringsArray":["ramen Tokyo"],"maxCrawledPlacesPerSearch":50},"sync":false}'
134
+ # -> data: {run_id, status, dataset_id}
135
+
136
+ # 2. poll
137
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/runs/<run_id>" -s
138
+
139
+ # 3. read rows once SUCCEEDED
140
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/datasets/<dataset_id>?limit=50" -s
141
+ ```
142
+
143
+ ## Passthrough — the native API
144
+
145
+ Anything the normalized verbs don't cover reaches the provider's own API:
146
+
147
+ ```bash
148
+ # GET /scrape/apify/raw/store?search=tiktok -> tools-gateway /v1/apify/store?search=tiktok
149
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/scrape/apify/raw/store?search=tiktok&limit=3" -s
150
+ ```
151
+
152
+ Body and query string are forwarded as-is.
153
+
154
+ ## Notes
155
+
156
+ - Set `$OS_URL` to `https://os.hz.egbe.dev` (or your local gateway).
157
+ - Always cap results: a `limit` on the call **and** the actor's own cap field in `input`.
158
+ - A non-empty result isn't proof of relevance — check the rows actually match the
159
+ requested place/topic/geography before trusting them.
160
+ - Actor ids accept both `user/actor` and `user~actor` forms.
@@ -0,0 +1,182 @@
1
+ ---
2
+ name: egbe-os-search
3
+ description: Search the web and local businesses; retrieve place details and Google reviews.
4
+ metadata:
5
+ egbe-when: "Use when decisions need current sources or local-business discovery."
6
+ egbe-visible: "true"
7
+ egbe-title: "Web & places search"
8
+ egbe-description: "Find web pages, local businesses, and available Google reviews for research and product features."
9
+ egbe-category: "AI & data"
10
+ ---
11
+
12
+ <!-- egbe-mcp-connection:v1 -->
13
+ This skill comes with the Egbe plugin. If this project has its own installed copy
14
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
15
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
16
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
17
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
18
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
19
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
20
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
21
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
22
+ holds one part of a long body; read the next part with `egbe_read`, the same
23
+ `path` and `business`, and that `continuation`.
24
+ Read bundled files beside this `SKILL.md`. For published skill resources on
25
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
26
+
27
+ Publishing works through the connector: commit the app's files with the JSON
28
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
29
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
30
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
31
+ set-up project workspace. In a persistent
32
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
33
+ project setup describes.
34
+ Without such a workspace, or if it refuses, tell the founder that this step needs
35
+ an agent with a set-up project folder, and continue with the rest of the work.
36
+
37
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
38
+ available, the plugin's connector is not signed in for this agent. Tell
39
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
40
+ saying Egbe is unavailable.
41
+
42
+ The connector's tools work even where this environment's shell cannot reach
43
+ Egbe: their calls travel through this agent's connection, not through the
44
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
45
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
46
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
47
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
48
+ the founder: they allow that host in this agent's network settings or continue
49
+ with an agent on their own computer. Code can also be published without the
50
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
51
+ Until the shell step or that commit and its deploy succeed, do not report the
52
+ work as published: a preview in this agent or on this computer is not an Egbe
53
+ deployment.
54
+
55
+
56
+ # Search
57
+
58
+ Web and places search behind concrete routes. Every provider returns the **same**
59
+ `SearchResponse` shape, so you parse the answer the same way no matter which one
60
+ you call. Authenticate with `Authorization: Bearer $OS_API_KEY`. A scoped key
61
+ needs the `tools` scope: without it every search route answers 403.
62
+
63
+ Base URL: `https://os.hz.egbe.dev`.
64
+
65
+ ## Unified shape
66
+
67
+ ```json
68
+ {
69
+ "provider": "brave",
70
+ "query": "best ramen in Tokyo",
71
+ "answer": null,
72
+ "results": [
73
+ {"title": "...", "url": "https://...", "snippet": "...", "score": null, "source": "brave", "metadata": {}}
74
+ ],
75
+ "citations": [],
76
+ "count": 1
77
+ }
78
+ ```
79
+
80
+ - `answer` — a synthesized text answer (only Perplexity fills this; `null` otherwise).
81
+ - `score` — a rating when the provider has one (Places stars); `null` otherwise.
82
+ - `metadata` — provider-specific extras (place_id, result age, etc.).
83
+
84
+ ## Web search (Brave) — 250/day
85
+
86
+ ```bash
87
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/brave" -s -X POST \
88
+ -H 'Content-Type: application/json' \
89
+ -d '{"query":"best ramen in Tokyo","count":5,"country":"jp","lang":"en"}'
90
+ ```
91
+
92
+ `country` selects a Brave search region, not the product's target market. The
93
+ supported values (checked 2026-09-24 against the
94
+ [official API reference](https://api-dashboard.search.brave.com/api-reference/web/search/get)) are:
95
+
96
+ ```text
97
+ AR AU AT BE BR CA CL DK FI FR DE GR HK IN ID IT JP KR MY MX NL NZ NO CN
98
+ PL PT PH RU SA ZA ES SE CH TW TR GB US ALL
99
+ ```
100
+
101
+ OS normalizes case. ISO codes outside this list, including `AE` and `OM`, are
102
+ not supported search regions. Use `country: "ALL"` with the target country,
103
+ relevant official domains (`site:`) and language in the query; `lang` sets the
104
+ search language. Record that this is all-regions search, not local market data.
105
+ Omitting `country` uses the provider's US default, not an unbiased global search.
106
+ A 422 region error is not evidence of missing demand; correct the region once
107
+ and keep the intended market unchanged. Read original pages before treating
108
+ snippets as evidence; country search results are not a company census.
109
+
110
+ ## AI research (Perplexity) — 20 successful submissions/claw/day, slow
111
+
112
+ Returns a synthesized `answer` plus `citations`. Heavily rate-limited (20 per
113
+ day per claw). This OS allowance is separate from the shared Perplexity API
114
+ credit balance. An upstream `insufficient_quota` error is a billing/credit
115
+ failure, not exhaustion of this daily allowance; stop and surface the error
116
+ instead of retrying or switching research providers.
117
+
118
+ **Deep research takes minutes — do NOT call it synchronously.** A blocking call
119
+ outlives your HTTP client timeout and you get a dropped connection (HTTP 000)
120
+ with no response body. Use the async submit/poll pair instead:
121
+
122
+ ```bash
123
+ # 1. submit — returns immediately with a request_id
124
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/perplexity/async" -s -X POST \
125
+ -H 'Content-Type: application/json' \
126
+ -d '{"query":"What changed in EU AI Act enforcement in 2026?"}'
127
+ # -> {"request_id":"<id>","status":"PENDING","poll":"GET /search/web/perplexity/async/<id>"}
128
+
129
+ # 2. poll until status is COMPLETED, FAILED, CANCELLED or INCOMPLETE
130
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/perplexity/async/<id>" -s
131
+ ```
132
+
133
+ Stop polling on any terminal status. `INCOMPLETE` means the provider stopped
134
+ before finishing (for example, output truncation); partial `answer` and `results`
135
+ may still be present. Inspect `error_message` for unsuccessful runs and preserve
136
+ the request ID rather than resubmitting automatically.
137
+
138
+ Async research uses Perplexity Agent background runs. Legacy Sonar model names
139
+ map to the provider's recommended presets (`sonar-deep-research` → `high`).
140
+ Async options: `model` (default `sonar-deep-research`), `reasoning_effort`
141
+ (`low|medium|high`), `system_prompt`.
142
+
143
+ The synchronous route still exists for quick calls, but it is bounded by a short
144
+ timeout: if it can't finish in time it returns a `504` envelope pointing you at
145
+ the async route rather than hanging.
146
+
147
+ ```bash
148
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/web/perplexity" -s -X POST \
149
+ -H 'Content-Type: application/json' \
150
+ -d '{"query":"quick fact-check","preset":"deep-research"}'
151
+ ```
152
+
153
+ Optional (sync): `preset` (research depth, default `"deep-research"`) and
154
+ `system_prompt`.
155
+
156
+ ## Places (Google) — 200/day
157
+
158
+ Local businesses. `score` is the star rating; `url` links to Google Maps.
159
+
160
+ ```bash
161
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/search/places" -s -X POST \
162
+ -H 'Content-Type: application/json' \
163
+ -d '{"query":"ramen in Shibuya","max_results":5,"region_code":"jp"}'
164
+ ```
165
+
166
+ Optional: `language_code` (e.g. `"ja"`) for localized results.
167
+
168
+ ### Place details and reviews
169
+
170
+ For business research or reputation monitoring, follow
171
+ [the Google Places workflow](references/google-places.md). It covers project
172
+ quotas, selecting `data.results[].metadata.place_id` from search, and fetching
173
+ details and available reviews through the existing OS `/tools/places/*` routes.
174
+ These operations return provider data inside the OS envelope; their shapes
175
+ are described in the workflow. Google returns at most five reviews per place,
176
+ not a complete review history.
177
+
178
+ If this skill was read inline from `/search/skill`, the supporting workflow is
179
+ available at `GET /skills/search/resources/references/google-places.md` or in
180
+ the complete `/skills/search` bundle.
181
+
182
+ List providers and the shape any time with `GET /search`.