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 tight, highly actionable skill body: a decision table for endpoint selection, an executable curl command with platform fallbacks, and a rules section that doubles as prompt-injection defense and explicit error-recovery policy. The only deductions are minor trimmable meta-commentary and a referenced LICENSE file missing from the bundle.
Suggestions
Trim the opening paragraph's versioning meta-commentary ("本身以后不需要更新") — it explains the skill's design philosophy rather than guiding behavior, and the server-delegation point is already implied by the workflow.
Resolve the dangling `LICENSE` reference: either ship the LICENSE file in the skill bundle or drop the file pointer and state the license terms inline (or link to the terms URL already used in the rules section).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — endpoint table, one curl command, terse rules — but the opening meta-commentary ("这个 Skill 只负责把问题交给 AIHOT、把结果讲给用户，本身以后不需要更新") and the single-sentence license paragraph are minor instances of explanation that could be trimmed, matching the 'efficient; minor trimmable content' anchor rather than the every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Fully executable guidance: a copy-paste-ready curl invocation with flags, User-Agent, and timeout; a URL table with query-parameter examples and a URL-encoding note; platform fallbacks (curl.exe on Windows, web-fetch tool when no CLI); precise conditional logic for the .aihot-actor-id file; and concrete retry behavior per status code. Common cases are specifically covered. | 5 / 5 |
Workflow Clarity | A clearly sequenced 3-step workflow (pick endpoint from the decision table, request with fallbacks, present results and handle follow-ups) with explicit validation checkpoints for failure modes: 429 → wait per Retry-After, 5xx/timeout → retry once, then report unavailability with the service URL. For a simple single-purpose skill this matches the top anchor. | 5 / 5 |
Progressive Disclosure | The body is well organized in two clear sections, self-contained, and its one external pointer (the usage doc at https://aihot.news/api/v1/agent) is a clearly signaled, one-level reference with a read-once hint. However, the body and frontmatter reference a `LICENSE` file that is not present in the bundle, a minor dangling-reference/organization gap that keeps it below the top anchor. | 4 / 5 |
Total | 18 / 20 Passed |