Guide · Agent skill
How to use the Ship the app live agent skill (convex-ship)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Ship the app live skill (skill name convex-ship) is an agent skill for Convex projects. When you ask, the agent takes your project from a local build to a live, shareable web address on a *.convex.app URL. This guide is for developers who built a Convex app and want to publish it, and it explains what the skill does, how to install it, how to trigger it, and what to watch for before you publish.
Ship the app liveopenclaw/clawhub · MIT Download the skill Quick start
- 1Download and unzip. Download the convex-ship ZIP from this page and unzip it into ~/.claude/skills/ or your project's .claude/skills/ folder.
- 2Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the ZIP.
- 3Check prerequisites. Confirm the Convex CLI is installed, your project has a web app that builds as a static export, and you can access your Convex cloud account.
- 4Sign in if needed. If your deployment is anonymous, sign in so the agent can claim it to the cloud before publishing.
- 5Ask the agent to publish. Make a plain request such as publishing the current Convex app to a live link.
- 6Confirm the publish. Review the steps the agent proposes and approve publishing, since the result is a public URL.
- 7Share the link and decide on a domain. Open the returned *.convex.app URL and choose whether to connect a custom domain.
What is an agent skill, and what does convex-ship do?
An agent skill is a folder containing a SKILL.md file that gives an AI agent instructions for one specific task. This skill's SKILL.md describes how to take the current Convex project from local to live: deploy the Convex backend to the cloud, build the web app, and publish it to *.convex.app.
The workflow has four steps. If you are on an anonymous deployment, the agent first claims or persists it to the cloud through sign-in. It then runs convex deploy for the backend, builds the web app as a static export, and uploads it through the moderated publish gateway, which returns the public *.convex.app URL. Finally, the agent gives you the link and offers to set up a custom domain.
Install the convex-ship skill
The skill ships as a ZIP file from the download link on this page. Unzip it into one of two places. For a personal install that works across projects, unzip it into ~/.claude/skills/. For a single project, unzip it into that project's .claude/skills/ folder.
You can also upload the skill in the Claude apps. Go to Settings, then Capabilities, then Skills, and upload the ZIP there.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project
- Claude apps: Settings → Capabilities → Skills
Check what you need before you start
The skill depends on several things being in place. You need the Convex CLI, since the workflow runs the convex deploy command. Your project must contain a web app that can be built as a static export. You need access to your Convex cloud account. If your deployment is anonymous, you must sign in first to claim it.
Publishing also goes through the moderated publish gateway, so you need access to it. If you want a custom domain, you will need a domain you own or a way to buy one.
- Convex CLI installed (used for convex deploy)
- A Convex project with a web app that can be built as a static export
- Access to your Convex cloud account (sign in to claim an anonymous deployment)
- Access to the moderated publish gateway
- A domain you own, or a domain-purchase option, if you want a custom domain
Trigger the skill with a natural request
You do not need a special command. Ask the agent in plain language to publish or ship the current project, and it should pick up the skill. The agent confirms with you before publishing, because publishing creates a public URL.
Example requests include asking it to put the current Convex app online, deploy it to a live link, or publish the prototype so you can share it. Keep the request tied to the project the agent has open.
- "Publish the current Convex app to a live link."
- "Ship this app so I can share a URL."
- "Deploy the backend and upload the web build."
Safety notes: scripts, network and the public URL
This skill runs scripts and uses the network. The convex deploy step sends your backend to Convex's cloud, and the upload sends your web build to the publish gateway. Review what the agent is about to run before you approve it.
Publishing is a privileged action. It runs through the control plane after the moderation gate, and the agent never holds the deploy key. The skill's rules say to confirm before publishing. Remember that the result is a public URL that anyone can open, so do not publish anything private.
- The agent asks for confirmation before publishing.
- Anyone with the *.convex.app URL can open the app.
- The agent never holds the deploy key; publishing goes through the control plane after moderation.
Tips for a smooth publish
Build and test the app locally before asking the agent to ship it, so you know the static export works. If you are still on an anonymous deployment, sign in first so the backend can be claimed and persisted. After a successful publish, decide whether you want a custom domain; the agent will offer one using the domains skill if you own a domain, or labs-acquire-domain if you want to find or buy one.
- Test the web build locally first.
- Sign in before publishing an anonymous deployment.
- Decide on a custom domain after the first publish.
What people use it for
- Share a quick public demo of a Convex prototype with a link.
- Give stakeholders a live preview of a web app built on Convex.
- Publish a prototype through a repeatable, moderated process instead of manual steps.
- Get help with the deploy steps while you keep control over when publishing happens.
Frequently asked questions
Is the convex-ship skill free?
The skill is published under the MIT licence, as listed for openclaw/clawhub. Using Convex and its cloud account is a separate matter, and the source does not state pricing, so check Convex's own terms before you rely on it.
What do I need to use convex-ship?
You need the Convex CLI for the convex deploy command, a Convex project with a web app that can be built as a static export, and access to your Convex cloud account. Publishing also requires access to the moderated publish gateway. Anonymous deployments must be claimed after you sign in.
Where do I install the convex-ship skill?
Unzip the downloaded ZIP into ~/.claude/skills/ for a personal install, or into a project's .claude/skills/ folder for one project. You can also upload the ZIP in the Claude apps under Settings → Capabilities → Skills.
Will publishing make my app private?
No. Publishing creates a public *.convex.app URL that anyone can open, so do not use this skill for projects that must stay private.
Can I use convex-ship with an app that is not built on Convex?
No. The workflow depends on Convex deployments, so it is for Convex apps only. The source does not describe support for other backends.
Can I use a custom domain with my published app?
Yes, the agent offers one after a successful publish. If you own a domain, it uses the domains skill; if you want to find or buy one, it uses labs-acquire-domain.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use convex-ship if you built a Convex app and want a quick, moderated way to get a public demo link, with the agent handling the deploy steps while you approve each publish. Pick something else if the project must stay private, if your app is not on Convex, or if you need a custom production review and release process beyond this workflow.
Download the skill