Content
61%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.
The content is actionable and well-structured, built around concrete executable CLI commands. Its main weaknesses are mild verbosity, a repeated discovery command, and an absence of validation/verification checkpoints for data-mutating operations.
Suggestions
Add explicit validation steps, e.g. after running a mutating action, check the JSON output for errors and confirm the change before proceeding.
Trim the opening 'what is DeskTime' paragraph and deduplicate the action-discovery command by defining it once and referencing it.
Consider moving the proxy flag reference table into a separate REFERENCE.md and linking to it to keep the overview lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly commands and brief guidance, but the opening paragraph ('DeskTime is a time tracking software...') explains what DeskTime is and the discovery command is repeated across sections, so it could be tightened. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready npx CLI commands with flags for login, connect, action list/run, and proxy requests, with only minor gaps such as a generic placeholder for the proxy endpoint path. | 4 / 5 |
Workflow Clarity | A sequence exists (setup -> connect -> discover actions -> run/proxy), but there are no explicit validation or verification checkpoints after running actions; since the skill can mutate DeskTime data, the missing feedback loop caps this at 3. | 3 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into clearly signaled sections (Overview, Working with DeskTime, Popular actions, Best practices) with no nested references, though at over 100 lines some reference material (e.g. the proxy flag table) could arguably live in a separate file. | 4 / 5 |
Total | 14 / 20 Passed |