Content
88%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A dense, highly operational skill body: the required tool loop, verification contract, error-recovery rules, and platform caveats are all stated with exact tool names and parameters rather than vague direction. Its only soft spots are a small amount of inline detail that could live in reference files and the inability to verify the four linked reference files against the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and largely non-redundant — it assumes competence, explains no general concepts, and every section carries operational content (e.g., "Omit cursor_theme during normal session setup", "Never send element_token: \"\"\"). Minor trimmable spots remain: the Agent Cursor theme-profile detail ("retired v1 themes with modifier artwork are not compatible... session badge rather than by theme modifier assets") and some verification guidance repeated across 'Required Loop' and 'Action Results and Verification' keep it below the lean-every-token-earns-its-place anchor of 5. | 4 / 5 |
Actionability | Guidance is concrete and directly executable in the plugin's tool vocabulary: exact calls with parameters such as `start_session({ session, capture_scope: "auto" })`, `click({ pid, window_id, x, y, session })`, `zoom({ pid, window_id, x1, y1, x2, y2, session })`, plus enumerated refusal codes (`snapshot_id_required`, `stale_element_token`) with a precise retry-once recovery recipe. Specific examples cover the common cases, matching the fully actionable anchor. | 5 / 5 |
Workflow Clarity | The 'Required Loop' is a clearly sequenced 9-step workflow with explicit validation checkpoints — snapshot before every action, verify after every action, a defined recovery loop ("take one fresh get_window_state and retry once with a token or index-plus-snapshot pair entirely from the new result"), and mandatory `end_session` cleanup including error paths. Feedback loops and postcondition checks are explicit throughout, matching the top anchor. | 5 / 5 |
Progressive Disclosure | Structure is good: a 'Linked References' section cleanly signals four one-level-deep files with one-line descriptions (`README.md`, `WEB_APPS.md`, `RECORDING.md`, `TESTS.md`), and browser/recording detail is deferred to them. It falls short of 5 because none of the referenced files are present in the bundle to verify, and detailed contract material (the full Agent Cursor section, the complete ActionResult effect taxonomy) is inlined in SKILL.md rather than split out. | 4 / 5 |
Total | 18 / 20 Passed |