Content
57%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 a well-structured, compact product README, but it describes AuraKit rather than instructing Claude how to operate it — no mode behavior, workflow steps, or post-install guidance beyond raw command invocations. Structure and organization are genuinely good; the gaps are operational. The mixed-language usage examples (Korean) further limit who can act on them unaided.
Suggestions
Add a short 'How it works' section defining what Claude should do after /aura is invoked — at minimum the steps for the primary BUILD mode and how mode keywords (fix:, review:, pro) change behavior.
Convert marketing claims in Key Features into verifiable statements or move statistics out of the body; keep only what changes Claude's behavior.
Provide English glosses for the non-English usage examples so the invocation patterns are actionable for all users.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is compact (~43 lines) and explains nothing Claude already knows, but the Key Features section carries promotional padding ("Verified: 82KB → 20KB per BUILD load", "5-step forced reasoning for Opus-level quality from Sonnet") that could be tightened into factual statements. Mostly efficient with some unnecessary marketing content. | 3 / 5 |
Actionability | Install commands are executable ("npx @smorky85/aurakit", git clone + install.sh) and Usage shows real /aura invocations, but the actual operational guidance is missing: no mode definitions, no description of what Claude should do when /aura is invoked, and no configuration steps for the "13 runtime hooks". Concrete guidance exists but key details are absent. | 3 / 5 |
Workflow Clarity | There is a rough sequence (install → invoke commands) but the workflow after invocation is entirely undefined — what a BUILD, FIX, or REVIEW mode actually does and in what order is never stated. The simple-skill exception does not apply because the single action is ambiguous, not unambiguous. | 3 / 5 |
Progressive Disclosure | The skill is under 50 lines with no external reference files needed (references/, scripts/, assets/ are absent), and the content is organized into clear, well-labeled sections (Overview, Key Features, Install, Usage, Links) with outbound links properly isolated in a Links section. This fits the simple-skill guideline of scoring 5 on well-organized sections alone. | 5 / 5 |
Total | 14 / 20 Passed |