Agent skill

Star Office Helper

by FerroxLabs in FerroxLabs/wayland

Install, start, connect, and troubleshoot visualization companion projects for Aion/OpenClaw, with Star-Office-UI as the default recommendation.

AGPL-3.0Auto-check: notes

Install Star Office Helper

skills CLI
$ npx skills add FerroxLabs/wayland --skill star-office-helper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install FerroxLabs/wayland star-office-helper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/FerroxLabs/wayland.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/process/resources/skills/star-office-helper .claude/skills/star-office-helper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
star-office-helper
GitHub stars
608
Token cost
~2.2k tokens
SKILL.md length
1,035 words
Files
6 (incl. scripts, references)
Skills in repo
22
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Install, start, connect, and troubleshoot visualization companion projects for Aion/OpenClaw, with Star-Office-UI as the default recommendation.

  • Works in 4 steps: Confirm the detected URL (e.g.… → Guide the user to click the TV icon in… → Explain available interactions:… → …
  • Users ask for Star Office setup
  • SKILL.md covers What is Star Office, Connection Guidance, Workflow and Install Mode Rules, plus 3 more sections
  • Runs Shell scripts from its folder; calls bash, npm and python3

What it does

Star Office Helper is an agent skill from FerroxLabs/wayland. Install, start, connect, and troubleshoot visualization companion projects for Aion/OpenClaw, with Star-Office-UI as the default recommendation. Use when users ask for Star Office setup, URL/port connection, Unauthorized page diagnosis, Python venv/pip issues (PEP 668), preview panel wiring, real-time monitor wake-up checks, or similar open-source visualizer alternatives.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/discovery.md`, `references/troubleshooting.md` and `scripts/star_office_doctor.sh`).

It works with Python. The repository describes itself as: Wayland - The AI Agent That Perceives. Reasons. Acts. Evolves. The licence is AGPL-3.0.

When your agent uses it

  • Users ask for Star Office setup
  • URL/port connection
  • Unauthorized page diagnosis
  • Python venv/pip issues (PEP 668)

Example prompts

  • “/star-office-helper”

Requirements

  • Python 3
  • Node.js
  • A Bash shell

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Confirm the detected URL (e.g. http://127.0.0.1:19000).
  2. Guide the user to click the TV icon in the chat header to open the live monitor.
  3. Explain available interactions: real-time status view, office scene animation.
  4. If connection fails despite detection, enter troubleshooting (check port, process, auth, logs).

What it can do on your machine

Read from SKILL.md and the folder at commit 4c030c7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • npm
    • python3
    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Star Office Helper loads about 2.2k tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 98 tokens; SKILL.md has 1,035 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~98
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:89
    when an OS-level permission dialog (e.g. sudo password) strictly requires user action - in that case, explain exactly wh

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from FerroxLabs/wayland at commit 4c030c7, republished under its AGPL-3.0 licence (© FerroxLabs). 1,035 words, ~2,219 tokens.

Download SKILL.mdSave it as .claude/skills/star-office-helper/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
star-office-helper
description
Install, start, connect, and troubleshoot visualization companion projects for Aion/OpenClaw, with Star-Office-UI as the default recommendation. Use when users ask for Star Office setup, URL/port connection, Unauthorized page diagnosis, Python venv/pip issues (PEP 668), preview panel wiring, real-time monitor wake-up checks, or similar open-source visualizer alternatives.

Star Office Helper

Guide users from zero to usable visualization integration in Aion. Prefer Star-Office-UI first, then provide alternatives only when requested or when Star Office does not fit.

What is Star Office

Star Office UI is a third-party open-source local visualization companion for OpenClaw / Aion.

  • Project: https://github.com/ringhyacinth/Star-Office-UI
  • It turns chat-side agent status (idle / writing / researching / executing / syncing / error) into a live, interactive office-themed monitor view.
  • It is not built-in to Aion - it runs as a separate local service (default http://127.0.0.1:19000).
  • OpenClaw works independently without Star Office; Star Office only animates when its own backend+frontend and event bridge are active.

Capabilities when connected:

  • Real-time visualization of conversation state changes
  • Interactive office scene that reflects agent activity
  • Live monitor accessible via the TV icon in the chat header

When a user asks "what is Star Office" or triggers the install flow, introduce it clearly with the above context before proceeding.

Connection Guidance

When Star Office is already detected on the local machine:

  1. Confirm the detected URL (e.g. http://127.0.0.1:19000).
  2. Guide the user to click the TV icon in the chat header to open the live monitor.
  3. Explain available interactions: real-time status view, office scene animation.
  4. If connection fails despite detection, enter troubleshooting (check port, process, auth, logs).

When Star Office is not detected:

  1. Follow the Install Workflow below.
  2. After install completes, guide the user to verify via the TV icon.

Workflow

  1. Confirm objective:
  • Install and run a visualization companion locally (default: Star-Office-UI).
  • Connect Aion preview/monitor URL to a running visualizer service.
  • Diagnose why UI does not animate or shows Unauthorized.
  1. Run environment diagnosis first:
  • Execute skills/star-office-helper/scripts/star_office_doctor.sh.
  • If python3 -m pip install fails with externally-managed-environment, switch to venv flow.
  1. Install/repair setup:
  • Execute skills/star-office-helper/scripts/star_office_setup.sh.
  • This creates .venv, installs backend dependencies, and ensures state.json exists.
  1. Start services and verify:
  • Start backend and frontend from Star-Office-UI repo.
  • Confirm preview URL (default recommend http://127.0.0.1:19000).
  • Re-run doctor to verify port and HTTP response.
  1. Connect in Aion:
  • Open OpenClaw mode preview panel (TV icon).
  • Input URL and save.
  • If still blank/Unauthorized, inspect backend auth and state config with doctor output.
  1. Recommend alternatives when needed:
  • If user asks for "similar/open-source alternatives", follow references/discovery.md.
  • Keep Star-Office-UI as the baseline option in comparison.
  • Return 3-5 candidate projects with:
    • repo link
    • integration mechanism match (event/state bridge + web preview)
    • setup complexity
    • maintenance signals (recent commits/issues activity)
    • risk notes

Install Mode Rules

When the user triggers one-stop install/repair (e.g. via the TV icon), follow these rules:

  • Star Office UI is a THIRD-PARTY local project. It is NOT built-in to Aion/OpenClaw and NOT a required core service.
  • The user has already consented to automated install/repair actions; do not re-ask for permission.
  • Stay focused on installing, starting, detecting, repairing, uninstalling, and reconnecting Star Office UI.
  • Your job is to DO it, not to TEACH it. Execute every command yourself using your tools. Your response must never contain commands for the user to copy-paste or steps for the user to follow. If the user sees a shell command in your reply, you have failed. The only exception is when an OS-level permission dialog (e.g. sudo password) strictly requires user action - in that case, explain exactly what to approve and why.
  • After each major step, tell the user whether they can click the TV icon to verify live monitor.
  • Stream concise progress updates in real time. At minimum output one short line before and after each major step.
Show full SKILL.md (464 more words)Show less
Verification Rules (Strict)
  • Treat Star Office as running only if at least one strict signal matches:
    1. Local port 19000 is listening, OR
    2. Health endpoint responds from candidate URL, OR
    3. Process command/path clearly points to Star-Office-UI repo/backend.
  • If strict signals are absent, report Star Office as not running/uninstalled; do not claim residual runtime based only on generic Python workers.
  • Do NOT treat generic python/python3 processes as Star Office residuals unless their command/path explicitly references Star-Office-UI or its backend app.
  • Do NOT claim "openclaw-gateway/Aion auto-restarts Star Office app.py" unless you have explicit evidence from process parent chain, Aion config, or logs in this session.
  • Never claim Star Office is "built-in", "bound to Aion", or "cannot be independently uninstalled" without explicit product evidence from this repo.
Install Workflow

You MUST execute every step yourself. Each step should include a short progress message.

  1. Checking environment - Run bash skills/star-office-helper/scripts/star_office_doctor.sh, report findings.
  2. Installing / repairing - Run bash skills/star-office-helper/scripts/star_office_setup.sh, report success or failure.
  3. Starting service - Execute these commands yourself (run them for the user, rather than asking them to):
    • Backend: cd ~/Star-Office-UI/backend && nohup ../.venv/bin/python app.py > /dev/null 2>&1 &
    • Frontend: cd ~/Star-Office-UI/frontend && npm install && nohup npm run dev > /dev/null 2>&1 &
    • Wait a few seconds, then verify both processes are running.
  4. Detecting port - Verify http://127.0.0.1:19000/health responds. Report detected URL.
  5. Troubleshooting (if needed) - Diagnose unauthorized, port conflict, missing process. Auto-fix and retry.
  6. Completed - Confirm service is reachable. You MUST explicitly tell the user that installation is complete and the service is running at http://127.0.0.1:19000. Do NOT end your response without confirming the final URL.
Uninstall Workflow

"Uninstall" means stop all services AND remove all files. You MUST run the uninstall script - do NOT manually delete the directory without stopping services first.

  1. Run uninstall script - Execute bash skills/star-office-helper/scripts/star_office_uninstall.sh. This script handles the full sequence: kill processes, free ports, remove directory, and verify cleanup.
  2. Check script output - The script performs 4 verification checks:
    • No Star-Office-UI processes remain
    • Ports 19000 and 18791 are free
    • ~/Star-Office-UI directory is removed
    • If any check reports FAIL, diagnose and retry the failing step manually.
  3. Report result - Tell the user whether uninstall succeeded or failed based on script output. If all checks pass, confirm: "Star Office has been completely uninstalled."

Ground Rules

  • Do not use pip --break-system-packages unless user explicitly asks for system-wide install.
  • Prefer venv install on macOS/Homebrew Python.
  • Treat OpenClaw task execution and Star Office animation as two systems:
    • OpenClaw can work without Star Office.
    • Star Office only animates when its own backend/frontend and event path are active.

Quick Commands

bash
# Diagnose current machine and ports
bash skills/star-office-helper/scripts/star_office_doctor.sh

# Bootstrap Star-Office-UI in ~/Star-Office-UI
bash skills/star-office-helper/scripts/star_office_setup.sh

# Bootstrap in a custom folder
bash skills/star-office-helper/scripts/star_office_setup.sh /path/to/Star-Office-UI

# Uninstall Star-Office-UI (stop services + remove files + verify)
bash skills/star-office-helper/scripts/star_office_uninstall.sh

# Uninstall from a custom folder
bash skills/star-office-helper/scripts/star_office_uninstall.sh /path/to/Star-Office-UI

References

  • Read references/troubleshooting.md for:
    • Unauthorized root causes
    • wrong port (18791 vs 19000)
    • why "connected but not moving"
    • Aion preview URL mapping checklist
  • Read references/discovery.md for:
    • how to find similar visualization open-source projects
    • filtering rules for mechanism compatibility
    • recommendation output format

© FerroxLabs, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in src/process/resources/skills/star-office-helper of FerroxLabs/wayland.

  • SKILL.md
  • references/discovery.md
  • references/troubleshooting.md
  • scripts/star_office_doctor.sh
  • scripts/star_office_setup.sh
  • scripts/star_office_uninstall.sh

Open the folder on GitHubat commit 4c030c7

Compare with similar skills

Star Office Helper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Star Office Helper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Star Office Helper this skillFerroxLabs/wayland608—~2.2kAutomated safety check: NotesAGPL-3.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
PDF Processinganthropics/skills180k47 repos~2kAutomated safety check: PassProprietary
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k14 repos~2.4kAutomated safety check: NotesMIT
Manim Video Productionbrowser-use/video-use29k6 repos~3kAutomated safety check: PassMIT
PPT Masterhugohe3/ppt-master59k1 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • PDF Processing

    anthropics/skills

    Official

    Handles everyday PDF jobs in Python and on the command line: extract text and tables, merge, split, rotate, watermark, fill forms, encrypt and OCR.

    180k GitHub starsUsed in 47 repos~2k tokens
    Documents & OfficeAuto-check passed
  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 14 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes
  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    29k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed
  • PPT Master

    hugohe3/ppt-master

    Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

    59k GitHub starsUsed in 1 repo~2.5k tokens
    Documents & OfficeAuto-check passed
  • Scikit Learn

    zLanqing/codex-claude-academic-skills

    Machine learning in Python with scikit-learn. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 16 repos~3.9k tokens
    Data & AnalyticsAuto-check passed

More from FerroxLabs/wayland

All 22 skills in this repo
  • Openclaw Setup

    FerroxLabs/wayland

    OpenClaw usage expert: Helps you install, deploy, configure, and use OpenClaw personal AI assistant.

    608 GitHub stars~1.9k tokensUpdated 4 days ago
    Auto-check passed
  • Tvcontrol Setup

    FerroxLabs/wayland

    Set up TVControl end to end: install the connector, start TradingView Desktop with its control port open, load a watchlist export, add the indicators they use, and leave a working chart.

    608 GitHub stars~5.7k tokensUpdated 4 days ago
    Auto-check passed
  • Ab Testing Specialist

    FerroxLabs/wayland

    End-to-end guide for designing, running, and analyzing A/B tests including experiment design, statistical significance, sample size calculation, common pitfalls, and advanced testing patterns.

    608 GitHub stars~3.7k tokensUpdated 4 days ago
    Auto-check passed
  • Academic Writer

    FerroxLabs/wayland

    Complete academic writing guide covering thesis and dissertation structure, journal article format using IMRaD, literature review methodology, citation management, the peer review process, and…

    608 GitHub stars~4.5k tokensUpdated 4 days ago
    Auto-check passed
  • Accessibility Auditor

    FerroxLabs/wayland

    Web accessibility expertise covering WCAG 2.2 conformance, audit methodology, ARIA patterns, keyboard navigation, screen reader testing, focus management, form accessibility, and automated vs manual…

    608 GitHub stars~4.1k tokensUpdated 4 days ago
    Auto-check passed
  • Organizational accessibility culture building expertise covering champion network design, accessibility training curricula, audit cadence and methodology, KPI definition and tracking, executive…

    608 GitHub stars~3.9k tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about Star Office Helper

What does Star Office Helper do?

Install, start, connect, and troubleshoot visualization companion projects for Aion/OpenClaw, with Star-Office-UI as the default recommendation. Star Office Helper is an agent skill from FerroxLabs/wayland. Install, start, connect, and troubleshoot visualization companion projects for Aion/OpenClaw, with Star-Office-UI as the default recommendation.

When should I use Star Office Helper?

Star Office Helper fits situations like: users ask for Star Office setup; URL/port connection; unauthorized page diagnosis; Python venv/pip issues (PEP 668).

How do I install Star Office Helper in Claude Code?

Run `npx skills add FerroxLabs/wayland --skill star-office-helper -a claude-code`. Or copy the skill folder (src/process/resources/skills/star-office-helper in FerroxLabs/wayland) into .claude/skills/star-office-helper in your project. Claude Code loads it when a task matches its description.

How do I install Star Office Helper in Codex?

Run `npx skills add FerroxLabs/wayland --skill star-office-helper -a codex`. Or copy the skill folder (src/process/resources/skills/star-office-helper in FerroxLabs/wayland) into .agents/skills/star-office-helper in your project. Codex loads it when a task matches its description.

Can I use Star Office Helper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add FerroxLabs/wayland --skill star-office-helper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/star-office-helper, .gemini/skills/star-office-helper, .github/skills/star-office-helper and .opencode/skills/star-office-helper in your project.

What does Star Office Helper need to run?

Going by SKILL.md and its folder, Star Office Helper needs a shell for the scripts in its folder and the command-line tools its instructions call (bash, npm, python3, python and pip). Our summary lists: Python 3; Node.js; A Bash shell.

Does Star Office Helper access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Star Office Helper safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Star Office Helper use?

Star Office Helper is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Star Office Helper use?

About 2.2k tokens (SKILL.md is roughly 8.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 737 tokens, read only when the agent opens those files.

What are the alternatives to Star Office Helper?

Skills that share tags, products or a category with Star Office Helper: MCP Server Builder (anthropics/skills, 180k stars), PDF Processing (anthropics/skills, 180k stars), NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars) and Manim Video Production (browser-use/video-use, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Star Office Helper?

FerroxLabs (a GitHub user) maintains it in FerroxLabs/wayland, which has 608 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 6, 2026.

Source: FerroxLabs/wayland on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.