Macos telemetry probe

Skill Xopoko/build-swift-apps/skills/macos-telemetry-probe

Swift-focused AI agent skills for iOS and macOS: build, debug, simulator, SwiftUI, Xcode, App Store workflows. Part of Plug'n Skills.

Install

npx -y skills add Xopoko/build-swift-apps --skill macos-telemetry-probe

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Add and verify lightweight macOS runtime telemetry with `Logger`/`os.Logger`, `log stream`, Console filters, signposts, and build-run checks.

SKILL.md

2.0 KB, as published. Nobody here has run it

macOS Telemetry Probe

Add high-signal app instrumentation without leaving noisy permanent logs. Prefer Apple's unified logging and verify events after build/run.

Rules

Use Logger from OSLog.
Give each feature a clear subsystem/category.
Log meaningful lifecycle/user events: windows, sidebar/inspector selection, commands, menu bar actions, sync/load milestones, fallback/error paths.
Keep info logs stable; use debug for noisy state.
Never log secrets, tokens, personal data, or raw document contents.
Add signposts only for timing/performance spans.

import OSLog

private let logger = Logger(
  subsystem: Bundle.main.bundleIdentifier ?? "SampleApp",
  category: "Sidebar"
)

@MainActor
func selectItem(_ item: SidebarItem) {
  logger.info("Selected sidebar item: \(item.id, privacy: .public)")
  selection = item.id
}

Use feature categories like Windowing, Commands, MenuBar, Sidebar, Sync, or Import.

Workflow

Identify the behavior needing observability.
Add one useful log per action boundary or key state transition.
Build/run with macos-runtime-debugger; if present, prefer ./script/build_and_run.sh --telemetry or --logs.
Exercise the UI/command path.

Verify through Console or:

log stream --style compact --predicate 'process == "AppName"'
log stream --style compact --predicate 'subsystem == "com.example.app" && category == "Sidebar"'

Keep useful logs; remove or demote temporary noise.

Verification