stella-desktop

Enforce mandatory operating rules for safe Stella desktop application modifications.

29|4|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/ruuxi/stella --skill stella-desktop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stella-desktop
Source: https://github.com/ruuxi/stella/tree/main/runtime/home-seed/skills/stella-desktop
Command: npx skills add https://github.com/ruuxi/stella --skill stella-desktop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Modifying the Stella desktop application without adhering to its specific development rules leads to broken file paths, interrupted active user sessions, and changes that fail to persist or apply correctly, wasting development time and disrupting the end user experience.

Core Features & Use Cases

  • Operating Rules: Clear, mandatory guidelines for using absolute file paths, avoiding dev server launches that interrupt active Stella sessions, and preserving unmodified onboarding flows.
  • UI & Theme Guidance: Pre-mapped paths for all major UI surfaces (chat, composer, top navigation, etc.) and step-by-step instructions for making aesthetic changes that persist across theme switches via the built-in Custom theme.
  • Validation & Common Gotchas: Pre-defined validation commands to run after changes, plus notes on auto-generated files, app registry discovery, and unique runtime constraints to avoid frequent implementation errors.
  • Use Case: If you want to add a new app entry to Stella's top navigation bar or adjust the chat composer's styling, this skill provides the exact file paths and rules to implement the change safely without disrupting the running Stella instance.

Quick Start

Use the stella-desktop skill to tweak the color palette of Stella's chat interface to match your brand.

Frequently Asked Questions about stella-desktop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely modify the Stella desktop app UI without breaking file paths?

To safely modify the Stella desktop app UI, you must use absolute file paths and follow pre-mapped UI surface paths to prevent broken links and ensure changes apply correctly without disrupting the application structure.

Why do my Stella desktop theme changes not persist across theme switches?

Stella desktop theme changes fail to persist when not applied through the built-in Custom theme. You must use the specific pre-mapped paths and follow step-by-step instructions to ensure aesthetic changes survive theme switches.

Can I launch a dev server while modifying the Stella desktop application?

No, launching a dev server during active Stella desktop sessions is prohibited. Doing so interrupts the active user session; you must apply modifications directly to the runtime files without starting the dev server.

How do I add a new app entry to the Stella desktop top navigation bar?

Adding a new app entry to the Stella top navigation requires updating the app registry using the provided pre-mapped file paths. This ensures the application discovers the new entry without disrupting the running instance.

What are common gotchas when adjusting the Stella chat composer styling?

Common gotchas when adjusting the Stella chat composer include editing auto-generated files, ignoring app registry discovery rules, and failing to run pre-defined validation commands after making the visual changes.

Do I need TypeScript or React experience to modify the Stella desktop application?

Modifying the Stella desktop application requires TypeScript and React knowledge because the skill provides structural guidance for these technologies to implement safe, non-disruptive edits to the runtime and UI.