CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

telemetry

Add and verify lightweight macOS runtime telemetry. Use when wiring Logger events or inspecting logs for windows, sidebars, menus, and actions.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, highly actionable skill: executable Swift and shell examples, a five-step workflow with explicit verification, failure feedback loop, and a checklist. The only weakness is minor redundancy between the Quick Start paragraph, Core Guidelines, and the checklist/guardrail sections, which could be deduplicated to save tokens without losing any guidance.

DimensionReasoningScore

Conciseness

The body is efficient — a compact code sample, terse bullet guidelines, and concrete commands with no padding and no explanation of concepts Claude already knows. It falls short of level 5 only through mild redundancy: the Quick Start paragraph restates the description, and the sensitive-payload and debug-log-noise points each appear twice (Core Guidelines vs. Verification Checklist / Guardrails).

4 / 5

Actionability

Guidance is fully executable: a copy-paste-ready Swift Logger pattern with a privacy-interpolated log call, exact `log stream --style compact --predicate` commands including a tightened subsystem/category predicate, and a conditional script invocation. Concrete commands cover the common verification cases (Console.app, terminal streaming, filtered predicates).

5 / 5

Workflow Clarity

The five-step workflow has an explicit validation step ("Read runtime logs and verify the event fired"), a feedback loop for failure ("If it does not fire, move the log closer to the suspected control path and rerun"), a closing tightening step, and a dedicated Verification Checklist — a direct match to the anchor-5 pattern of sequence + explicit validation + error-recovery loop + checklist.

5 / 5

Progressive Disclosure

The skill is a single-purpose, self-contained document (~80 lines) with no bundle files, and nothing inlined that belongs in a separate file. Sections are cleanly organized (Quick Start, Core Guidelines, Minimal Logger Pattern, Workflow, Verification Checklist, Guardrails), the cross-references to `build-run-debug` and the hedged `script/build_and_run.sh` are one level deep and clearly signaled, so the simple-skill organization standard is met.

5 / 5

Total

19

/

20

Passed

Description

62%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid description with an explicit Use-when clause and a well-defined macOS niche, though it is held back by a thin what-clause and a keyword set that omits the natural synonyms (logging, OSLog, Console, signposts) users would most likely say. It reads like the anchor-4 completeness example: both what and when present, with the when-clause narrower than ideal.

Suggestions

Broaden the trigger vocabulary with the synonyms users naturally say — e.g. "Use when adding logging or OSLog/Logger events, checking Console output, or inspecting telemetry for windows, sidebars, menus, and actions."

Make the what-clause more concrete by naming the actual operations: "Add and verify lightweight macOS runtime telemetry using the OSLog Logger: create subsystem/category loggers, log lifecycle and UI events, and confirm emissions via Console or log stream."

Add a negative boundary to reduce overlap with debugging skills, e.g. "For crash/backtrace analysis, use build-run-debug instead" — currently only the body carries that distinction.

DimensionReasoningScore

Specificity

"Add and verify lightweight macOS runtime telemetry" names the domain and two actions (add, verify), and "wiring Logger events or inspecting logs" adds concrete operations, but the core what-clause stays at the level of "Processes PDF files and extracts content" rather than enumerating several specific actions. It is above level 2 (domain is named with real, if few, concrete actions) but below level 4 because coverage of what the skill does is not comprehensive — the body reveals far more capabilities (signposts, predicates, filtering) than the description conveys.

3 / 5

Completeness

Both parts are explicit: the what is "Add and verify lightweight macOS runtime telemetry" and the when is "Use when wiring Logger events or inspecting logs for windows, sidebars, menus, and actions". It sits at level 4 rather than 5 because the when-clause covers task-shaped triggers only; unlike the anchor-5 example it does not also cover mention-shaped triggers (e.g., "when the user mentions OSLog, Console, or log output"), leaving some natural invocation paths unlisted.

4 / 5

Trigger Term Quality

Relevant keywords are present ("macOS", "telemetry", "Logger events", "logs", "windows, sidebars, menus, and actions"), but common natural variations users would actually say are missing: "logging", "OSLog", "Console", "log stream", "signposts". This matches the "Works with PDF files" anchor — some relevant keywords but missing common variations or synonyms.

3 / 5

Distinctiveness Conflict Risk

"macOS runtime telemetry" plus "Logger events" carves out a clear niche that is unlikely to fire for unrelated skills. It stops short of level 5 because "inspecting logs for windows, sidebars, menus, and actions" overlaps with general macOS debugging/logging skills, so a sibling skill could compete for the same trigger.

4 / 5

Total

14

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/build-macos-apps/skills/telemetry/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.