nddipiazza/robos / .agents/skills/create-robos-app
create-robos-app
VerifiedCreate and scaffold a new RobOS Electron desktop app with full registrations and deployment.
Create a new RobOS Electron App
Create a new RobOS desktop application (Electron app) with all required files and registrations.
Input
$ARGUMENTS — The app name in human-readable form (e.g. "Dev Central", "Git Projects", "Work Journal")
What to create
Derive app-id from the name: lowercase, spaces to hyphens (e.g. "Dev Central" → "dev-central").
1. App directory: packages/<app-id>/
Create these files following RobOS conventions:
package.json:
{
"name": "robos-<app-id>",
"version": "0.1.0",
"description": "<description>",
"main": "main.js",
"dependencies": { "electron": "^28.0.0" }
}
main.js — Electron main process:
- Import electron, path, fs, child_process
- Append QEMU flags:
--no-sandbox,--disable-gpu,--disable-dev-shm-usage - Create BrowserWindow:
backgroundColor: '#0d1117',contextIsolation: true, preload app.setName('robos-<app-id>')- Register IPC handlers via
ipcMain.handle() - Load
renderer/index.html - Wire up debug server for DOM snapshots (see
packages/robos-lib/dom-snapshot.js):
try {
const { registerSnapshotIPC, startDebugServer } = require('/usr/local/share/robos/robos-lib/dom-snapshot');
registerSnapshotIPC(mainWindow);
startDebugServer(mainWindow, <PORT>, '<app-id>');
} catch { /* robos-lib not installed */ }
- Use the port from the registry in
packages/robos-lib/snapshot-cli.js. If the app-id isn't registered, add it.
preload.js — contextBridge IPC (never use nodeIntegration):
const { contextBridge, ipcRenderer } = require('electron');
contextBridge.exposeInMainWorld('robos', {
// app-specific methods
});
renderer/index.html — App shell with dark theme
renderer/app.js — Renderer logic
renderer/style.css — Dark theme using RobOS palette:
--bg-primary: #0d1117,--bg-card: #161b22,--accent: #00bcd4
icon.svg — 48x48 SVG icon, Lucide style:
stroke-width="1.5",stroke-linecap="round",stroke-linejoin="round"- Use a color from the RobOS palette:
#00bcd4(cyan),#3b82f6(blue),#22c55e(green),#7c3aed(purple),#ec4899(pink),#f97316(orange),#eab308(yellow),#ef4444(red),#14b8a6(teal) - Pick a Lucide icon concept that matches the app's purpose
<app-id>.desktop:
[Desktop Entry]
X-RobOS-App=true
Version=1.0
Type=Application
Name=RobOS <App Name>
Comment=<description>
Exec=/usr/bin/electron /usr/local/share/robos/<app-id>/main.js --no-sandbox --disable-gpu --disable-dev-shm-usage
Icon=/usr/local/share/robos/<app-id>/icon.svg
Terminal=false
Categories=<freedesktop-category>;
X-RobOS-Category=<Dev|AI|Security|People|Journal|System|Internet|Tools|Games|Party Games>
StartupWMClass=robos-<app-id>
2. Register in packages/robos-icons/builtin-apps.js and packages/robos-icons/builtin-apps-browser.js
Add an entry to the BUILTIN_APPS array (in alphabetical order by appId):
{
appId: '<app-id>',
label: '<App Name>',
category: '<RobOS category>',
iconSvg: `<the icon.svg content>`
}
3. Update AGENTS.md App Suite table
Add the new app to the appropriate section in the App Suite tables in AGENTS.md.
Then give the app its page on the docs site: run node scripts/sync-app-docs.js, which creates site/_apps/<app-id>.md from the .desktop entry. Set its category: to an id from site/_data/app_categories.yml and write a short guide in the page body.
4. Register in Knowledge Graph & Prompt Documentation Synchronization
- Add package node to Modular KGraph Packages (
.robos/kgraphs/&.robos/kgraph.yaml) and.robos/packages.yaml. - Documentation Synchronization Prompt: When KGraph objects are updated, discern noticeable updates to system documentation (
docs/why-robos.md,README.md,docs/project-plan/) and update them accordingly.
5. Deploy to VM
After creating the app locally, deploy it to the running RobOS VM. Use -o StrictHostKeyChecking=no for all SSH/SCP commands.
IMPORTANT: The RobOS App Launcher discovers apps from .desktop files in /usr/share/applications/ (NOT /usr/local/share/applications/). All .desktop files MUST go there.
Step 1 — Copy app files to VM:
scp -P 2224 -o StrictHostKeyChecking=no -r packages/<app-id>/* robos@localhost:/tmp/<app-id>-deploy/
Step 2 — Install on VM and fix permissions:
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
'sudo rm -rf /usr/local/share/robos/<app-id> && \
sudo cp -r /tmp/<app-id>-deploy /usr/local/share/robos/<app-id> && \
sudo chmod -R a+rX /usr/local/share/robos/<app-id> && \
sudo bash -c "cd /usr/local/share/robos/<app-id> && npm install --quiet"'
Step 3 — Install .desktop file to /usr/share/applications/:
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
'sudo cp /usr/local/share/robos/<app-id>/<app-id>.desktop /usr/share/applications/<app-id>.desktop'
Step 4 — Deploy any shared library dependencies:
scp -P 2224 -o StrictHostKeyChecking=no -r packages/<lib-name>/* robos@localhost:/tmp/<lib-name>-deploy/
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
'sudo rm -rf /usr/local/share/robos/<lib-name> && \
sudo cp -r /tmp/<lib-name>-deploy /usr/local/share/robos/<lib-name> && \
sudo chmod -R a+rX /usr/local/share/robos/<lib-name>'
Step 5 — Test launch:
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
'DISPLAY=:0 /usr/bin/electron /usr/local/share/robos/<app-id>/main.js --no-sandbox --disable-gpu --disable-dev-shm-usage &
sleep 3 && ps aux | grep <app-id> | grep -v grep'
Step 6 — Verify deployment:
ssh -p 2224 -o StrictHostKeyChecking=no robos@localhost \
'ls /usr/local/share/robos/<app-id>/ && \
cat /usr/share/applications/<app-id>.desktop'
Validation
- Verify all files exist in
packages/<app-id>/ - Verify the .desktop file has
X-RobOS-App=true - Verify
X-RobOS-Categoryis one of: Dev, AI, Security, People, Journal, System, Internet, Tools, Games, Party Games - Verify icon.svg is valid SVG with 48x48 dimensions
- Verify the app is registered in
packages/robos-icons/builtin-apps.js - Verify the app is deployed to
/usr/local/share/robos/<app-id>/on the VM with world-readable permissions - Verify the .desktop file is installed at
/usr/share/applications/<app-id>.desktopon the VM - Verify the app launches successfully via
DISPLAY=:0 /usr/bin/electron ...
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 117k | Updated | Claude CodeCodex | Verified | Install |