Agent skill

macOS Menubar Tuist App

by Dimillian in Dimillian/Skills

Build, refactor, or review macOS menubar apps that use Tuist and SwiftUI.

MITAuto-check passedMobile

Install macOS Menubar Tuist App

skills CLI
$ npx skills add Dimillian/Skills --skill macos-menubar-tuist-app -a claude-code

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

GitHub CLI
$ gh skill install Dimillian/Skills macos-menubar-tuist-app --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/Dimillian/Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/macos-menubar-tuist-app .claude/skills/macos-menubar-tuist-app && 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-menubar-tuist-app
GitHub stars
4k
Token cost
~1.1k tokens
SKILL.md length
474 words
Files
2
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Build, refactor, or review macOS menubar apps that use Tuist and SwiftUI.

  • Maintaining LSUIElement menubar utilities
  • SKILL.md covers Core Rules, Expected File Shape, Workflow and Validation Matrix, plus 2 more sections
  • Calls bash
  • Defining Tuist targets/manifests

What it does

macOS Menubar Tuist App is an agent skill from Dimillian/Skills. Build, refactor, or review macOS menubar apps that use Tuist and SwiftUI. Use when creating or maintaining LSUIElement menubar utilities, defining Tuist targets/manifests, implementing model-client-store-view architecture, adding script-based launch flows, or validating reliable local build/run behavior without Xcode-first workflows.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Mobile, covering iOS development. It works with macOS, Xcode and SwiftUI. The licence is MIT.

When your agent uses it

  • Maintaining LSUIElement menubar utilities
  • Defining Tuist targets/manifests
  • Implementing model-client-store-view architecture
  • Adding script-based launch flows

Example prompts

  • “/macos-menubar-tuist-app”

What it can do on your machine

Read from SKILL.md and the folder at commit 05ba982. 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

    Shell commands in SKILL.md call:

    • bash

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

  • Network

    No URLs in SKILL.md.

    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 Menubar Tuist App loads about 1.1k tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 474 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Dimillian/Skills at commit 05ba982, republished under its MIT licence (© Dimillian). 474 words, ~1,066 tokens.

Download SKILL.mdSave it as .claude/skills/macos-menubar-tuist-app/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
macos-menubar-tuist-app
description
Build, refactor, or review macOS menubar apps that use Tuist and SwiftUI. Use when creating or maintaining LSUIElement menubar utilities, defining Tuist targets/manifests, implementing model-client-store-view architecture, adding script-based launch flows, or validating reliable local build/run behavior without Xcode-first workflows.

macos-menubar-tuist-app

Build and maintain macOS menubar apps with a Tuist-first workflow and stable launch scripts. Preserve strict architecture boundaries so networking, state, and UI remain testable and predictable.

Core Rules

  • Keep the app menubar-only unless explicitly told otherwise. Use LSUIElement = true by default.
  • Keep transport and decoding logic outside views. Do not call networking from SwiftUI view bodies.
  • Keep state transitions in a store layer (@Observable or equivalent), not in row/view presentation code.
  • Keep model decoding resilient to API drift: optional fields, safe fallbacks, and defensive parsing.
  • Treat Tuist manifests as the source of truth. Do not rely on hand-edited generated Xcode artifacts.
  • Prefer script-based launch for local iteration when tuist run is unreliable for macOS target/device resolution.
  • Prefer tuist xcodebuild build over raw xcodebuild in local run scripts when building generated projects.

Expected File Shape

Use this placement by default:

  • Project.swift: app target, settings, resources, Info.plist keys
  • Sources/*Model*.swift: API/domain models and decoding
  • Sources/*Client*.swift: requests, response mapping, transport concerns
  • Sources/*Store*.swift: observable state, refresh policy, filtering, caching
  • Sources/*Menu*View*.swift: menu composition and top-level UI state
  • Sources/*Row*View*.swift: row rendering and lightweight interactions
  • run-menubar.sh: canonical local restart/build/launch path
  • stop-menubar.sh: explicit stop helper when needed

Workflow

  1. Confirm Tuist ownership
  • Verify Tuist.swift and Project.swift (or workspace manifests) exist.
  • Read existing run scripts before changing launch behavior.
  1. Probe backend behavior before coding assumptions
  • Use curl to verify endpoint shape, auth requirements, and pagination behavior.
  • If endpoint ignores limit/page, implement full-list handling with local trimming in the store.
  1. Implement layers from bottom to top
  • Define/adjust models first.
  • Add or update client request/decoding logic.
  • Update store refresh, filtering, and cache policy.
  • Wire views last.
  1. Keep app wiring minimal
  • Keep app entry focused on scene/menu wiring and dependency injection.
  • Avoid embedding business logic in App or menu scene declarations.
  1. Standardize launch ergonomics
  • Ensure run script restarts an existing instance before relaunching.
  • Ensure run script does not open Xcode as a side effect.
  • Use tuist generate --no-open when generation is required.
  • When the run script builds the generated project, prefer TUIST_SKIP_UPDATE_CHECK=1 tuist xcodebuild build ... instead of invoking raw xcodebuild directly.
Show full SKILL.md (130 more words)Show less

Validation Matrix

Run validations after edits:

bash
TUIST_SKIP_UPDATE_CHECK=1 tuist xcodebuild build -scheme <TargetName> -configuration Debug

If launch workflow changed:

bash
./run-menubar.sh

If shell scripts changed:

bash
bash -n run-menubar.sh
bash -n stop-menubar.sh
./run-menubar.sh

Failure Patterns and Fix Direction

  • tuist run cannot resolve the macOS destination: Use run/stop scripts as canonical local run path.

  • Menu UI is laggy or inconsistent after refresh: Move derived state and filtering into the store; keep views render-only.

  • API payload changes break decode: Relax model decoding with optional fields and defaults, then surface missing data safely in UI.

  • Feature asks for quick UI patch: Trace root cause in model/client/store before changing row/menu presentation.

Completion Checklist

  • Preserve menubar-only behavior unless explicitly changed.
  • Keep network and state logic out of SwiftUI view bodies.
  • Keep Tuist manifests and run scripts aligned with actual build/run flow.
  • Run the validation matrix for touched areas.
  • Report concrete commands run and outcomes.

© Dimillian, MIT. 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 1 other file in macos-menubar-tuist-app of Dimillian/Skills.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 05ba982

Compare with similar skills

macOS Menubar Tuist App 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 Menubar Tuist App compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
macOS Menubar Tuist App this skillDimillian/Skills4k—~1.1kAutomated safety check: PassMIT
SetupShpigford/chops1.9k—~980Automated safety check: PassCustom licence
SwiftUI Design SkillWholiver/swiftui-design-skill204—~2.8kAutomated safety check: PassMIT
FlowdeckSwiftedMind/Tessera116—~11kAutomated safety check: PassMIT
Bootstrap iOSRayFernando1337/rayfernando-skills130—~1.1kAutomated safety check: PassApache-2.0
Xcstrings ManagerEslzzyl/Pixiv-SwiftUI111—~482Automated safety check: PassAGPL-3.0

Similar skills

  • Setup

    Shpigford/chops

    Get a new developer up and running with the Chops codebase — prerequisites, build, architecture, and common tasks.

    1.9k GitHub stars~980 tokensUpdated 1 mo ago
    MobileAuto-check passed
  • SwiftUI Design Skill

    Wholiver/swiftui-design-skill

    Guides the agent to design distinctive SwiftUI interfaces for iOS and macOS, with six anti-generic rules, a design direction workflow and a five-dimension review.

    204 GitHub stars~2.8k tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Flowdeck

    SwiftedMind/Tessera

    FlowDeck is REQUIRED for all Apple platform build/run/test/launch/debug/simulator/device/log/automation tasks.

    116 GitHub stars~11k tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Bootstrap iOS

    RayFernando1337/rayfernando-skills

    Bootstrap agents for iOS, iPadOS, macOS, Swift, SwiftUI, SwiftData/Core Data, Swift Testing, Xcode build/test/debug, Simulator, App Intents, or XcodeBuildMCP work.

    130 GitHub stars~1.1k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Xcstrings Manager

    Eslzzyl/Pixiv-SwiftUI

    Manage Xcode String Catalog (.xcstrings) localization files through a command-line interface.

    111 GitHub stars~482 tokensUpdated 3 days ago
    MobileAuto-check passed
  • macOS Menubar Tuist App

    sickn33/agentic-awesome-skills

    Build, refactor, or review SwiftUI macOS menubar apps that use Tuist.

    47k GitHub starsUsed in 2 repos~1.1k tokens
    MobileAuto-check passed

More from Dimillian/Skills

All 12 skills in this repo
  • macOS Spm App Packaging

    Dimillian/Skills

    Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

    4k GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • Analyze and optimize React component performance issues (slow renders, re-render thrash, laggy lists, expensive computations).

    4k GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • Swiftui View Refactor

    Dimillian/Skills

    Refactor and review SwiftUI view files with strong defaults for small dedicated subviews, MV-over-MVVM data flow, stable view trees, explicit dependency injection, and correct Observation usage.

    4k GitHub starsUsed in 5 repos~2k tokens
    Auto-check passed
  • Swiftui UI Patterns

    Dimillian/Skills

    Best practices and example-driven guidance for building SwiftUI views and components, including navigation hierarchies, custom view modifiers, and responsive layouts with stacks and grids.

    4k GitHub starsUsed in 5 repos~1.9k tokens
    Auto-check passed
  • Swift Concurrency Expert

    Dimillian/Skills

    Swift Concurrency review and remediation for Swift 6.2+. An agent skill from Dimillian/Skills.

    4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • GitHub

    Dimillian/Skills

    Interact with GitHub using the gh CLI. An agent skill from Dimillian/Skills.

    4k GitHub stars~480 tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about macOS Menubar Tuist App

What does macOS Menubar Tuist App do?

Build, refactor, or review macOS menubar apps that use Tuist and SwiftUI. macOS Menubar Tuist App is an agent skill from Dimillian/Skills. Build, refactor, or review macOS menubar apps that use Tuist and SwiftUI.

When should I use macOS Menubar Tuist App?

macOS Menubar Tuist App fits situations like: maintaining LSUIElement menubar utilities; defining Tuist targets/manifests; implementing model-client-store-view architecture; adding script-based launch flows.

How do I install macOS Menubar Tuist App in Claude Code?

Run `npx skills add Dimillian/Skills --skill macos-menubar-tuist-app -a claude-code`. Or copy the skill folder (macos-menubar-tuist-app in Dimillian/Skills) into .claude/skills/macos-menubar-tuist-app in your project. Claude Code loads it when a task matches its description.

How do I install macOS Menubar Tuist App in Codex?

Run `npx skills add Dimillian/Skills --skill macos-menubar-tuist-app -a codex`. Or copy the skill folder (macos-menubar-tuist-app in Dimillian/Skills) into .agents/skills/macos-menubar-tuist-app in your project. Codex loads it when a task matches its description.

Can I use macOS Menubar Tuist App 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 Dimillian/Skills --skill macos-menubar-tuist-app -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-menubar-tuist-app, .gemini/skills/macos-menubar-tuist-app, .github/skills/macos-menubar-tuist-app and .opencode/skills/macos-menubar-tuist-app in your project.

What does macOS Menubar Tuist App need to run?

Going by SKILL.md and its folder, macOS Menubar Tuist App needs the command-line tools its instructions call (bash).

Does macOS Menubar Tuist App access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is macOS Menubar Tuist App 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. Review the folder before installing.

What licence does macOS Menubar Tuist App use?

macOS Menubar Tuist App is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does macOS Menubar Tuist App use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Menubar Tuist App?

Skills that share tags, products or a category with macOS Menubar Tuist App: Setup (Shpigford/chops, 1.9k stars), SwiftUI Design Skill (Wholiver/swiftui-design-skill, 204 stars), Flowdeck (SwiftedMind/Tessera, 116 stars) and Bootstrap iOS (RayFernando1337/rayfernando-skills, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains macOS Menubar Tuist App?

Dimillian (a GitHub user) maintains it in Dimillian/Skills, which has 3,989 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on March 29, 2026.

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