Content
55%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 body is compact and points to the OpenAPI spec for payload details, but its content does not deliver the skill's stated purpose: it documents env/repair and version endpoints rather than backup, restore, or SQLite lifecycle operations, provides no usable workflows or payload examples, and includes no validation for the destructive restore operation.
Suggestions
Document the actual backup/restore/import endpoints with concrete example payloads instead of (or in addition to) the current env/repair and version endpoints.
Add a step-by-step workflow for restore (a destructive operation) with an explicit validation checkpoint, e.g. verify the backup file exists and check database integrity after restore.
Remove the verbatim Overview duplicate of the description and the redundant 'GET/POST system › ...' breadcrumb lines to tighten token usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no concept explanations and defers payload schemas to the OpenAPI spec. Minor waste keeps it below 5: the Overview repeats the frontmatter description verbatim, and redundant breadcrumb lines like 'GET system › env › repair' duplicate each heading. It is well above 3, which requires noticeably unnecessary explanation. | 4 / 5 |
Actionability | The curl commands are executable, but the POST examples send empty bodies ('-d {}') with no indication of required payload fields, and there is not a single example of the skill's stated purpose — triggering a backup, restoring from a file, or importing a snapshot. Concrete guidance exists but key details are missing, matching the 3 anchor rather than 4. | 3 / 5 |
Workflow Clarity | No sequence exists for the backup/restore lifecycle at all — the documented endpoints (env/repair, version) are unrelated to backups, so a user cannot determine steps for backup, restore, or export/import. Restoring from a backup is a destructive operation with no validation or verification guidance, which per the guidelines caps workflow clarity at 3; the absence of any sequence places it at 2. | 2 / 5 |
Progressive Disclosure | Short, sectioned body with payload details correctly deferred one level to 'GET /api/openapi/spec' or 'docs/openapi.yaml'. Not 5 because 'docs/openapi.yaml' is not part of the bundle (no references/ directory exists), and the inline endpoint details do not cover the skill's actual subject matter. Well above 3 — structure and navigation are clear. | 4 / 5 |
Total | 13 / 20 Passed |