Agent skill · steipete
crabbox-apps
Use when asked to open, run, test, or show an app in Crabbox, including native desktops, web previews, and computer use on a temporary machine.
What it needs
About 4k tokens when loaded.
What this skill does
Apps in Crabbox "Open in Crabbox and show me" means launch the working application and open its view in the requesting user's chat side panel. Finish both operations. Use the enabled crabbox tool to inspect the current attachment before creating one. Reuse that environment for follow-ups. profiles discovers configured profiles; choose one compatible with the application. Native desktop viewing and CUA require a desktop-enabled profile. Never silently substitute another OS for an application that requires a particular platform. create attaches the machine to this conversation without moving the agent or its primary workspace. For an open-and-show request with the screen capability available, pass presentation: "desktop" for a native app or presentation: "portal" for a web app. This opens the right sidebar with machine startup progress before provisioning finishes. Its result identifies the environment. Use exec for commands on that environment; the ordinary shell still has its existing target. Copy or recreate the task's required files explicitly. Do not assume the local project was synchronized. Native apps 1. Install or build the app using remote exec as needed. 2. Launch it with exec and background: true. Retain its processId for status, logs, and stop. Do not detach a shell process to escape lifecycle ownership. 3. When the computer tool is available, select the returned environmentId and observe the application. CUA operates on the same desktop shown by VNC. 4. When the screen tool is available, call desktopshow with that environmentId and dock: "right". Verify the app is ready before claiming success. An allocated machine or a blank desktop alone is insufficient. Web apps 1. When the portal tool is available, open a portal for the environment and application's port using environmentId. Keep its portal ID and public URL. 2. Start the web server with remote exec, background: true, and the application's PORT and PUBLICURL set explicitly. Verify it responds. 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/crabbox-apps