Agent skill

macOS Desktop QA

by sesori-ai in sesori-ai/sesori_apps_monorepo

Build, launch, inspect, and exercise the Sesori macOS desktop app as a real QA target.

Custom licenceAuto-check passedMobile

Install macOS Desktop QA

skills CLI
$ npx skills add sesori-ai/sesori_apps_monorepo --skill macos-desktop-qa -a claude-code

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

GitHub CLI
$ gh skill install sesori-ai/sesori_apps_monorepo macos-desktop-qa --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/sesori-ai/sesori_apps_monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/macos-desktop-qa .claude/skills/macos-desktop-qa && 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
macos-desktop-qa
GitHub stars
126
Token cost
~2.3k tokens
SKILL.md length
931 words
Files
2 (incl. scripts)
Skills in repo
14
Repo updated
First seen
Licence
Custom licence

At a glance

Build, launch, inspect, and exercise the Sesori macOS desktop app as a real QA target.

  • Works in 7 steps: browser login and relaunch restore; → healthy control handshake, relay state,… → phone-to-desktop-helper session round… → …
  • MacOS desktop smoke
  • SKILL.md covers Safety first, Host preflight, Build and automated baseline and Real app loop, plus 2 more sections
  • Runs Shell scripts from its folder; calls dart, brew and flutter

What it does

macOS Desktop QA is an agent skill from sesori-ai/sesori_apps_monorepo. Build, launch, inspect, and exercise the Sesori macOS desktop app as a real QA target. Use for macOS desktop smoke, exploratory, regression, lifecycle, tray/menu-bar, evidence, performance, or end-to-end verification.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/mcp-server.sh`).

It sits in Mobile, covering End-to-end testing. It works with macOS, Model Context Protocol, Flutter and Dart. The repository describes itself as: Sesori iOS/Android app and the Sesori Bridge CLI — drive Claude, Codex, OpenCode, Cursor, Pi, OMP, Hermes coding sessions from your phone.

When your agent uses it

  • MacOS desktop smoke
  • End-to-end verification

Example prompts

  • “/macos-desktop-qa”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

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

  1. browser login and relaunch restore;
  2. healthy control handshake, relay state, and plugin health;
  3. phone-to-desktop-helper session round trip;
  4. helper crash/backoff and exit-86 immediate restart;
  5. login-required behavior;
  6. Bridge Off, window close, tray Open, and Quit orphan checks;
  7. standalone CLI coexistence and explicit takeover behavior.

What it can do on your machine

Read from SKILL.md and the folder at commit 55c7d4c. 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 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • dart
    • brew
    • flutter
    • npm
    • rg
    • make

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

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    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

macOS Desktop QA loads about 2.3k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 931 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~2.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 passed

The automated check found no risky patterns in SKILL.md.

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 931 words (~2,271 tokens).

“Use the real macOS app, native helper, relay path, and representative plugin. Combine semantic app automation with visual/native-system inspection:”

— opening of SKILL.md by sesori-ai, Custom licence
name
macos-desktop-qa
metadata.audience
maintainers
metadata.workflow
local-macos-qa

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in .agents/skills/macos-desktop-qa of sesori-ai/sesori_apps_monorepo.

  • SKILL.md
  • scripts/mcp-server.sh

Open the folder on GitHubat commit 55c7d4c

Compare with similar skills

macOS Desktop QA 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.

macOS Desktop QA compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
macOS Desktop QA this skillsesori-ai/sesori_apps_monorepo126—~2.3kAutomated safety check: PassCustom licence
Native Desktop UI TestingFNOSP/FlyNarwhal509—~2.4kAutomated safety check: PassAGPL-3.0
Flutter MCP E2E HarnessArenukvern/mcp_flutter387—~2.2kAutomated safety check: PassMIT
Engine Whats Newflutter/flutter180k—~978Automated safety check: PassBSD-3-Clause
Updating Android SDKflutter/flutter180k—~1.7kAutomated safety check: PassBSD-3-Clause
Aaalice Dev SessionsAaalice233/Aaalice_NAI_Launcher189—~902Automated safety check: PassMIT

Similar skills

  • Run and verify Flutter desktop behavior on Windows/macOS/Linux native clients.

    509 GitHub stars~2.4k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Flutter MCP E2E Harness

    Arenukvern/mcp_flutter

    A skill your agent uses when writing or running repeatable E2E scenarios for Flutter apps as checked-in Dart with the fluttermcpharness package (packages/harness) — build/launch the app, attach to…

    387 GitHub stars~2.2k tokensUpdated 8 days ago
    MobileAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    180k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • Updating Android SDK

    flutter/flutter

    Upgrades Flutter's Android SDK dependency to a new Android API version (or preview/canary release) in packages.txt, verifies CIPD tag uniqueness, and packages/uploads the binaries using…

    180k GitHub stars~1.7k tokensUpdated today
    MobileAuto-check passed
  • Aaalice Dev Sessions

    Aaalice233/Aaalice_NAI_Launcher

    管理 Aaalice NAI Launcher 项目专用的 Windows 与 Android Flutter 开发会话。用户提到 PC热重载、安卓热重载、启动/关闭/重建独立命令行窗口、模拟器启动异常或检查双端会话时使用。

    189 GitHub stars~902 tokensUpdated today
    MobileAuto-check passed
  • flutter_soloud Setup

    alnitak/flutter_soloud

    Walks through adding the flutter_soloud audio engine to a Flutter app, with per-platform setup, initialization, binary-size and logging options, and output device switching.

    425 GitHub stars~3.6k tokensUpdated yesterday
    MobileAuto-check: notes

More from sesori-ai/sesori_apps_monorepo

All 14 skills in this repo
  • PR Inline Comments

    sesori-ai/sesori_apps_monorepo

    Fetch inline (code) review comments on a GitHub pull request, grouped into threads, with optional filtering by datetime.

    126 GitHub stars~2.3k tokensUpdated 2 days ago
    Auto-check passed
  • Monitor PR

    sesori-ai/sesori_apps_monorepo

    Monitor GitHub PRs with the prmonitor tool and handle incoming "[PR Monitor]" reports.

    126 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Release Notes

    sesori-ai/sesori_apps_monorepo

    Generate a polished, user-facing release-notes markdown file for a requested release (e.g.

    126 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Add Analytics

    sesori-ai/sesori_apps_monorepo

    Design or add Sesori product analytics. An agent skill from sesori-ai/sesori_apps_monorepo.

    126 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Release

    sesori-ai/sesori_apps_monorepo

    Automates the synchronized Sesori App + Bridge release workflow — bumps versions together and creates a PR

    126 GitHub stars~783 tokensUpdated 2 days ago
    Auto-check passed
  • Sesori Plan Worker

    sesori-ai/sesori_apps_monorepo

    Execute plans and multi-step PR series end to end. An agent skill from sesori-ai/sesori_apps_monorepo.

    126 GitHub stars~2.9k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about macOS Desktop QA

What does macOS Desktop QA do?

Build, launch, inspect, and exercise the Sesori macOS desktop app as a real QA target. macOS Desktop QA is an agent skill from sesori-ai/sesori_apps_monorepo. Build, launch, inspect, and exercise the Sesori macOS desktop app as a real QA target.

When should I use macOS Desktop QA?

macOS Desktop QA fits situations like: macOS desktop smoke; end-to-end verification.

How do I install macOS Desktop QA in Claude Code?

Run `npx skills add sesori-ai/sesori_apps_monorepo --skill macos-desktop-qa -a claude-code`. Or copy the skill folder (.agents/skills/macos-desktop-qa in sesori-ai/sesori_apps_monorepo) into .claude/skills/macos-desktop-qa in your project. Claude Code loads it when a task matches its description.

How do I install macOS Desktop QA in Codex?

Run `npx skills add sesori-ai/sesori_apps_monorepo --skill macos-desktop-qa -a codex`. Or copy the skill folder (.agents/skills/macos-desktop-qa in sesori-ai/sesori_apps_monorepo) into .agents/skills/macos-desktop-qa in your project. Codex loads it when a task matches its description.

Can I use macOS Desktop QA 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 sesori-ai/sesori_apps_monorepo --skill macos-desktop-qa -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/macos-desktop-qa, .gemini/skills/macos-desktop-qa, .github/skills/macos-desktop-qa and .opencode/skills/macos-desktop-qa in your project.

What does macOS Desktop QA need to run?

Going by SKILL.md and its folder, macOS Desktop QA needs a shell for the scripts in its folder and the command-line tools its instructions call (dart, brew, flutter, npm, rg and make). Our summary lists: Node.js; A Bash shell.

Does macOS Desktop QA access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is macOS Desktop QA safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. 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 macOS Desktop QA use?

macOS Desktop QA has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does macOS Desktop QA use?

About 2.3k tokens (SKILL.md is roughly 9.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to macOS Desktop QA?

Skills that share tags, products or a category with macOS Desktop QA: Native Desktop UI Testing (FNOSP/FlyNarwhal, 509 stars), Flutter MCP E2E Harness (Arenukvern/mcp_flutter, 387 stars), Engine Whats New (flutter/flutter, 180k stars) and Updating Android SDK (flutter/flutter, 180k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains macOS Desktop QA?

sesori-ai (a GitHub organization) maintains it in sesori-ai/sesori_apps_monorepo, which has 126 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.

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