Menu
Use when adding tests, fixtures, screenshot capture, fake foreman harnesses, or validation tasks for Foreman's Swift macOS overlay.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | foreman-swift-overlay-validation |
| description | Use when adding tests, fixtures, screenshot capture, fake foreman harnesses, or validation tasks for Foreman's Swift macOS overlay. |
Use this skill when changing the Swift overlay validation lane or before calling macOS overlay work done.
Read:
docs/macos-overlay/validation.mddocs/macos-overlay/architecture.mddocs/workflows.mdMirror Foreman's Rust validation ladder:
| Change | Minimum proof |
|---|---|
| Control API schema | Rust tests + Swift fixture decode once available |
| Swift model/filtering | Swift unit tests once test target exists |
| Process invocation | fake ProcessRunner or fake foreman call-log assertion |
| Visual/layout change | ./scripts/capture-macos-overlay.sh and screenshot review |
| Focus/send behavior | fake call log + real tmux smoke if adapter semantics changed |
| Hotkey/window behavior | local manual checklist; don't require CI hotkey synthesis |
Use:
./scripts/capture-macos-overlay.sh
Artifacts land in:
.ai/validation/macos-overlay/
Do not use live tmux state for visual review fixtures. Use checked-in fixture JSON
under apps/macos-overlay/Fixtures/.
The prototype currently has build/manual/screenshot proof, but not Swift XCTest/XCUITest proof. Do not claim Foreman-grade validation until those are added.
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 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 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).