Skip to content
Skills Library
Programming · Building & coding

monaco-developer-studio

/monaco-developer-studio

The Developer Studio workspace UI - resizable five-region layout, Monaco editor integration with lazy workers and model management, multi-tab editing with dirty state, xterm.js terminal bound to a run stream, diff viewer, and keyboard-first navigation. Use when building or modifying anything in the studio route.

Repository
veritas-bot ↗
Licence
Apache-2.0
Last repository change
12.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

The Developer Studio workspace UI - resizable five-region layout, Monaco editor integration with lazy workers and model management, multi-tab editing with dirty state, xterm.js terminal bound to a run stream, diff viewer, and keyboard-first navigation. Use when building or modifying anything in the studio route.

Original author description

The Developer Studio workspace UI - resizable five-region layout, Monaco editor integration with lazy workers and model management, multi-tab editing with dirty state, xterm.js terminal bound to a run stream, diff viewer, and keyboard-first navigation. Use when building or modifying anything in the studio route.

How it works

  1. When to use
  2. Layout contract
  3. Monaco integration rules
  4. Tabs and dirty state
  5. Diff viewer
  6. Terminal (xterm.js)
  7. Accessibility
  8. Checklist
Original SKILL.md headings · 87 lines, 531 words
SKILL.md preview
---
name: monaco-developer-studio
description: The Developer Studio workspace UI - resizable five-region layout, Monaco editor integration with lazy workers and model management, multi-tab editing with dirty state, xterm.js terminal bound to a run stream, diff viewer, and keyboard-first navigation. Use when building or modifying anything in the studio route.
---

# Monaco Developer Studio

## When to use
Any work on `apps/web/src/features/studio/**`: layout, editor, tabs, terminal, diff,
toolbar, panel resizing.

## Layout contract
```
┌──────────────────────────────────────────────────────────────┐
│ TOPBAR  project · env(local|cloud) · model · build run test   │ 48px
├────────────┬─────────────────────────────────┬───────────────┤
│ LEFT       │ CENTER                          │ RIGHT         │
│ explorer   │ tabs                            │ chat          │
│ agents     │ Monaco                          │ plan          │
│ git status │                                 │ approvals     │
│ 260px      ├─────────────────────────────────┤ 380px         │
│            │ BOTTOM terminal / tests / logs  │               │
│            │ 240px                           │               │
└────────────┴─────────────────────────────────┴───────────────┘
```
Implement with CSS grid and pointer-driven splitters that write to a Zustand store
(persisted to localStorage per user). Below 1024px: left and right become drawers, bottom
becomes a tab of the center region. Every splitter is a `role="separator"` with
`aria-valuenow`, arrow-key resize, and double-click to reset.

## Monaco integration rules
- Load Monaco lazily; it is ~1 MB and must not be in the initial bundle.
- One `monaco.editor.IStandaloneCodeEditor` instance, many models. Create a model per open
  file with the right language id; dispose models on tab close.
- Configure workers explicitly with Vite:

```ts
// src/features/studio/monaco/setup.ts
import * as monaco from "monaco-editor";
import editorWorker from "monaco-editor/esm/vs/editor/editor.worker?worker";
import tsWorker from "monaco-editor/esm/vs/language/typescript/ts.worker?worker";
import jsonWorker from "monaco-editor/esm/vs/language/json/json.worker?worker";

self.MonacoEnvironment = {
  getWorker(_id, label) {
    if (label === "typescript" || label === "javascript") return new tsWorker();
    if (label === "json") return new jsonWorker();
    return new editorWorker();
  },
};
monaco.editor.defineTheme("superagent-graphite", {
  base: "vs-dark", inherit: true,
  colors: { "editor.background": "#0b0d10", "editorLineNumber.foreground": "#3d4655" },
  rules: [{ token: "comment", foreground: "5f6a7a", fontStyle: "italic" }],
});
```
- `automaticLayout: false`; drive layout from a `ResizeObserver` on the container so
  resizing panels does not thrash.
- Read-only mode is the default while an agent run is active on that file, with a visible
  "agent is editing" banner. Editing while an agent writes the same file is the bug factory.
- Debounce change events 400ms, then mark the tab dirty and schedule autosave.

## Tabs and dirty state
`OpenTab { path, language, modelUri, dirty, pinned }`. Dirty tabs get a dot, closing a dirty
tab confirms. Restore tabs per project from localStorage. Never keep file contents in the
Zustand store beyond the dirty flag.

## Diff viewer
Use `monaco.editor.createDiffEditor` with `renderSideBySide: false` under 900px width.
Diff is fetched as a patch from the API, not computed client-side against stale content.

## Terminal (xterm.js)
- `@xterm/xterm` + `@xterm/addon-fit` + `@xterm/addon-web-links`. Fit on container resize,
  dispose on unmount.
- One WebSocket per terminal session; write frames in order by `seq`, buffer gaps and
  request replay.
- Read-only replay mode for finished runs, with a scrubber.
- Streaming a run's output must not remount the terminal: keep the session component
  mounted and swap the data source.

## Accessibility
File tree is a `tree` role with arrow-key navigation; terminal has a "copy output" button
and never steals focus on stream; all toolbar actions reachable via `Ctrl/Cmd+K` palette.

## Checklist
- [ ] Monaco code-split out of the main bundle.
- [ ] Models disposed; no memory growth across 50 tab opens.
- [ ] Terminal survives panel resize without remount.
- [ ] Read-only during agent writes, with visible banner.
- [ ] Layout degrades below 1024px.

Versions

The database has no other skills named monaco-developer-studio.

Database snapshot: 13.11.2026 · package version 32f92fdf95cd (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100nuxt-studio
    This skill should be used when the user asks to "set up Nuxt Studio", "configure Studio OAuth", "deploy Studio to Cloudflare", "add visual editor to Nuxt", "configure studio.domain.com subdomain", "Studio authentication", "Nuxt CMS", or mentions visual content editing, Nuxt…
  • 90upgrade-bundled-monaco
    Upgrade the Monaco Editor engine and bundled assets inside the flutter_monaco package while preserving bridge, LSP, worker, cache, warmup, and archive invariants. Use when changing MonacoAssets.monacoVersion or replacing assets/monaco/min. Do not use for upgrading the Dart…
  • 100integrate-flutter-monaco
    Integrate flutter_monaco 3.x or 4.x into a Flutter application, including editor lifecycle, documents, platform setup, focus, overlays, and disposal. Use when adding MonacoEditor or MonacoController, designing an editor screen, or reviewing a new flutter_monaco integration. Do…
  • 95xtermjs-skill
    Build, configure, debug and extend browser and Electron terminal UIs with xterm.js (@xterm/xterm). TRIGGER WHEN: working with xterm.js, @xterm/xterm, FitAddon, WebglAddon, SearchAddon, AttachAddon, node-pty over WebSocket, ANSI/VT sequences, or embedding a web terminal in React/Vue/Electron.
  • 95xtermjs-skill
    Build, configure, debug and extend browser and Electron terminal UIs with xterm.js (@xterm/xterm). TRIGGER WHEN: working with xterm.js, @xterm/xterm, FitAddon, WebglAddon, SearchAddon, AttachAddon, node-pty over WebSocket, ANSI/VT sequences, or embedding a web terminal in React/Vue/Electron.
  • 95terminal-expert
    This skill provides unified expert-level guidance for terminal implementation in VS Code extensions. Covers xterm.js API and addons, VS Code terminal architecture, PTY integration, session persistence, input handling (keyboard/IME/mouse), shell integration with OSC sequences,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.