Static Deploy

"$SKILL_DIR/scripts/deploy.sh" <project-slug> <directory> <agent-id> <chat-id> [thread-id] [message-ref] [account-id] [channel] [chat-type] [sender-ref]

agent-id is required. The script uses it to resolve the corresponding botId from nexu-context.json when recording deployment artifacts.

chat-id is the raw inbound chat identifier from the message context.

• DM example: U0AHLMC6C8G
• Channel example: C0AJKG60H6D

chat-type tells the script whether to send that id to Nexu as user:<chat-id> or channel:<chat-id>. The script does that translation; do not concatenate those prefixes yourself.

thread-id is optional — pass it when deploying from within a thread context. 4. Parse the JSON output and report to user:

• Brief summary of what was deployed
• Live URL from the url field
• Important: Tell the user that Cloudflare Pages propagation takes ~3 minutes. The URL may not work immediately after the first deploy. For redeployments, it's usually faster.

Example reply

Deployed! Your site is live at https://family-budget.nexu.space

Note: First-time deploys take ~3 minutes to propagate on Cloudflare. If you see a "not found" page, wait a few minutes and refresh.

Rules

• Never read, echo, or log SKILL_API_TOKEN, CLOUDFLARE_API_TOKEN, or CLOUDFLARE_ACCOUNT_ID
• Never pass credentials as command arguments
• Always use the bundled deploy.sh — do not call Cloudflare API directly
• Do not set DEPLOY_BACKEND or any other env overrides — the script handles everything
• Always pass the caller <agent-id> as arg #3 to deploy.sh
• Always pass raw inbound <chat-id> as arg #4
• Never pass <agent-id> as <chat-id>; they are different values
• If deploying from a thread, pass <thread-id> as arg #5
• Always pass <channel> and <chat-type> when available so Nexu can resolve the correct session deterministically
• Do not try to look up or persist a canonical session key in this skill; Nexu resolves it server-side
• Do not hand-edit source files just to add cache-busting query params; the deploy script handles cache revalidation via a staged _headers file
• If the script fails, show the message field from the JSON error to the user
• Cloudflare credentials are fetched at runtime via the scoped secrets API using SKILL_API_TOKEN from env — do not attempt to read or inject them manually

Output Format

Success:

{
  "status": "success",
  "url": "https://<slug>.nexu.space",
  "deployment_url": "https://<id>.<slug>.pages.dev",
  "files_total": 10,
  "files_uploaded": 2,
  "files_cached": 8
}

Error:

{
  "status": "error",
  "message": "Description of what went wrong"
}