Content
78%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 tight, well-structured instruction skill with concrete tool mappings, full enum lists, and a clear gated workflow including positive and negative activation examples. The remaining gaps are minor: duplicated open-tool guidance, an unspecified fontSizeLevel range, and no failure handling for tool calls.
Suggestions
State the supported fontSizeLevel range explicitly (e.g., '1-5') or how to discover it, since 'integer level within supported range' is not actionable on its own.
Deduplicate the deepchat_settings_open guidance: keep the 'only when the request cannot be fulfilled / not if already applied' rule in one place instead of repeating it in both the navigation section and Workflow step 6.
Add a brief step for handling a failed or partially-applied tool call (e.g., report the error and fall back to deepchat_settings_open) to close the feedback loop in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes competence, and explains nothing Claude already knows, but the deepchat_settings_open guidance is duplicated ('avoid calling it if the change is already applied' vs. 'Do not call it if the requested change has already been applied') and the skill-activation mechanics appear in both Core rules and Workflow step 2. It fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the 'every token earns its place' anchor at 5. | 4 / 5 |
Actionability | Tool names are mapped per setting ('toggles: deepchat_settings_toggle', 'language: deepchat_settings_set_language', ...), enum values are fully listed (all locale codes, 'theme: dark | light | system'), and section hints are enumerated. It stops short of fully executable because 'fontSizeLevel: integer level within supported range' never states the range and no example tool invocations are shown — the 'minor gaps' anchor at 4 rather than 'fully copy-paste ready' at 5. | 4 / 5 |
Workflow Clarity | The 6-step workflow has a clear sequence with most checkpoints present: an ambiguity gate ('If the request is ambiguous, ask a clarifying question before applying'), a confirm-back step that includes the final value, and an explicit unsupported-settings fallback. It is not a destructive or batch operation so the validation cap does not apply, but there is no handling for a failed tool call, keeping it at 'most checkpoints present; minor validation gaps' rather than the full feedback-loop anchor at 5. | 4 / 5 |
Progressive Disclosure | The skill is well under 50 lines, has no external references to disclose (no references/, scripts/, or assets/ exist in the bundle), and its content is cleanly organized into Core rules, Supported settings, Workflow, and Examples sections. Under the simple-skill guideline this matches the top anchor for a self-contained, well-organized skill. | 5 / 5 |
Total | 17 / 20 Passed |