@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,132 @@
1
+ ---
2
+ name: egbe-os-destination-readiness
3
+ description: Audit landing-page claims, visitor journey, identity, terms and data handling without changing the product.
4
+ metadata:
5
+ egbe-when: "Use before traffic or after page changes; offer when the promise or visitor path is unclear."
6
+ egbe-visible: "true"
7
+ egbe-title: "Destination readiness"
8
+ egbe-description: "Check your landing page and signup, booking or purchase path before sending traffic. Find broken steps, confusing promises and missing disclosures, with concrete fixes."
9
+ egbe-category: "Marketing & growth"
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
+ # Destination readiness
57
+
58
+ Answer: **Can the intended visitor understand this offer and safely reach the
59
+ promised next step on the current site? What must change, and why?** Think as a
60
+ careful prospective customer, not a checklist scorer. A technically reachable
61
+ page can still make the wrong promise or ask for trust it has not earned.
62
+
63
+ This is the network-independent check. It requires the product URL, intended
64
+ offer and next action, not an ad account or performance data. A caller may add
65
+ advertising-network destination references and supply an existing work folder;
66
+ apply those to the same evidence and result. For named or already planned networks,
67
+ use [network requirements](references/network-requirements.md); otherwise label
68
+ coverage common-only.
69
+
70
+ For an acquisition test, take the intended audience, promise and next step from
71
+ the caller's concrete plan. Verify that
72
+ journey; do not select a new offer, audience or test. Return a material conflict
73
+ to the same method/plan decision rather than resolving it through a redesign.
74
+
75
+ ## Through the Egbe connector
76
+
77
+ Through the connector you can read the project's source through `egbe-os-git`
78
+ and its deployments through `egbe-os-deploy`. Rendered-page and interactive
79
+ checks need a browser: use this environment's own browser tools, or a set-up
80
+ project workspace. In a persistent project workspace not set up yet, call
81
+ `egbe_local_setup`. Without either, read pages with `egbe-os-scrape` and HTTP
82
+ responses, label each interactive or visual claim unverified, and tell the
83
+ founder which check remains.
84
+
85
+ ## Workflow
86
+
87
+ 1. **Frame the actual path.** Identify the product repository and deployed URL,
88
+ the visitor's promise and intended next action from the request, site and
89
+ relevant product documents. Distinguish the advertised promise from what the
90
+ current page says. Ask only when an ambiguity changes the check; give a
91
+ recommended interpretation with the question. Prepare the run using
92
+ [evidence and output](references/report.md).
93
+ 2. **Map from the project first.** When application source is available, start
94
+ with the [focused repository inspection](references/checks.md#start-with-the-project-source).
95
+ Map each materially distinct route as promise → entry URL → primary CTA →
96
+ signup, booking or purchase destination. Include meaningful offer, locale or
97
+ device variants and where information, commitment or money is requested.
98
+ With only documents or a URL, map the public path directly.
99
+ 3. **Verify the deployed experience.** Read [checks](references/checks.md).
100
+ Use the map for targeted checks of actual entry pages, links and next steps;
101
+ capture evidence where expectations change or the implementation needs live
102
+ confirmation. Use rendered pages for interactive or visual claims;
103
+ source code and HTTP responses can corroborate but cannot prove those claims.
104
+ Prior reports are leads, not evidence that today's deployment is unchanged.
105
+ 4. **Explain the consequential gaps.** Separate observed failures, trust or
106
+ clarity problems, policy requirements and uncertainties. For each finding
107
+ explain the visitor consequence and the smallest coherent repair. A local
108
+ mismatch may require aligning the promise and destination, not merely
109
+ changing a label. Report the affected path, not a verdict about the whole
110
+ product. Reuse common observations across supplied network checks.
111
+ 5. **Check the conclusion.** Review the evidence before delivering: did a guessed URL become a claim of absence, a
112
+ provider name become a false brand alarm, an inaccessible step become a
113
+ failure, or a cosmetic preference become a blocker? Also check the reverse:
114
+ did a 200 response or polished page hide missing substance or a broken CTA?
115
+ Resolve contradictions where safe; otherwise preserve the uncertainty.
116
+ 6. **Deliver a decision the founder can act on.** Use the
117
+ [report contract](references/report.md): scope-specific conclusion, evidence,
118
+ prioritized repairs and observable recheck conditions. Explain why each
119
+ recommendation matters and link its supporting section in the founder brief.
120
+
121
+ ## Inspection boundary
122
+
123
+ Browse and read existing authorized evidence only. Do not submit forms, create
124
+ accounts/bookings/checkout sessions, send messages, pay or alter the site or
125
+ campaigns to complete a check. Inspect a CTA's action before following it if it
126
+ could create state; stop at that boundary and name what remains unverified.
127
+ Use only public or task-authorized access, and sanitize evidence before saving.
128
+
129
+ The conclusion covers destination readiness, not targeting, bids, budgets,
130
+ campaign/ad-group/ad configuration, event instrumentation or optimization.
131
+ It is neither provider approval nor a legal certification or product-demand
132
+ assessment. Lack of traffic is not a reason to postpone this check.
@@ -0,0 +1,130 @@
1
+ # Inspect the promise, not just the URL
2
+
3
+ Use these questions on the mapped visitor paths. Record what you inspected,
4
+ including satisfactory evidence and unavailable portions, so an empty findings
5
+ list is not confused with a complete check. Deepen an investigation when it can
6
+ change the conclusion; avoid unrelated routes and speculative improvements.
7
+
8
+ ## Start with the project source
9
+
10
+ When application source is available in the product repository, inspect it before
11
+ browsing the mapped paths. Trace the relevant route definitions, redirects, CTA
12
+ destinations, legal-page content and link placement, forms (including autosave
13
+ and submit handlers), and pricing/booking configuration. Follow referenced
14
+ definitions and conditions far enough to establish the active code path; a
15
+ search match alone may be unused code. Limit reading to the visitor paths under
16
+ review, not a general review of the application.
17
+
18
+ Use this map to locate defects, explain their cause and identify the files to
19
+ change, then confirm the consequential deployed entry, CTA and document paths.
20
+ Code inspection can establish an implementation defect without sending a real
21
+ request; runtime-dependent effects remain unverified until supported by evidence.
22
+ Reading a handler does not require executing it or submitting its form. A local
23
+ preview, if available, is evidence about that local version, not the deployment.
24
+
25
+ When only product documents or a URL are available, continue with public-site
26
+ inspection and state that application source was unavailable. Planning documents
27
+ describe intent; they do not establish how the application is implemented.
28
+
29
+ ## Reach the intended next step
30
+
31
+ If the inspection also informs performance analysis, fix that analysis's cutoff
32
+ before live checks. Use a fresh browser context tagged `utm_source=smoke`, retain
33
+ the marker through navigation and verify its recording where available; exclude
34
+ known inspection sessions rather than guessing from country or device.
35
+
36
+ Open the exact supplied/deployed entry URL, including meaningful query parameters,
37
+ then follow its actual primary navigation. Record initial/final URL and important
38
+ redirects. Check that the page describes the intended offer, renders usable
39
+ content, and exposes the promised action. Note errors, persistent loading,
40
+ intrusive overlays, broken controls or redirects to an unrelated product.
41
+
42
+ Inspect desktop/mobile or language variants when the intended journey uses them
43
+ or a material difference is visible. State actual device, locale and access
44
+ context. A desktop fetch is not a mobile interaction test. An authenticated
45
+ screen does not prove that a first-time visitor can reach it.
46
+
47
+ For failures, distinguish a reproducible site problem from a transient fetch,
48
+ anti-bot or inspection-tool limitation. Retry once using another appropriate
49
+ read method when it can settle that distinction. Do not turn a tool's 403 into
50
+ a claim that every visitor is blocked. HTTP 200 can still be an error shell,
51
+ placeholder or wrong page. A safe page view is not evidence that submission,
52
+ booking confirmation or payment succeeds.
53
+
54
+ ## Find and read the relevant documents
55
+
56
+ Inspect links visible in the footer, navigation, collection form, booking or
57
+ purchase step. Open the linked documents and read their substance. If none are
58
+ discoverable, a bounded check of plausible paths or supplied repository routes
59
+ can help locate them; distinguish **not found at guessed paths**, **exists but
60
+ not linked where needed**, and **linked but missing/irrelevant**.
61
+
62
+ Ask whether the visitor can learn, before committing:
63
+
64
+ - Who operates the product and handles the information being requested?
65
+ - What is collected, for what purpose, and with which relevant providers/recipients?
66
+ - What are they agreeing to or buying, including applicable renewal, cancellation,
67
+ refund or service terms?
68
+
69
+ Check that the text actually covers this product and this action, not an empty
70
+ template or an unexplained different service. A parent's policy can cover several
71
+ brands when the relationship and coverage are clear. Privacy and terms may be
72
+ under nonstandard URLs or in a combined document; filenames are not requirements.
73
+ A payment provider's own policy alone does not explain the product's handling
74
+ of customer data or its offer.
75
+
76
+ When personal data is visibly collected but its handling is not explained at
77
+ the inspected collection point or reachable documents, report that observed
78
+ disclosure gap. When a purchase hides material commercial terms, identify those
79
+ terms. Cite the applicable network rule if supplied; otherwise state the visitor
80
+ trust/decision problem rather than inventing a universal legal violation.
81
+
82
+ ## Make the identity chain understandable
83
+
84
+ Compare the brand on the entry page with the CTA destination's title/logo,
85
+ booking host, support address, legal entity and merchant identity where visible.
86
+ Look for an explanation a visitor can actually find before providing information
87
+ or money. Repository ownership knowledge alone does not provide that explanation.
88
+
89
+ A Stripe/Calendly host or a disclosed parent company is not itself a mismatch.
90
+ An unexplained second brand can create a real trust gap without proving fraud.
91
+ If a differing brand/domain is material, inspect its public site and relevant
92
+ relationship statements; a live separate product is evidence of ambiguity, not
93
+ proof that the businesses are unrelated. State what relationship is established,
94
+ what is not, and where an explanation would solve the problem.
95
+
96
+ ## Carry the offer through the handoff
97
+
98
+ Compare the actual words/values at both ends, retaining a compact before/after
99
+ record instead of “CTA inconsistent.” Check what applies:
100
+
101
+ - Booking: promised purpose, host/team, title, duration, price and visible
102
+ availability. “20-minute product demo” → “30-minute call for another brand”
103
+ needs more than a working calendar URL. No slots in one visible week does not
104
+ prove that bookings are permanently unavailable; state the inspected range.
105
+ - Signup: promised access/result, required data, payment/card requirements and
106
+ whether the action is signup, a waitlist or a sales request.
107
+ - Purchase: product/plan, amount, currency, billing period, trial/renewal terms
108
+ and material limitations visible before commitment. If checkout can only be
109
+ opened by creating a session, inspect existing authorized evidence and leave
110
+ the live handoff unverified rather than creating one.
111
+
112
+ Distinguish a disclosed change of step (for example, introductory call before a
113
+ quote) from an unexpected substitution. Identify which promise or destination
114
+ should change based on product intent; if that intent is unresolved, offer the
115
+ recommended option and one focused question. Do not rewrite the product strategy.
116
+
117
+ ## Apply data and network requirements with their actual scope
118
+
119
+ Use visible collection fields, disclosures and task-authorized observations to
120
+ identify material data-handling concerns. Ground any consent or special-category
121
+ requirement in the relevant network rule or verified applicable requirement and
122
+ explain why it applies here. Absence of a banner alone is not evidence of unlawful
123
+ tracking. This inspection does not audit event delivery or implement consent UX.
124
+
125
+ When a caller supplies network-specific references, apply them only to the
126
+ matching entry paths/formats. Read the relevant official section for a policy
127
+ finding, record its URL and retrieval date, and distinguish a requirement from
128
+ best practice. If current wording cannot be obtained, disclose the source limit;
129
+ do not upgrade a suspected policy issue into a confirmed rejection. An observed
130
+ visitor problem remains reportable on its own evidence.
@@ -0,0 +1,34 @@
1
+ # Compose destination checks with network requirements
2
+
3
+ Use the requested or already planned networks and actual destination paths, not
4
+ every network available in Egbe. Read relevant offer/campaign records, resolving
5
+ material URL or promise conflicts through read-only readback when available.
6
+ No ad account or traffic is needed to inspect a known public destination.
7
+ Deduplicate identical paths while preserving locale, device or offer differences.
8
+
9
+ Read only the applicable destination reference from the installed bundle:
10
+
11
+ | Network | Skill | Reference |
12
+ | --- | --- | --- |
13
+ | Google | `egbe-os-google-ads` | `references/search-assets.md#destination-and-attribution` |
14
+ | Meta | `egbe-os-meta-ads` | `references/destination-requirements.md` |
15
+ | Reddit | `egbe-os-reddit-ads` | `references/destination-requirements.md` |
16
+ | LinkedIn | `egbe-os-linkedin-ads` | `references/destination-requirements.md` |
17
+ | OpenAI | `egbe-os-openai-ads` | `references/destination-requirements.md` |
18
+
19
+ Discover a missing bundle through `GET /skills` and its returned bundle URL.
20
+ If the delivered reference is still unavailable after refreshing it, complete
21
+ supported checks and name the missing coverage; do not invent policy or load
22
+ every launch workflow. For a material policy finding, verify the relevant
23
+ official source and record its date/applicability.
24
+
25
+ Reuse the common inspection evidence and return one scoped result. Inspect an
26
+ ad's promise/URL only as input to the visitor path; targeting, bids, configuration,
27
+ conversion instrumentation and optimization are not destination checks. Provider
28
+ moderation alone neither proves nor disproves path readiness. Policy uncertainty
29
+ is not confirmed rejection.
30
+
31
+ Keep the skill's read-only boundary, including forms, bookings and checkout.
32
+ Stop at unavailable or mutating steps and state what remains unverified instead
33
+ of marking the whole site broken. Reuse the caller's evidence/results when this
34
+ is a nested check; do not require another report pack or rerun unchanged paths.
@@ -0,0 +1,116 @@
1
+ # Evidence and destination report
2
+
3
+ ## One run, inspectable evidence
4
+
5
+ Use the caller's audit directory when supplied. Otherwise create a unique
6
+ `egbe-docs/audits/<YYYY-MM-DD-HHMMSSZ>-destination/` under the product repository using
7
+ the actual UTC time, with a suffix on collision. Resume only when explicitly
8
+ continuing that run. Do not overwrite previous runs or commit/push as part of
9
+ inspection. If the repo is unavailable, use a temporary run and state its path
10
+ and the missing repository handoff.
11
+
12
+ Keep the scoped conclusion and necessary sanitized evidence together. For a
13
+ standalone inspection, save `report.md` and a concise founder handoff; for a
14
+ nested check, use the caller's existing results and source index. Do not require
15
+ separate draft, review or duplicate summary files. Preserve previous work.
16
+
17
+ In the existing source record or report, record the question, product/URL, run time, known deployment,
18
+ selected paths/networks and selection basis, prior report, and completion limits.
19
+ For each read, retain URL or source path/line, time, method/context, saved evidence
20
+ file, relevant redirects, outcome and unavailable portions. For code evidence,
21
+ record the inspected revision and relevant uncommitted changes; note whether it
22
+ matches the deployed version or that the relationship is unknown. Save necessary
23
+ page/code excerpts, link inventories, screenshots or sanitized readbacks before
24
+ deriving findings.
25
+ Retain query parameters that affect the offer, but redact tokens, signed URLs
26
+ and personal values before writing. Do not save browser/session credentials or
27
+ customer records. Evidence capture is selective, not a full private-site export.
28
+
29
+ ## Full report
30
+
31
+ Lead with the answer in ordinary language, then support it with these sections.
32
+ Use detail proportional to the actual paths/findings, not a word-count target.
33
+
34
+ ### Decision and coverage
35
+
36
+ Give a conclusion for each distinct affected path and, when checked, network:
37
+
38
+ - **Ready within inspected scope:** the relevant checks are supported by
39
+ evidence, with no material defect or unresolved uncertainty in that scope.
40
+ - **Changes needed:** an observed problem needs repair before recommending
41
+ traffic through the affected path. Explain why; do not count cosmetic
42
+ preferences as blockers. List consequential unknowns separately if also present.
43
+ - **Verification needed:** a consequential part cannot be concluded from the
44
+ available evidence. Name the missing check and the smallest way to resolve it.
45
+
46
+ Show the inspection boundary, time and untested portions alongside the conclusion.
47
+ Distinguish defects established in local code, behavior observed on the deployed
48
+ site and unverified runtime effects. State any material version mismatch; a
49
+ source-only or local-preview check does not establish deployed readiness.
50
+ If only entry-to-form was verified, do not imply completed signup or payment.
51
+ Mark irrelevant checks **not applicable** with a short reason. Distinguish a
52
+ common-only result from a result including named network requirements. A clear
53
+ path can remain usable even when another path needs changes.
54
+
55
+ ### Visitor path and observations
56
+
57
+ Map promise → entry → CTA → next step with exact safe URLs, meaningful values
58
+ (such as duration and price), and evidence links. Include enough positive checks
59
+ to explain the scope of a ready conclusion. Avoid a giant list of unchecked
60
+ pages; list material exclusions and why they matter instead.
61
+
62
+ ### Findings and repairs
63
+
64
+ For each material finding provide:
65
+
66
+ - Expected vs observed behavior and links to both pieces of evidence.
67
+ - Visitor consequence: what becomes impossible, unclear or unexpectedly costly.
68
+ Distinguish demonstrated behavior from a hypothesis about conversion impact.
69
+ - Basis: functional defect, trust/offer clarity, or specific network requirement
70
+ with official source and applicability. Identify affected paths/networks once.
71
+ - Priority with rationale: repair before traffic, resolve before deciding, or
72
+ non-blocking improvement. Do not infer severity from the number of networks.
73
+ - Smallest coherent correction, affected implementation file/line and responsible
74
+ role when known, and a concrete observable recheck condition. Do not silently
75
+ implement the recommendation.
76
+
77
+ Group shared root causes without losing distinct repairs. A missing disclosure
78
+ and wrong calendar duration may share a path but need different fixes. Questions
79
+ come with a recommended answer/action where applicable, not a bare list of unknowns.
80
+
81
+ ### Limits and next decision
82
+
83
+ State what could change the conclusion, which source/access gaps need resolution,
84
+ and exactly what to recheck after repairs. Destination defects are conditions on
85
+ the path, not evidence that the market or product is unviable. Network approval
86
+ and overall campaign readiness remain outside this report.
87
+
88
+ ## Review and founder handoff
89
+
90
+ Check evidence links, policy applicability, scope and counterevidence before
91
+ delivery. Correct the conclusion and retain consequential unresolved gaps in
92
+ the same record; derive the founder handoff from that checked result.
93
+ Keep both report and brief limited to visitor-path findings. Return incidental
94
+ ad configuration, conversion-binding, attribution or optimization findings to
95
+ the caller's channel analysis; an out-of-scope link is enough here, not repeated
96
+ diagnostics or readiness conditions. Functional form persistence and visitor
97
+ feedback remain destination checks, unlike recording that action as an ad conversion.
98
+
99
+ The brief answers: can we send visitors through the inspected path, why/why not,
100
+ what should change first, and what still needs checking? Include meaningful
101
+ positive results as well as blockers. Write in the founder's language: explain
102
+ what visitors experience, why it matters and what to do next in everyday words.
103
+ Keep inspection jargon and protocol details in the linked report; retain exact
104
+ URLs, names or identifiers in the brief when needed to locate or fix something.
105
+ Explain an unavoidable specialist term at first use. Link decisions, observations,
106
+ limits and recommendations to their exact report sections, not only to the
107
+ report's beginning. Do not replace the explanation with IDs or status jargon.
108
+
109
+ Make the brief scannable with short, meaningful subheadings and bullets for
110
+ parallel findings or conditions; number actions when their order matters. Keep
111
+ one main point per item, with its reason, qualification and supporting link.
112
+ Use short prose for the opening decision and transitions, and emphasis only for
113
+ key decisions or limits, rather than turning every sentence into a heading or list.
114
+
115
+ Return the brief and the
116
+ full report path; call an unfinished inspection incomplete.
@@ -0,0 +1,189 @@
1
+ ---
2
+ name: egbe-os-domains
3
+ description: Assign/move .egbe.app addresses or arrange admin setup of custom domains.
4
+ metadata:
5
+ egbe-when: "Use when a deployed app needs a named address or domain change."
6
+ egbe-category: "Development & hosting"
7
+ egbe-visible: "true"
8
+ egbe-title: "Website addresses & domains"
9
+ egbe-description: "Choose or move your .egbe.app address, or arrange a custom domain with help from the Egbe team."
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
+ # Your app's public address
57
+
58
+ Every app you deploy always has a **canonical host** — `my-app-e64a1fbe2153.n.egbe.app`.
59
+ It works, but it carries your instance id, so it reads like plumbing rather than
60
+ a product.
61
+
62
+ A **domain** is a second, prettier address layered on top: `my-app.egbe.app`.
63
+ Both point at the same app. The canonical host never stops serving, so attaching
64
+ or releasing a domain can't take your app down.
65
+
66
+ Base URL: `https://os.hz.egbe.dev`. Authenticate every call with
67
+ `Authorization: Bearer $OS_API_KEY`.
68
+
69
+ ## You usually don't have to do anything
70
+
71
+ Your **first deploy claims a domain for you** from the app's slug: deploy
72
+ `my-app` and it comes up on `https://my-app.egbe.app`. The deploy response and
73
+ `GET /deploy/<slug>` both carry it:
74
+
75
+ ```bash
76
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/deploy/my-app" -s
77
+ # data: { "host": "my-app-e64a1fbe2153.n.egbe.app", <- canonical, always serves
78
+ # "domain": "my-app.egbe.app", <- the alias, null if none
79
+ # "url": "https://my-app.egbe.app" } <- give THIS to customers
80
+ ```
81
+
82
+ Always hand customers `url`. It is the domain when you have one and falls back to
83
+ the canonical host when you don't, so it is correct either way.
84
+
85
+ ## Choosing a different name
86
+
87
+ Use the founder's selected name or recorded naming delegation. Otherwise suggest
88
+ available alternatives without claiming availability before verification,
89
+ recommend one and wait for a choice or delegation, once or throughout this
90
+ business. A taken name is not permission to silently choose another public brand.
91
+ Apply the same decision boundary before releasing or redirecting an established
92
+ customer-facing address; return unresolved choices to the caller when needed.
93
+
94
+ ```bash
95
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/domains" -s -X POST \
96
+ -H 'Content-Type: application/json' \
97
+ -d '{"slug":"my-app","name":"acme"}' # -> https://acme.egbe.app
98
+ ```
99
+
100
+ `name` is the label only — letters, digits and dashes, no dots. `acme` becomes
101
+ `acme.egbe.app`. Names are first-come, first-served across the whole platform: a
102
+ name another business already holds comes back as `domain_taken`, and a handful
103
+ of platform names (`www`, `mail`, `api`, `admin`, …) are reserved.
104
+
105
+ ## One domain per business
106
+
107
+ The limit is `site-gateway:domains`, **1**. It is an inventory limit — it never
108
+ resets; you free it by releasing the domain.
109
+
110
+ ```bash
111
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/me/limits?resource=site-gateway:domains" -s
112
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/domains" -s # what you hold, and where it points
113
+ ```
114
+
115
+ So a second app does **not** get a pretty address — it stays on its canonical
116
+ host, and the deploy response says so in `warnings`. That is deliberate: a
117
+ business ships one brand.
118
+
119
+ ## Moving it to another app
120
+
121
+ Pointing your existing domain at a different app is a move, not a second claim —
122
+ it does not need a release first:
123
+
124
+ ```bash
125
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/domains" -s -X POST \
126
+ -H 'Content-Type: application/json' \
127
+ -d '{"slug":"my-other-app","name":"acme"}'
128
+ ```
129
+
130
+ To give the name up entirely and free your slot:
131
+
132
+ ```bash
133
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/domains/my-other-app" -s -X DELETE
134
+ ```
135
+
136
+ Deleting an app (`DELETE /deploy/<slug>`) releases its domain for you.
137
+
138
+ ## Bring your own domain (client landings, requires Egbe admin setup)
139
+
140
+ A paid-ads test for a **client** must land on the client's own domain
141
+ (`try.client.tld`), not on `*.egbe.app`: Meta verifies the destination domain
142
+ in the advertiser's Business Manager, Google rejects landings on an unrelated
143
+ domain, and attribution breaks when the funnel continues on the client's site.
144
+
145
+ This is a separate allowance, `site-gateway:external-domains`, and it is **0 by
146
+ default** — an Egbe admin raises it for the one business running the test. Until
147
+ then the call below comes back `external_domain_limit_reached`. It does not
148
+ touch your `<name>.egbe.app` alias: an app can carry both.
149
+
150
+ ```bash
151
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/domains" -s -X POST \
152
+ -H 'Content-Type: application/json' \
153
+ -d '{"slug":"landing","host":"try.client.tld"}'
154
+ # data: { "host": "try.client.tld", "url": "https://try.client.tld", "external": true,
155
+ # "dns": [ { "type":"CNAME", "name":"try.client.tld",
156
+ # "value":"landing-e64a1fbe2153.n.egbe.app" },
157
+ # { "type":"CNAME", "name":"_acme-challenge.try.client.tld",
158
+ # "value":"_acme-challenge.try-client-tld.n.egbe.app" } ],
159
+ # "tls": { "ready": false, "reason": "Pending", ... } }
160
+ ```
161
+
162
+ Hand the domain owner **both** `dns` records, exactly as returned. If they use
163
+ Cloudflare or a similar proxy, the records must be **DNS only** (grey cloud) —
164
+ a proxied record breaks both the certificate and the routing. Use a subdomain;
165
+ an apex only works where the provider supports CNAME flattening.
166
+
167
+ The second record is how ownership is proven: only whoever controls the zone
168
+ can point it at us, and the certificate for the host is issued through it. Until
169
+ it issues, `tls.ready` is `false`, the host serves nothing and the app keeps
170
+ serving on its canonical host and alias. Poll `GET /domains` — once `tls.ready`
171
+ is `true`, `url` serves the app over HTTPS. `tls.reason` / `tls.message` say
172
+ what it is waiting for (almost always the `_acme-challenge` CNAME).
173
+
174
+ When an app has both an alias and an external host, `url` is the external host.
175
+ Release just the external one and keep the alias with
176
+ `DELETE /domains/landing?host=try.client.tld`; deleting the app releases both.
177
+
178
+ ## When something goes wrong
179
+
180
+ | Response | What it means |
181
+ | --- | --- |
182
+ | `domain_taken` | Another business holds that name or host. Pick a different one. |
183
+ | `domain_limit_reached` | You already use your one domain. Release it, or move it instead. |
184
+ | `reserved_domain_name` | Platform-reserved label. Pick a different one. |
185
+ | `app_not_found` | Deploy the app first — a domain points at a live app. |
186
+ | `external_domain_limit_reached` | Bring-your-own domains are not enabled for this business. Contact the Egbe team. |
187
+ | `external_host_not_allowed` | `host` was under `egbe.app` / `egbe.dev`. Use `name` for a pretty alias. |
188
+ | `invalid_external_host` | Not a valid host name. Pass a full subdomain like `try.client.tld`. |
189
+ | deploy `warnings` mention the domain | The app is live on its canonical host; only the alias didn't attach. Nothing is down. |