Skip to content

nddipiazza/robos / .agents/skills/create-robos-app

create-robos-app

Verified

Create 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

  1. Add package node to Modular KGraph Packages (.robos/kgraphs/ & .robos/kgraph.yaml) and .robos/packages.yaml.
  2. 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-Category is 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>.desktop on the VM
  • Verify the app launches successfully via DISPLAY=:0 /usr/bin/electron ...
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 319kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall
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: 117kUpdated Claude CodeCodexVerifiedInstall