CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

macos-control-skill

当用户要求 AI 直接操作他的 macOS 桌面时触发:打开某个 App、点击某个按钮、填写窗口里的表单、读取当前屏幕内容、自动化本地 GUI 流程。典型说法"帮我在访达里…"、"帮我在某 App 里点一下…"、"看看我屏幕上显示的是什么"。**仅在 OpenLoaf Desktop(macOS)中可用**;非桌面端会返回 desktop-only 错误,应改用 `BrowserAct` 或让用户自己操作。**不用于**:网页内交互(→ `browser-ops-skill`)、本地文件读写(→ `Read`/`Edit`/`Write`)。

75

Quality

94%

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

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.

A strong, highly actionable skill body: concrete tool invocations, explicit verification loops, and precise failure handling for a stateful GUI domain. The main improvements are trimming repeated warnings and moving the long sample Survey output out of the main file.

Suggestions

Consolidate the self-drawn UI / WINDOW_CHROME_BLOCKED warning into one authoritative section and reference it from 铁律 and 错误诊断 instead of restating the mechanism each time.

Move the ~30-line sample Survey return block into a references/ file (e.g. survey-output-example.md) and keep only a 5-line distilled excerpt in SKILL.md to reduce always-loaded tokens.

Consider moving scenarios D–F into a scenarios reference file so the always-loaded core holds the framework, priorities, and 铁律 only.

DimensionReasoningScore

Conciseness

The body is dense and operational with no padding about concepts Claude already knows, but the self-drawn/close-button hazard is explained in four places (核心思维, 执行路径的优先级, 铁律 4, 错误诊断) and 'Survey first' is restated three times, so minor trimming is possible.

4 / 5

Actionability

Tool calls are copy-paste ready (e.g. 'MacosAct { type: "intent", app: "WeChat", intent: "open_moments" }'), the Survey return is shown as a full concrete example, and six scenario walkthroughs cover the common cases including error codes and exact responses.

5 / 5

Workflow Clarity

A clear three-phase framework (Survey → Plan → Act+Verify) is sequenced with explicit validation (MacosObserve after every MacosAct), error-recovery guidance per failure mode, stop rules, and a checklist (铁律) — matching the anchor for explicit validation with feedback loops.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear sections and no nested references, but the ~30-line sample Survey output and the scenario catalog are inline content that could be split into a reference file, leaving minor organization gaps versus the ideal overview-plus-references split.

4 / 5

Total

18

/

20

Passed

Description

100%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 exemplary: concrete capabilities, verbatim trigger phrases, explicit availability constraints, and clear de-scoping with redirects to sibling skills. It fully satisfies the what/when requirement with no over-claims or padding.

DimensionReasoningScore

Specificity

The description lists five concrete actions — '打开某个 App、点击某个按钮、填写窗口里的表单、读取当前屏幕内容、自动化本地 GUI 流程' — giving comprehensive, specific coverage of the skill's capabilities with no vague filler.

5 / 5

Completeness

It explicitly answers both what (open apps, click, fill forms, read screen, automate GUI) and when ('当用户要求 AI 直接操作他的 macOS 桌面时触发' with concrete typical phrasings), and adds the environment constraint (OpenLoaf Desktop/macOS only).

5 / 5

Trigger Term Quality

It quotes verbatim natural user phrasings ('帮我在访达里…', '帮我在某 App 里点一下…', '看看我屏幕上显示的是什么') plus the full action vocabulary (open/click/fill/read screen/automate GUI), comprehensively covering what a user would naturally say.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche with explicit negative boundaries and redirects — '不用于:网页内交互(→ browser-ops-skill)、本地文件读写(→ Read/Edit/Write)' plus desktop-only scoping — minimizing risk of triggering for the wrong skill.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

itsablabla/openloaf-web

Path

apps/server/src/ai/builtin-skills/macos-control/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.