メニュー
Use when designing, reviewing, or changing Foreman's native Swift macOS overlay UI. Applies macOS HIG guidance, Foreman-specific command-palette UX, screenshot review, accessibility, and visual iteration rules.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Run Foreman repo-local agent simulation validation scenarios for PR-sized behavior checks, especially synthetic tmux/native-signal/Pi-subagent rollouts that should exercise public Foreman CLI surfaces without requiring real long-running agents.
Use when adding tests, fixtures, screenshot capture, fake foreman harnesses, or validation tasks for Foreman's Swift macOS overlay.
Use when designing or building native macOS applications with SwiftUI or AppKit. Triggers on menu bar structure, keyboard shortcuts, multi-window behavior, Liquid Glass design system, macOS Tahoe/Sequoia, sidebar navigation, toolbar design, app icons, SF Symbols, or making an app feel like a "good Mac citizen."
Apple Human Interface Guidelines for Mac. Use when building macOS apps with SwiftUI or AppKit, implementing menu bars, toolbars, window management, or keyboard shortcuts. Triggers on tasks involving Mac UI, desktop apps, or Mac Catalyst.
Creates, updates, or evaluates AGENTS.md and CLAUDE.md files for a repository. This skill activates when users want to create onboarding docs, update agent context files, or evaluate documentation quality. Generates docs with YAML frontmatter indexes for machine-readable progressive disclosure, system invariants, redirect-pattern gotchas (DO/NOT/BECAUSE), and validated commands. Supports incremental updates via git-based staleness detection.
Comprehensive documentation workflow for creating, generating, and maintaining technical documentation. This skill activates when users want to analyze documentation needs, generate module quickstart guides, sync docs with code changes, or consolidate scattered docs. Supports four modes - analyze (plan docs), quickstart (generate onboarding docs), update (sync with code changes), and consolidate (inventory and tidy existing docs).
| name | foreman-swift-overlay-ux |
| description | Use when designing, reviewing, or changing Foreman's native Swift macOS overlay UI. Applies macOS HIG guidance, Foreman-specific command-palette UX, screenshot review, accessibility, and visual iteration rules. |
Use this skill when working in apps/macos-overlay/, reviewing screenshots in
.ai/validation/macos-overlay/, changing keyboard behavior, or polishing the
native macOS overlay.
Read these files before making UX changes:
docs/macos-overlay/ux-checklist.md.agent/skills/macos-design-guidelines/SKILL.md.agent/skills/macos-app-design/SKILL.md.agent/skills/macos-app-design/references/macos-design-guide.mdThe overlay is a menu-bar utility / command-palette HUD for Foreman agents. It should feel closer to Spotlight/Raycast directness than a generic document window.
Target flow:
global hotkey → search focused → select agent → focus/send → close
Run:
./scripts/capture-macos-overlay.sh
open .ai/validation/macos-overlay/attention.png
Then check:
Record conclusions in the active plan's VALIDATION.md or LEARNING_LOG.md.