Skip to content

SKILL.md

Latest commit

 

History

History
56 lines (39 loc) · 2.86 KB

SKILL.md

File metadata and controls

56 lines (39 loc) · 2.86 KB
Raw
name studio-margin-codex-theme
description Apply, verify, refine, or remove the Studio Margin custom theme for the macOS Codex desktop app. Use when the user asks for the warm editorial private-studio Codex skin, wants Codex to look like an art magazine workspace, asks to restore the native interface, or wants to iterate on the Studio Margin palette, generated hero artwork, typography, or layout.

Studio Margin Codex Theme

Apply a reversible editorial skin to the official macOS Codex app through a loopback-only Chromium DevTools Protocol connection. Never patch, replace, or re-sign ChatGPT.app or app.asar.

Apply

  1. Tell the user that applying the theme briefly restarts Codex.

  2. Run:

    scripts/start-studio-margin.sh --restart-existing

  3. Verify and capture a screenshot:

    scripts/verify-studio-margin.sh --screenshot /absolute/path/studio-margin.png

  4. Inspect the screenshot. Treat missing artwork, sidebar, composer, theme marker, or horizontal overflow as failure. Fix the CSS and repeat until the interface is visually coherent.

The apply script installs a per-user LaunchAgent. It does not force Codex to remain open: after the user quits, it waits; when Codex is opened normally again, it relaunches that instance once with a loopback-only debugging port and reapplies the theme.

Refine

  • Read references/design-system.md before changing the visual direction.
  • Edit themes/studio-margin.css only for layout, typography, color tokens, readability, and interaction states.
  • Create every artistic or decorative visual with an image-generation model. Never draw illustrations, textures, collages, decorative motifs, or substitute artwork with CSS, Canvas, SVG generation, Python, or other code.
  • Replace assets/studio-margin-hero.png only with artwork intentionally produced by an image-generation model or explicitly supplied by the user.
  • Increment version in themes/studio-margin.json after every visible change so stale injection is detectable.
  • Keep native navigation, project selection, composer, task content, and review controls interactive.
  • Keep decorative layers pointer-events: none.
  • Use local assets only. Do not add remote CSS, tracking pixels, remote fonts, scripts, or user data.

Remove

Run:

scripts/restore-studio-margin.sh

This stops the Studio Margin watcher and removes the live injected DOM and CSS. It does not delete threads, authentication, projects, or Codex configuration.

Safety

  • Bind CDP only to 127.0.0.1.
  • Stop if the selected port belongs to another process.
  • Stop a saved watcher PID only when its current command line identifies this Skill's injector.
  • Treat Codex DOM selectors as version-sensitive. Re-run screenshot verification after Codex updates.
  • Do not claim success from static CSS or a successful injection call alone.