Content
93%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.
An exemplary content body: executable commands with exit-code semantics, high-signal rules, and clean one-level progressive disclosure to real bundle files. The only weakness is that the error-recovery feedback loop (fix findings, re-run until the gate passes) is implied by blocking exit codes rather than stated as an explicit step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with earned tokens: three copy-paste commands, per-step check descriptions, a hard-rules list, and an exit-code table, with no explanation of what i18n is or how the libraries work. The five-line failure-mode intro is the only framing text and it directly motivates the checks; the CLDR 49 mention is data provenance for the embedded plural table, not time-sensitive API guidance, so neither warrants dropping to a 4. | 5 / 5 |
Actionability | "python scripts/locale_sync.py locales/ --source-locale en", "python scripts/hardcoded_strings.py src/", and the pseudo-locale commands are copy-paste ready with realistic paths and flags, and the table documents per-script exit codes plus --help/--sample/--output json. Adoption mechanics (--warn-only, i18n-ignore, .i18n-allow) cover the common legacy-codebase case, matching the fully-executable anchor. | 5 / 5 |
Workflow Clarity | Steps 1-3 are clearly sequenced and each is itself a validation checkpoint with documented blocking exit codes ("0 · 2 warnings · 3 bad input · 4 blocked"), plus finding-handling guidance ("read each finding", "Mark gaps for a translator"). It is not a 5 because the fix-and-re-validate loop is only implied by the blocking exit codes — there is no explicit "fix issues and re-run until exit 0" instruction, and the pseudo-locale step's click-through lacks a structured checklist; it is well above a 3 because checkpoints are explicit and error-handling paths are written out. | 4 / 5 |
Progressive Disclosure | SKILL.md is a 68-line overview whose three reference files (plurals_and_messages.md, string_routing_and_formatting.md, layout_rtl_pseudo.md) and two assets (i18n-gate.yml, i18n-allow.example) are each listed with a one-line description, verified to exist, and exactly one level deep; scripts expose further detail via --help/--sample. This matches the clear-overview, well-signaled, easy-navigation anchor with no inline content that belongs in a separate file. | 5 / 5 |
Total | 19 / 20 Passed |