Deploy Observability
aliyun/alibabacloud-observability-mcp-server
Deploy, start, and update the Alibaba Cloud Observability MCP Server (阿里云可观测 MCP Server).
Add and verify lightweight macOS runtime telemetry. An agent skill from robinebers/openusage.
Install macOS Telemetry
$ npx skills add robinebers/openusage --skill macos-telemetry -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install robinebers/openusage macos-telemetry --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/robinebers/openusage.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/macos-telemetry .claude/skills/macos-telemetry && rm -rf skills-srcUse ~/.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/
Install the "macos-telemetry" agent skill from https://github.com/robinebers/openusage/tree/main/.agents/skills/macos-telemetry into .claude/skills/macos-telemetry/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-telemetry", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/robinebers/openusage/tree/main/.agents/skills/macos-telemetryType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add robinebers/openusage --skill macos-telemetry -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install robinebers/openusage macos-telemetry --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/robinebers/openusage.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/macos-telemetry .agents/skills/macos-telemetry && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "macos-telemetry" agent skill from https://github.com/robinebers/openusage/tree/main/.agents/skills/macos-telemetry into .agents/skills/macos-telemetry/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-telemetry", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add robinebers/openusage --skill macos-telemetry -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install robinebers/openusage macos-telemetry --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/robinebers/openusage.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/macos-telemetry .cursor/skills/macos-telemetry && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "macos-telemetry" agent skill from https://github.com/robinebers/openusage/tree/main/.agents/skills/macos-telemetry into .cursor/skills/macos-telemetry/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-telemetry", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/robinebers/openusage.git --path .agents/skills/macos-telemetry--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add robinebers/openusage --skill macos-telemetry -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install robinebers/openusage macos-telemetry --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/robinebers/openusage.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/macos-telemetry .gemini/skills/macos-telemetry && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "macos-telemetry" agent skill from https://github.com/robinebers/openusage/tree/main/.agents/skills/macos-telemetry into .gemini/skills/macos-telemetry/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-telemetry", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install robinebers/openusage macos-telemetryInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add robinebers/openusage --skill macos-telemetry -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/robinebers/openusage.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/macos-telemetry .github/skills/macos-telemetry && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "macos-telemetry" agent skill from https://github.com/robinebers/openusage/tree/main/.agents/skills/macos-telemetry into .github/skills/macos-telemetry/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-telemetry", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add robinebers/openusage --skill macos-telemetry -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install robinebers/openusage macos-telemetry --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/robinebers/openusage.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/macos-telemetry .opencode/skills/macos-telemetry && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "macos-telemetry" agent skill from https://github.com/robinebers/openusage/tree/main/.agents/skills/macos-telemetry into .opencode/skills/macos-telemetry/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-telemetry", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
macos-telemetry- GitHub stars
- 4.3k
- Token cost
- ~934 tokens
- SKILL.md length
- 449 words
- Files
- 1
- Skills in repo
- 25
- Repo updated
- First seen
- Licence
- MIT
At a glance
Add and verify lightweight macOS runtime telemetry. An agent skill from robinebers/openusage.
- Works in 5 steps: Identify the behavior that needs… → Add the smallest useful instrumentation. → Build and run the app. → …
- Wiring Logger events
- SKILL.md covers Quick Start, Core Guidelines, Minimal Logger Pattern and Workflow, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
macOS Telemetry is an agent skill from robinebers/openusage. Add and verify lightweight macOS runtime telemetry. Use when wiring Logger events or inspecting logs for windows, sidebars, menus, and actions.
Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud, covering Observability. It works with macOS. The repository describes itself as: Burning through your subscriptions too fast? Paying for stuff you never use? Stop guessing. OpenUsage is free and open source. The licence is MIT.
When your agent uses it
- Wiring Logger events
- Inspecting logs for windows
Example prompts
- “/macos-telemetry”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Identify the behavior that needs observability.
- Add the smallest useful instrumentation.
- Build and run the app.
- Read runtime logs and verify the event fired.
- Tighten or remove instrumentation.
What it can do on your machine
Read from SKILL.md and the folder at commit cb21465. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are swift).
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 Telemetry loads about 934 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 449 words of instructions outside code blocks.
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 robinebers/openusage at commit cb21465, republished under its MIT licence (© robinebers). 449 words, ~934 tokens.
Download SKILL.mdSave it as
.claude/skills/macos-telemetry/SKILL.md (or your agent's skills folder).- name
- macos-telemetry
- description
- Add and verify lightweight macOS runtime telemetry. Use when wiring Logger events or inspecting logs for windows, sidebars, menus, and actions.
Telemetry
Quick Start
Use this skill to add lightweight app instrumentation that helps debug behavior without turning the codebase into a logging landfill. Prefer Apple's unified logging APIs and verify the events after a build/run loop.
Core Guidelines
- Prefer
Loggerfrom theOSLogframework for structured app logs. - Give each feature a clear subsystem/category pair so runtime filtering stays easy.
- Log meaningful user and app lifecycle events: window opening, sidebar selection changes, menu commands, menu bar extra actions, sync/load milestones, and unexpected fallback paths.
- Keep info logs concise and stable. Use debug logs for noisy state details.
- Do not log secrets, auth tokens, personal data, or raw document contents.
- Add signposts only when measuring timing or performance spans; do not overinstrument by default.
Minimal Logger Pattern
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-specific categories like Windowing, Commands, MenuBar, Sidebar,
Sync, or Import so logs can be filtered quickly.
Workflow
Identify the behavior that needs observability.
- Window open/close
- Sidebar or inspector selection changes
- Menu or keyboard command actions
- Menu bar extra actions
- Background load/sync/import events
- Error and recovery paths
Add the smallest useful instrumentation.
- Create one
Loggerper feature area or type. - Log action boundaries and key state transitions.
- Prefer one high-signal line per user action over noisy value dumps.
- Create one
Build and run the app.
- Use
macos-build-run-debugfor the build/run loop. - If
script/build_and_run.shexists, prefer./script/build_and_run.sh --telemetryfor live telemetry checks or./script/build_and_run.sh --logsfor broader process logs. - Exercise the UI or command path that should emit telemetry.
- Use
Read runtime logs and verify the event fired.
- Use Console.app with a process/subsystem filter when that is the fastest manual check.
- Use
log stream --style compact --predicate 'process == "AppName"'for live terminal verification. - Prefer tighter predicates when you know the subsystem/category:
log stream --style compact --predicate 'subsystem == "com.example.app" && category == "Sidebar"'
Tighten or remove instrumentation.
- If the event fires, keep only the logs that remain useful for future debugging.
- If it does not fire, move the log closer to the suspected control path and rerun.
Show full SKILL.md (118 more words)Show less
Verification Checklist
- The app builds after telemetry changes.
- The relevant action emits exactly one clear log line or a small bounded sequence.
- The log can be filtered by process, subsystem, or category.
- No sensitive payloads are written to unified logs.
- Noisy temporary debug logs are removed or demoted before finishing.
Guardrails
- Do not use
printas the primary app telemetry mechanism for macOS app code. - Do not leave a dense trail of permanent debug logs around every state mutation.
- Do not claim an event is wired correctly until you have a concrete verification path through Console,
log stream, or captured process output. - If the debugging task is mostly about crash/backtrace analysis rather than action telemetry, switch to
macos-build-run-debug.
© robinebers, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/macos-telemetry of robinebers/openusage.
Open the folder on GitHubat commit cb21465
Compare with similar skills
macOS Telemetry 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| macOS Telemetry this skillrobinebers/openusage | 4.3k | — | ~934 | Automated safety check: Pass | MIT | |
| Deploy Observabilityaliyun/alibabacloud-observability-mcp-server | 166 | — | ~2.6k | Automated safety check: Notes | None | |
| Sls Dashboard Builderalibaba/loongsuite-pilot | 198 | — | ~1.8k | Automated safety check: Pass | Apache-2.0 | |
| Loongsuite Pilot Insightalibaba/loongsuite-pilot | 198 | — | ~944 | Automated safety check: Pass | Apache-2.0 | |
| Vercel Optimize Auditvercel-labs/agent-skills | 32k | 9 repos | ~4.3k | Automated safety check: Pass | None | |
| Openclaw Live Updateropenclaw/openclaw | 392k | — | ~3.7k | Automated safety check: Pass | MIT |
Similar skills
Sls Dashboard Builder
alibaba/loongsuite-pilot
当任务需要创建、修改、扩展或重组阿里云 SLS 的 dashboard JSON 或可导入的大盘配置时使用；尤其适用于线上大盘、强对比的分析看板、已校验的查询包，或需要专业中文标签与指标定义的运维向大盘。
Loongsuite Pilot Insight
alibaba/loongsuite-pilot
基于 LoongSuite Pilot / AI Coding Agent 日志生成事件洞察、组织洞察、数据质量、研发效能和 AI Native 使用类 SLS 报表时使用；包含 AI Coding 事件表语义，以及团队报表可选的部门维表、deptuser 组织关系、指标口径和公共 CTE，通常与 sls-dashboard-builder 一起使用。
- Official
Vercel Optimize Audit
vercel-labs/agent-skills
Runs a metrics-first audit of a deployed Vercel project, gating investigations on real signals to produce ranked, citation-backed cost and performance recommendations.
Openclaw Live Updater
openclaw/openclaw
Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.
Kubeshark Installer
kubeshark/kubeshark
Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.
More from robinebers/openusage
All 25 skills in this repoSwiftui Patterns
robinebers/openusage
Best practices and example-driven guidance for building native macOS SwiftUI scenes and components, including windows, commands, toolbars, settings, split views, inspectors, menu bar extras, and…
Release Swift
robinebers/openusage
Cut a release of OpenUsage (Swift menu-bar app): pick a version, generate a categorized changelog, tag from main, and publish the GitHub Release with notes.
Telemetry
robinebers/openusage
Add lightweight runtime telemetry and debug instrumentation to macOS apps, then verify those events after building and running.
Window Management
robinebers/openusage
Customize macOS 15+ SwiftUI windows and scene behavior using Window, WindowGroup, and macOS window modifiers.
Appkit Interop
robinebers/openusage
Decide when and how to bridge a macOS app from SwiftUI into AppKit.
Build Run Debug
robinebers/openusage
Build, run, and debug local macOS apps and desktop executables using shell-first Xcode and Swift workflows.
Related
Works with
Categories
Questions about macOS Telemetry
What does macOS Telemetry do?
Add and verify lightweight macOS runtime telemetry. An agent skill from robinebers/openusage. macOS Telemetry is an agent skill from robinebers/openusage. Add and verify lightweight macOS runtime telemetry.
When should I use macOS Telemetry?
macOS Telemetry fits situations like: wiring Logger events; inspecting logs for windows.
How do I install macOS Telemetry in Claude Code?
Run `npx skills add robinebers/openusage --skill macos-telemetry -a claude-code`. Or copy the skill folder (.agents/skills/macos-telemetry in robinebers/openusage) into .claude/skills/macos-telemetry in your project. Claude Code loads it when a task matches its description.
How do I install macOS Telemetry in Codex?
Run `npx skills add robinebers/openusage --skill macos-telemetry -a codex`. Or copy the skill folder (.agents/skills/macos-telemetry in robinebers/openusage) into .agents/skills/macos-telemetry in your project. Codex loads it when a task matches its description.
Can I use macOS Telemetry 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 robinebers/openusage --skill macos-telemetry -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-telemetry, .gemini/skills/macos-telemetry, .github/skills/macos-telemetry and .opencode/skills/macos-telemetry in your project.
What does macOS Telemetry need to run?
SKILL.md names no scripts, command-line tools or credentials: macOS Telemetry is instructions for the agent only.
Does macOS Telemetry 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 Telemetry 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 Telemetry use?
macOS Telemetry 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 Telemetry use?
About 934 tokens (SKILL.md is roughly 3.7k 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 Telemetry?
Skills that share tags, products or a category with macOS Telemetry: Deploy Observability (aliyun/alibabacloud-observability-mcp-server, 166 stars), Sls Dashboard Builder (alibaba/loongsuite-pilot, 198 stars), Loongsuite Pilot Insight (alibaba/loongsuite-pilot, 198 stars) and Vercel Optimize Audit (vercel-labs/agent-skills, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains macOS Telemetry?
robinebers (a GitHub user) maintains it in robinebers/openusage, which has 4,333 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 6, 2026.
Source: robinebers/openusage on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.