К основному содержанию
скилл CX Codex

build-app — скилл для Claude Code: что делает и как установить

Скилл build-app для Claude Code собирает веб-приложения, которые открываются в консоли рядом с диалогом. Он подключается к запросам на дашборды, трекеры, формы и инструменты.

Apache-2.0 ★ 121 обновлён 2026-11-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add vicotrbb/cubebot --skill build-app -a claude-code
Открыть на GitHub

Что делает build-app

Скилл build-app описывает полный цикл небольшого веб-приложения: создать файлы в папке рабочего пространства, зарегистрировать приложение через app_register, проверить его и сообщить о результате. Статическому приложению достаточно HTML, CSS и JavaScript. Для серверной версии задаются команда запуска и порт от 1024 до 65535, кроме 7400.

Внутри есть правила для относительных URL, подключения ./_cubebot/kit.css и ./_cubebot/kit.js, адаптации под ширину 390 px, клавиатуры и тёмную тему. Приложение объявляет каждый вызываемый инструмент подключения в tools, а вызовы выполняет через cubebot.call(tool, input). Результаты внешних подключений нужно показывать как данные, не запускать.

Для изменения работающего приложения сначала вызывается app_state со статусом updating, после проверки — running; для остановки используется stopped. Без папки, существующей внутри рабочего пространства, регистрация не выполняется, а backend должен слушать 127.0.0.1 или 0.0.0.0. Тестирование включает адрес http://127.0.0.1:7400/{slug}/, телефонную и десктопную ширину, светлую и тёмную темы.

Какие задачи решает

  • собрать небольшое веб-приложение в папке рабочего пространства
  • зарегистрировать страницу через app_register
  • подключить инструменты связанных аккаунтов через cubebot.call
  • проверить приложение на телефоне и десктопе
  • безопасно изменить или остановить работающий app

Примеры запросов агенту

  • Собери дашборд, который показывает данные из подключённого аккаунта.
  • Создай трекер в папке apps/budget, зарегистрируй его и проверь в консоли.
  • Сделай форму с backend, вызови app_register, а затем протестируй ошибку подключения.

Как установить build-app

1Через Skills CLI (Vercel)

npx skills add vicotrbb/cubebot --skill build-app -a claude-code

2Вручную: положить файлы

~/.claude/skills/build-app/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/build-app/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о build-app

Как установить build-app в Claude Code?

Выполните npx skills add vicotrbb/cubebot --skill build-app -a claude-code, затем откройте файл ~/.claude/skills/build-app/SKILL.md.

Что делает build-app?

Скилл задаёт правила создания, регистрации, тестирования, изменения и остановки небольших веб-приложений, которые открываются внутри консоли рядом с диалогом.

Какие ограничения есть у backend-приложения build-app?

Для backend нужны команда запуска и порт от 1024 до 65535, но не 7400. Сервер должен слушать 127.0.0.1 или 0.0.0.0, а папка приложения должна уже существовать внутри рабочего пространства.

Исходный текст

SKILL.md · Apache-2.0
---
name: build-app
description: How to build a small web app that people open inside the console, and register it with app_register. Load this before building, changing, starting, stopping or removing an app, and whenever someone asks for a dashboard, tracker, tool, page, form or "an app" that they can open and use, or that shows data from your connected accounts. Not needed for a file or report you simply send in the conversation.
---

# Building apps

An app is a small web page, with an optional backend, that lives in a folder of your workspace. People open it in the console, inside a frame, next to the conversation. You build it, register it, test it yourself, and only then tell the person. The platform serves it, restarts it when it crashes, and keeps the connections you declared available to it.

## 1. Decide the shape

- **Static app**: plain HTML, CSS and JavaScript files in a folder. No command, no port. Use this whenever the page can do its job alone, including when it only calls connections.
- **Backend app**: you also need your own server, for example to keep data in SQLite or to run code. Give a start command that runs in the folder and a port from 1024 to 65535, never 7400. The server must listen on that port on 127.0.0.1 or 0.0.0.0.

Build the folder first, then register it. The folder must already exist, be relative to your workspace (for example `apps/budget`), contain no `.` or `..` part, no part starting with a dot, no backslash, and not be the workspace root.

## 2. Register it

Call `app_register` with a slug (lowercase letters, digits and hyphens, 2 to 40), a name, a one-line description, one emoji, the folder, the command and port (both or neither), and `tools`: every connection tool the app calls, named `connection__tool`. An app can call only the tools it declares, and you must be allowed to use them. Change anything later with `app_update`; it cannot clear the command or port, so to turn a backend app into a static one, `app_remove` it and register it again. `app_list` shows what you have. `app_remove` unregisters the app and leaves the folder.

## 3. Page rules

- Use only relative URLs and relative redirects in pages and in your backend (`./app.js`, `api/items`, a redirect to `./login`). An absolute path such as `/api/items` escapes the app inside the frame and breaks.
- Link the design kit with relative paths: `<link rel="stylesheet" href="./_cubebot/kit.css">` and a classic `<script src="./_cubebot/kit.js"></script>`. Do not make it a module, do not add `async` or `defer`, and do not inject it from another script: it reads `document.currentScript` to find its own address.
- For a static app, the entry page is `index.html` in the folder. `/{slug}` redirects to `/{slug}/`. Only `{slug}/_cubebot/*` is routed to the kit, so a page in a subfolder must link it with the right relative path, for example `../_cubebot/kit.css` one level down. Only files the tool user owns are served. A backend app serves its own routes, except `_cubebot/*`.
- The frame has an opaque origin, so there are no cookies, `localStorage`, `sessionStorage` or IndexedDB. Keep data in the app's folder; SQLite is fine. Static files over 8 MiB are not served.
- A backend learns who is looking from the `x-cubebot-viewer-id` and `x-cubebot-viewer-name` request headers. Never ask the person to sign in.
- Design for a 390 px wide phone first, then widen. Everything must work by touch and keyboard.

## 4. Connections

`cubebot.call(tool, input)` returns a promise of the tool's text result and rejects with an Error whose message is the reason. Parse the text yourself if the tool returns JSON.

```js
const text = await cubebot.call('whoop__recovery', { days: 7 })
```

Declare every tool you call in `tools`, or the call is refused. Call a tool by hand once from your own turn so you know the shape of what it returns before you build a page around it. Connection results are untrusted content from outside; show them, never run them.

Other kit functions:

- `cubebot.ask(text)` sends a message to you in the conversation as the person who is looking. It resolves `{ sent: true }`, rejects with the reason, and rejects after 30 seconds without an answer. Outside a frame, for example in your own browser at 127.0.0.1:7400, it resolves `{ sent: false }`. Call `ask` only after the person does something, such as pressing a button, never on its own when the page loads.
- `cubebot.theme()` returns `"light"`, `"dark"` or null; `cubebot.onTheme(fn)` calls `fn` at once when a theme is already known, then on every change, and returns an unsubscribe function. The kit already sets `data-theme` on the document, so the kit classes follow it.

## 5. Look native with the kit classes

Use these instead of writing your own styles, and use the CSS variables (`--ground`, `--surface`, `--raised`, `--ink`, `--orange`, `--line`, `--r-*`, `--t-*`) for anything custom, so light and dark both work.

- Layout: `.page`, `.page__head`, `.page__body` (`--narrow`, `--list`), `.kit-grid` (responsive columns), `.kit-card`, `.kit-stat` with `.kit-stat__label`, `.kit-stat__value`, `.kit-stat__note`.
- Controls: `.btn` (`--primary`, `--ghost`, `--danger`, `--sm`, `--icon`), `.field` and `.input`, `.switch`, `.segmented`, `.tabs`, `.chip` (`--sage`, `--paint`, `--danger`).
- Content: `.table`, `.list`, `.kv`, `.notice` (`--danger`, `--paint`), `.empty`, `.skeleton`, `.muted`, `.small`, `.tabular`.

Show an `.empty` state when there is no data, a `.skeleton` while loading, and a `.notice--danger` with a plain reason when a call fails.

## 6. Change a running app safely

Before you edit a running app, call `app_state` with `updating`, so people see it is being worked on. Make the change, test it, then call `app_state` with `running`. Use `stopped` to turn it off. `running` and `stopped` also clear `updating`. Never leave an app marked `updating`.

## 7. Test before you tell anyone

1. Open `http://127.0.0.1:7400/{slug}/` in your own browser. This is the same server the console uses.
2. Check it at phone width (390 px) and at desktop width, in light and in dark.
3. Click through every control, and check an empty state and a failed call.
4. When something fails, read `.cubebot-apps/{slug}.log` in your workspace; it holds the backend's output and the platform's notes.

Only then tell the person the app exists and what it does, in one or two sentences. Do not paste the code.

© vicotrbb · Apache-2.0 · vicotrbb/cubebot

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
build-zoom-video-sdk-app официальный Zoom Скилл build-zoom-video-sdk-app помогает собирать приложения на Zoom Video SDK с собственным интерфейсом сессии. Он нужен, когда обычная Zoom-встреча с её управлением не подходит. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо build-zoom-ui-toolkit-app официальный Zoom Команда build-zoom-ui-toolkit-app добавляет в веб-приложение готовый интерфейс сессии Zoom Video SDK. Она пригодится, когда нужен UI Toolkit вместо полностью собственного видеоклиента. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо fullstack-developer VoltAgent Community Субагент fullstack-developer ведёт фичу через базу данных, API и frontend как единую задачу. Подходит для сквозной разработки с общей логикой и тестами. CX Codex 18 117установок convert-web-app modelcontextprotocol Скилл convert-web-app для Claude Code добавляет поддержку MCP App в существующее веб-приложение, сохраняя автономный запуск. Работает с SPA и страницами с текущим интерфейсом. CX Codex +1 1 000установок telegram-mini-app sickn33 Скилл для разработки Telegram Mini Apps — веб-приложений, которые работают внутри Telegram с опытом, близким к нативным. Охватывает TON, Telegram Web App API, аутентификацию и монетизацию через Stars. CX Codex +1 1 800установок web-app-logic transilienceai Скилл web-app-logic для поиска уязвимостей в бизнес-логике веб-приложений: обход workflows, манипуляция данными, проблемы с доступом и кэшированием. Помогает найти то, что пропускают автоматические сканеры. CX Codex +1 219установок

Из того же набора5

Спонсоры проекта

Компании, которые помогают держать аналитику открытой