CtrlK
BlogDocsLog inGet started
Tessl Logo

macos-telemetry

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

64

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/macos-telemetry/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

The content is a well-organized, highly actionable single-file skill: concrete Swift code, exact log-stream predicates, a verify-then-tighten feedback loop, and a verification checklist, with no padding that teaches Claude things it already knows. Its only weaknesses are mild redundancy between the guidelines, workflow, and checklist sections and being slightly too long for the unqualified simple-skill progressive-disclosure score.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — it never explains what OSLog or logging is, and every section instructs rather than teaches. Minor trimmable redundancy remains (feature categories are listed in both Core Guidelines and the pattern section, and the Verification Checklist partially restates workflow steps 4-5), keeping it just below the lean-every-token-earns-its-place level.

4 / 5

Actionability

Guidance is fully executable: a copy-paste-ready Swift Logger pattern and exact verification commands (`log stream --style compact --predicate 'subsystem == "com.example.app" && category == "Sidebar"'`) cover the common instrument-and-verify cases. The one unshown API (signposts) is explicitly justified as conditional ("only when measuring timing or performance spans").

5 / 5

Workflow Clarity

The 5-step workflow has explicit validation (step 4 "Read runtime logs and verify the event fired"), an error-recovery feedback loop ("If it does not fire, move the log closer to the suspected control path and rerun"), a tightening step, and a dedicated Verification Checklist. Telemetry is not a destructive or batch operation, so no cap applies.

5 / 5

Progressive Disclosure

The bundle contains no reference files and the skill is a single self-contained document with clean, well-ordered sections — nothing inlined clearly belongs in a separate file. It is not under 50 lines, so the unqualified simple-skill score of 5 does not apply, leaving good structure with minor organization gaps (the external script/skill pointers are conditional rather than well-signaled bundle references).

4 / 5

Total

18

/

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.

The description is a strong two-sentence what/when pair with an explicit trigger clause and a well-scoped macOS niche. Its main weaknesses are a thin action list on the what side and missing the most natural user phrasing ("logging") plus common synonyms (OSLog, signposts) in the trigger terms.

Suggestions

Expand the what-clause with 1-2 more concrete capabilities, e.g., "Add and verify lightweight macOS runtime telemetry via OSLog Logger subsystems and categories, verified with log stream predicates."

Add the natural synonym "logging" and technical variants users actually say ("OSLog", "Console", "signposts") to the when-clause trigger terms.

Mention the telemetry-vs-crash-debugging boundary in the description to reduce overlap with sibling build/debug skills.

DimensionReasoningScore

Specificity

The description names the domain ("macOS runtime telemetry") and two actions ("Add and verify"), matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several specific capabilities (e.g., subsystem/category filtering, log-stream verification), which the score-4 anchor requires.

3 / 5

Completeness

Both parts are explicit: the what ("Add and verify lightweight macOS runtime telemetry") and a clear when-clause ("Use when wiring Logger events or inspecting logs for windows, sidebars, menus, and actions"). The what is a single compound action rather than the multi-action list in the score-5 exemplar, so it lands at 4 rather than 5, and well above 3 since both what and when are present and explicit.

4 / 5

Trigger Term Quality

Relevant keywords like "Logger events", "logs", "windows, sidebars, menus, and actions" are present, but common variations users would naturally say are missing — notably "logging" itself, plus "OSLog" and "signposts". This fits the anchor for some relevant keywords with missing synonyms rather than the good-with-few-gaps level.

3 / 5

Distinctiveness Conflict Risk

"macOS runtime telemetry" and "Logger events" carve out a clear niche with distinct triggers, minimizing conflict with unrelated skills. There is minor overlap risk with closely related logging/build-debug skills (the body itself names a sibling skill), so it is mostly distinct rather than fully conflict-free.

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
robinebers/openusage
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.