Content
92%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 well-engineered, executable skill body: copy-paste-ready tool calls, a clearly sequenced workflow with explicit validation gates and failure handling, and a clean one-level reference split. The only nit is minor redundancy between the rules block and the workflow steps.
Suggestions
Trim redundancy between the 'Non-negotiable rules' section and the workflow steps (e.g., serial ordering and 'only lobsterai_skin_manage may register' are restated) to push conciseness from efficient to fully lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it explains only LobsterAI-specific host behaviors (corner radius, theme inference) rather than general concepts — but the 'Non-negotiable rules' list repeats constraints already enforced in the workflow steps (serial ordering, no direct file writes), which keeps it just short of fully lean. | 4 / 5 |
Actionability | Each tool interaction ships a copy-paste-ready JSON block (create_draft, register_asset, apply) with concrete palette values, focus coordinates, explicit contrast ratios (4.5:1, 3:1), and filename hints, plus clear 'replace every example value' guidance. | 5 / 5 |
Workflow Clarity | A six-step numbered sequence runs build-art-direction through validate-and-apply, with explicit validation gates ('Proceed only after registration succeeds', 'Apply only when both required slots are registered and ready') and a dedicated failure-handling section providing error-recovery feedback loops for this batch operation. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a focused overview that offloads the per-slot composition contracts and prompt-suffix templates to a single, clearly signaled, one-level-deep reference (references/asset-contract.md), which exists and is directly relevant; navigation is unambiguous. | 5 / 5 |
Total | 19 / 20 Passed |