Content
75%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 well structured with a clear two-mode contract, concrete output formats, and real, well-signaled one-level-deep references. Its main weaknesses are redundancy between the inline quick-reference rules and the reference files, plus Scalekit-specific content that contradicts the skill's own site-agnostic claim.
Suggestions
Trim the "Key rules (quick reference)" section to the handful of always-FAIL rules and defer the full list to references/style-principles.md, which already covers most of it.
Move the Scalekit-specific Code rules (SDK language tabs, `scalekit` variable names) into the site-specific prompt block or a site reference, keeping SKILL.md genuinely site-agnostic as the Adapt section claims.
Add a verification step to review mode, such as re-reading the FAIL list against the draft before reporting, to give the workflow an explicit checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~40-line "Key rules (quick reference)" section duplicates material already in references/style-principles.md (sentence case, story first, then the work, imperative verbs all appear in both), and the Scalekit-specific Code rules (four SDK languages, `scalekit` variable names) duplicate the site prompt block the skill also loads. This is 'mostly efficient but includes some unnecessary explanation or could be tightened' — not anchor 2's pervasive padding, since the rest of the body is dense and earns its place. | 3 / 5 |
Actionability | Guidance is copy-paste ready: an exact report format block (PASS/FAIL/WARN with arrow syntax), exact paste destinations (CLAUDE.md, .cursorrules, .github/copilot-instructions.md), concrete before/after examples ("Configure your auth provider" not "Configure Your Auth Provider"), and specific fallback paths. As an instruction-only skill, the absence of executable code is not penalized per the rubric's scoring notes, and the guidance fully covers the common cases. | 5 / 5 |
Workflow Clarity | Both modes have clear numbered sequences, a mode-selection table up front, priority-ordered reporting (fails, warns, passes), a defined closing action, and a session-level feedback loop ("Did this solve what you were trying to do?" with an issue-filing fallback). It falls short of anchor 5 because there are no in-workflow validation checkpoints verifying the produced output (e.g., confirming the exported prompt block is complete) — though as a non-destructive, non-batch skill it incurs no cap. | 4 / 5 |
Progressive Disclosure | All four referenced files (style-principles.md, scalekit-style-prompt-block.md, llms-judge-rubric.md, _template-style-prompt-block.md) exist, are one level deep, and are clearly signaled per mode with explicit load instructions. It is not anchor 5 because content that should live in those references is inlined in the body: the quick-reference rules duplicate style-principles.md and the Scalekit-specific code rules belong in the site prompt block rather than the site-agnostic SKILL.md. | 4 / 5 |
Total | 16 / 20 Passed |