[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79SYG9TYFA49RNWAP93MMTT":3,"skill-same:01M79SYG9TYFA49RNWAP93MMTT":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":32,"commitSha":33,"skillDirectory":34,"forksCount":14,"repositoryHtmlUrl":35,"repositoryHomepageUrl":6,"ownerHtmlUrl":36,"ownerBlogUrl":6,"ownerDescription":37,"updatedAt":38,"install":39,"resources":52},"01M79SYG9TYFA49RNWAP93MMTT","desktop-tray-and-menus-architect",null,"Architect-level shell integration — tray\u002Fmenu-bar behaviour, global menus and shortcuts, background vs quit semantics, notifications from the shell, and the platform conventions that decide whether an app feels native. Use when the app lives in the system tray or drives global commands.","SriAkhilSJ\u002FPulseAIRepo","SriAkhilSJ","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F206201543?v=4","01M79RWFD1Q09B89SXTTKKJY6Z","Sri Akhil SJ","01M79RWFE26NPG0BZ1FRNX376H",0,"MIT","https:\u002F\u002Fgithub.com\u002FSriAkhilSJ\u002FPulseAIRepo\u002Fblob\u002Fmain\u002Fskills\u002Fdesktop-architect\u002Fplatform-architect\u002Fdesktop-tray-and-menus-architect\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: desktop-tray-and-menus-architect\ndescription: Architect-level shell integration — tray\u002Fmenu-bar behaviour, global menus and shortcuts, background vs quit semantics, notifications from the shell, and the platform conventions that decide whether an app feels native. Use when the app lives in the system tray or drives global commands.\nlicense: MIT\ncompatibility: Tray APIs, global shortcuts, Windows toast, macOS menu bar, Linux AppIndicator\nmetadata:\n  crusor-domain: desktop-architect\n  crusor-path: desktop-architect\u002Fplatform-architect\u002Fdesktop-tray-and-menus-architect\n  crusor-origin: original\n  crusor-sources: \"electronjs.org\u002Fdocs\u002Flatest\u002Fapi\u002Ftray; developer.apple.com\u002Fdesign\u002Fhuman-interface-guidelines\u002Fthe-menu-bar; docs.gtk.org\u002Fgtk4\"\n  crusor-triggers: \"system tray, menu bar app, global shortcut, notification, window close behaviour, appindicator, tray, menubar, background app\"\n  crusor-verified-on: \"2026-10-30\"\n---\n\n# Tray & Menus Architect\n\nA tray app is **a background process with a UI affordance**. The architecture\nquestion is what \"close\" means — and every platform answers differently.\n\n## When to use\n\n- Always-available utilities: sync, capture, clipboard, monitoring.\n- Background workers with occasional user interaction.\n- Apps that need global shortcuts.\n\n## When NOT to use\n\n- Primary window apps that would confuse users by living in the tray.\n- Platforms where tray support is unreliable (some Linux desktops without\n  AppIndicator).\n\n## Decision 1 — Lifecycle semantics\n\n| Action | Convention |\n|---|---|\n| close window | Windows\u002FLinux: often quit; macOS: window closes, app stays |\n| quit | explicit menu item \u002F Cmd+Q |\n| launch at login | opt-in, visible in settings |\n| background work | must be visible via an indicator |\n\n- Decide and document what closing does; a tray app that quits on close becomes an\n  invisible background process the user cannot find.\n- Provide a single explicit \"Quit\" and make the tray icon's state visible.\n- First run: explain that the app runs in the tray, or users will think it crashed.\n\n## Decision 2 — Tray behaviour\n\n- Menu items: primary action first, settings, then quit; keep it under ~8 items.\n- Tooltip\u002Fstatus text reflects live state (connected, syncing, errors).\n- Left click = primary action or open window; right click = menu (platform-dependent).\n- Badges\u002Fcounters where supported; do not animate the icon continuously.\n\n## Decision 3 — Menus and shortcuts\n\n- Menu structure follows platform convention (macOS app menu, Windows\u002FLinux menu bar).\n- Accelerators use the platform modifier and are discoverable in the menu.\n- Global shortcuts: register, detect conflicts, and let the user change them.\n- Every menu action must also be reachable without the tray, or the app is unusable\n  when the tray fails.\n\n## Decision 4 — Shell notifications\n\n- Native notifications with actions where supported; respect Do Not Disturb.\n- Never spam: rate-limit, deduplicate, and provide a per-event mute.\n- Clicking a notification should open the relevant context, not just the app.\n\n## Decision 5 — Platform variance\n\n- macOS: menu bar extra + dock icon policy (LSUIElement for menu-bar-only apps).\n- Windows: notification area overflow; users may never see the icon — provide an\n  in-app path.\n- Linux: AppIndicator\u002FStatusNotifier support varies; GNOME needs an extension, so\n  always have a window-based fallback.\n\n## Failure modes at scale\n\n- Tray-only app on GNOME where the icon never appears; unusable.\n- Close quits the app; background sync silently stops.\n- Global shortcut conflicts with the OS or another app, unchangeable.\n- Notification flood from a sync error loop.\n- Dock icon and tray icon both present with different menus.\n\n## Verification receipts\n\n1. Lifecycle semantics documented and tested per platform.\n2. Tray menu on each OS, including a no-tray fallback path.\n3. Global shortcut conflict detection and rebinding.\n4. Notification rate limiting and click routing verified.\n5. First-run explanation of background behaviour.\n","# Tray & Menus Architect\n\nA tray app is **a background process with a UI affordance**. The architecture\nquestion is what \"close\" means — and every platform answers differently.\n\n## When to use\n\n- Always-available utilities: sync, capture, clipboard, monitoring.\n- Background workers with occasional user interaction.\n- Apps that need global shortcuts.\n\n## When NOT to use\n\n- Primary window apps that would confuse users by living in the tray.\n- Platforms where tray support is unreliable (some Linux desktops without\n  AppIndicator).\n\n## Decision 1 — Lifecycle semantics\n\n| Action | Convention |\n|---|---|\n| close window | Windows\u002FLinux: often quit; macOS: window closes, app stays |\n| quit | explicit menu item \u002F Cmd+Q |\n| launch at login | opt-in, visible in settings |\n| background work | must be visible via an indicator |\n\n- Decide and document what closing does; a tray app that quits on close becomes an\n  invisible background process the user cannot find.\n- Provide a single explicit \"Quit\" and make the tray icon's state visible.\n- First run: explain that the app runs in the tray, or users will think it crashed.\n\n## Decision 2 — Tray behaviour\n\n- Menu items: primary action first, settings, then quit; keep it under ~8 items.\n- Tooltip\u002Fstatus text reflects live state (connected, syncing, errors).\n- Left click = primary action or open window; right click = menu (platform-dependent).\n- Badges\u002Fcounters where supported; do not animate the icon continuously.\n\n## Decision 3 — Menus and shortcuts\n\n- Menu structure follows platform convention (macOS app menu, Windows\u002FLinux menu bar).\n- Accelerators use the platform modifier and are discoverable in the menu.\n- Global shortcuts: register, detect conflicts, and let the user change them.\n- Every menu action must also be reachable without the tray, or the app is unusable\n  when the tray fails.\n\n## Decision 4 — Shell notifications\n\n- Native notifications with actions where supported; respect Do Not Disturb.\n- Never spam: rate-limit, deduplicate, and provide a per-event mute.\n- Clicking a notification should open the relevant context, not just the app.\n\n## Decision 5 — Platform variance\n\n- macOS: menu bar extra + dock icon policy (LSUIElement for menu-bar-only apps).\n- Windows: notification area overflow; users may never see the icon — provide an\n  in-app path.\n- Linux: AppIndicator\u002FStatusNotifier support varies; GNOME needs an extension, so\n  always have a window-based fallback.\n\n## Failure modes at scale\n\n- Tray-only app on GNOME where the icon never appears; unusable.\n- Close quits the app; background sync silently stops.\n- Global shortcut conflicts with the OS or another app, unchangeable.\n- Notification flood from a sync error loop.\n- Dock icon and tray icon both present with different menus.\n\n## Verification receipts\n\n1. Lifecycle semantics documented and tested per platform.\n2. Tray menu on each OS, including a no-tray fallback path.\n3. Global shortcut conflict detection and rebinding.\n4. Notification rate limiting and click routing verified.\n5. First-run explanation of background behaviour.\n",{"name":5,"license":15,"metadata":24,"description":7,"compatibility":31},{"crusor-path":25,"crusor-domain":26,"crusor-origin":27,"crusor-sources":28,"crusor-triggers":29,"crusor-verified-on":30},"desktop-architect\u002Fplatform-architect\u002Fdesktop-tray-and-menus-architect","desktop-architect","original","electronjs.org\u002Fdocs\u002Flatest\u002Fapi\u002Ftray; developer.apple.com\u002Fdesign\u002Fhuman-interface-guidelines\u002Fthe-menu-bar; docs.gtk.org\u002Fgtk4","system tray, menu bar app, global shortcut, notification, window close behaviour, appindicator, tray, menubar, background app","2026-10-30","Tray APIs, global shortcuts, Windows toast, macOS menu bar, Linux AppIndicator","main","8fa4e240be65b98472c9b2d3a505ade2aea1a5c6","skills\u002Fdesktop-architect\u002Fplatform-architect\u002Fdesktop-tray-and-menus-architect","https:\u002F\u002Fgithub.com\u002FSriAkhilSJ\u002FPulseAIRepo","https:\u002F\u002Fgithub.com\u002FSriAkhilSJ","Studying in CMR institute of Technology\r\n2024 - 2028","2026-11-13 21:02:23",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":51},[41,44,47],{"tool":42,"command":43},"npx","npx skills add SriAkhilSJ\u002FPulseAIRepo --skill desktop-tray-and-menus-architect",{"tool":45,"command":46},"bunx","bunx skills add SriAkhilSJ\u002FPulseAIRepo --skill desktop-tray-and-menus-architect",{"tool":48,"command":49},"pnpm","pnpm dlx skills add SriAkhilSJ\u002FPulseAIRepo --skill desktop-tray-and-menus-architect","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSriAkhilSJ\u002FPulseAIRepo\u002Fblob\u002Fmain\u002Fskills\u002Fdesktop-architect\u002Fplatform-architect\u002Fdesktop-tray-and-menus-architect\u002FSKILL.md",true,[],[54,61,68,75,82,89],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M79TTAJNACCNXCEN3649CMMD","interaction-patterns-architect","Architect-level interaction design in code — choosing established patterns over invented ones, feedback and latency behaviour, destructive-action safeguards, navigation and overlay conventions, and the state model behind every interactive surface. Use when a screen has to behave, not just look.","https:\u002F\u002Fgithub.com\u002FSriAkhilSJ\u002FPulseAIRepo\u002Fblob\u002Fmain\u002Fskills\u002Fwebsite-architect\u002Fui-ux-implementation-architect\u002Finteraction-patterns-architect\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M79TT2ESKB1TKZBYY9KYJHV9","design-system-ops-architect","Architect-level operation of a design system in code — token pipelines and versioning, component API and variant policy, the catalogue as the contract, adoption metrics, and the governance that stops a system from forking into three. Use when a component library must survive several teams.","https:\u002F\u002Fgithub.com\u002FSriAkhilSJ\u002FPulseAIRepo\u002Fblob\u002Fmain\u002Fskills\u002Fwebsite-architect\u002Fui-ux-implementation-architect\u002Fdesign-system-ops-architect\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M79TSV0PWGNK3PRX9P4JDR9N","design-handoff-architect","Architect-level design handoff — what must be specified before implementation starts, tokens over raw values, responsive and content-limit contracts, state matrices, and the review loop that catches drift between design and code. Use when a design is about to become code.","https:\u002F\u002Fgithub.com\u002FSriAkhilSJ\u002FPulseAIRepo\u002Fblob\u002Fmain\u002Fskills\u002Fwebsite-architect\u002Fui-ux-implementation-architect\u002Fdesign-handoff-architect\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M79TSJS9BFXNP696FMJ9GKDA","content-microcopy-architect","Architect-level UI content — where strings live, voice and terminology consistency, error and empty-state copy as part of the interface, translation-ready authoring, and the content model a product needs before it multiplies screens. Use when the words in the interface matter as much as the pixels.","https:\u002F\u002Fgithub.com\u002FSriAkhilSJ\u002FPulseAIRepo\u002Fblob\u002Fmain\u002Fskills\u002Fwebsite-architect\u002Fui-ux-implementation-architect\u002Fcontent-microcopy-architect\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M79TSCNBST3N1M68V1KPH9HQ","ui-ux-implementation-architect","Architect-level direction for turning a design into working UI — the handoff contract, component ownership versus screen-level layout, interaction and state conventions, design QA gates, and the review habits that keep an implementation faithful without frozen pixels. Use before any specific UI implementation skill.","https:\u002F\u002Fgithub.com\u002FSriAkhilSJ\u002FPulseAIRepo\u002Fblob\u002Fmain\u002Fskills\u002Fwebsite-architect\u002Fui-ux-implementation-architect\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M79TS4N6A4D2QQ433VXS5D0R","test-strategy-architect","Architect-level test strategy — allocating assertions across unit, integration, contract and end-to-end layers, designing for testability through dependency boundaries, fixture and data strategy, and the flake and coverage policies that keep a suite trustworthy. Use when defining how a codebase is tested.","https:\u002F\u002Fgithub.com\u002FSriAkhilSJ\u002FPulseAIRepo\u002Fblob\u002Fmain\u002Fskills\u002Fwebsite-architect\u002Ftesting-and-deployment-architect\u002Ftest-strategy-architect\u002FSKILL.md",[],[]]