@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.
- package/LICENSE +4 -0
- package/README.md +124 -2
- package/index.js +5 -0
- package/package.json +55 -4
- package/plugin.js +230 -0
- package/session-log.js +315 -0
- package/skills/.egbe-catalog/manifest.json +1 -0
- package/skills/egbe-os-analytics/SKILL.md +499 -0
- package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
- package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
- package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
- package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
- package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
- package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
- package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
- package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
- package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
- package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
- package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
- package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
- package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
- package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
- package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
- package/skills/egbe-os-db/SKILL.md +174 -0
- package/skills/egbe-os-deploy/SKILL.md +412 -0
- package/skills/egbe-os-design/SKILL.md +182 -0
- package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
- package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
- package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
- package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
- package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
- package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
- package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
- package/skills/egbe-os-destination-readiness/references/report.md +116 -0
- package/skills/egbe-os-domains/SKILL.md +189 -0
- package/skills/egbe-os-errors/SKILL.md +259 -0
- package/skills/egbe-os-git/SKILL.md +275 -0
- package/skills/egbe-os-git/references/issues.md +33 -0
- package/skills/egbe-os-google-ads/SKILL.md +163 -0
- package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
- package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
- package/skills/egbe-os-google-ads/references/conversions.md +153 -0
- package/skills/egbe-os-google-ads/references/delivery.md +128 -0
- package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
- package/skills/egbe-os-google-ads/references/reporting.md +105 -0
- package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
- package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
- package/skills/egbe-os-google-auth/SKILL.md +285 -0
- package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
- package/skills/egbe-os-images/SKILL.md +163 -0
- package/skills/egbe-os-images/references/stock-images.md +21 -0
- package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
- package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
- package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
- package/skills/egbe-os-llm/SKILL.md +160 -0
- package/skills/egbe-os-mail/SKILL.md +180 -0
- package/skills/egbe-os-me/SKILL.md +119 -0
- package/skills/egbe-os-meta-ads/SKILL.md +114 -0
- package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
- package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
- package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
- package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
- package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
- package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
- package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
- package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
- package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
- package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
- package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
- package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
- package/skills/egbe-os-notifications/SKILL.md +78 -0
- package/skills/egbe-os-openai-ads/SKILL.md +149 -0
- package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
- package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
- package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
- package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
- package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
- package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
- package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
- package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
- package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
- package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
- package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
- package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
- package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
- package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
- package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
- package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
- package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
- package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
- package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
- package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
- package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
- package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
- package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
- package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
- package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
- package/skills/egbe-os-payments/SKILL.md +215 -0
- package/skills/egbe-os-payments/agents/openai.yaml +4 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
- package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
- package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
- package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
- package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
- package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
- package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
- package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
- package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
- package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
- package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
- package/skills/egbe-os-playbook/SKILL.md +79 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
- package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
- package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
- package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
- package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
- package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
- package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
- package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
- package/skills/egbe-os-playbook/playbooks/product.md +67 -0
- package/skills/egbe-os-playbook/references/catalog.md +127 -0
- package/skills/egbe-os-playbook/references/changes.md +167 -0
- package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
- package/skills/egbe-os-product-auth/SKILL.md +151 -0
- package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
- package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
- package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
- package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
- package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
- package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
- package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
- package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
- package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
- package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
- package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
- package/skills/egbe-os-product-build/SKILL.md +111 -0
- package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-build/references/capabilities.md +25 -0
- package/skills/egbe-os-product-build/references/engineering.md +72 -0
- package/skills/egbe-os-product-build/references/execution.md +55 -0
- package/skills/egbe-os-product-build/references/foundations.md +93 -0
- package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
- package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
- package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
- package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
- package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
- package/skills/egbe-os-product-market-research/SKILL.md +159 -0
- package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
- package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
- package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
- package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
- package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
- package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
- package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
- package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
- package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
- package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
- package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
- package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
- package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
- package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
- package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
- package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
- package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
- package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
- package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
- package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
- package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
- package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
- package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
- package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
- package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
- package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
- package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
- package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
- package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
- package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
- package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
- package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
- package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
- package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
- package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
- package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
- package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
- package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
- package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
- package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
- package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
- package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
- package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
- package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
- package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
- package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
- package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
- package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
- package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
- package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
- package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
- package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
- package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
- package/skills/egbe-os-product-report/SKILL.md +150 -0
- package/skills/egbe-os-product-report/references/artifacts.md +84 -0
- package/skills/egbe-os-product-report/references/brief.md +34 -0
- package/skills/egbe-os-product-report/references/daily.md +76 -0
- package/skills/egbe-os-product-report/references/sources.md +68 -0
- package/skills/egbe-os-product-routines/SKILL.md +166 -0
- package/skills/egbe-os-product-routines/references/catalog.md +22 -0
- package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
- package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
- package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
- package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
- package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
- package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
- package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
- package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
- package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
- package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
- package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
- package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
- package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
- package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
- package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
- package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
- package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
- package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
- package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
- package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
- package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
- package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
- package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
- package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
- package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
- package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
- package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
- package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
- package/skills/egbe-os-report-ui/SKILL.md +133 -0
- package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
- package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
- package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
- package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
- package/skills/egbe-os-report-ui/references/components.md +209 -0
- package/skills/egbe-os-research/SKILL.md +125 -0
- package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
- package/skills/egbe-os-scrape/SKILL.md +160 -0
- package/skills/egbe-os-search/SKILL.md +182 -0
- package/skills/egbe-os-search/references/google-places.md +81 -0
- package/skills/egbe-os-support/SKILL.md +149 -0
- package/skills/egbe-os-telemetry/SKILL.md +344 -0
- package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
- package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
- package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
- package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
- package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
- package/skills/egbe-os-tools/SKILL.md +180 -0
- package/skills/egbe-os-tools/references/theona.md +26 -0
- package/skills/egbe-os-wallet/SKILL.md +181 -0
- package/skills/egbe-setup/EGBE.md +484 -0
- package/skills/egbe-setup/SKILL.md +116 -0
- package/skills/egbe-setup/references/project.md +80 -0
- package/state.js +37 -0
- 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. |
|