Content
96%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 library-usage skill: dense with non-obvious, version-current pitfalls, fully executable examples with expected outputs, and a real debugging feedback loop. The only flaw is a single ambiguous inline reference ('see references for the rest') that points at no actual bundle file.
Suggestions
Point '(see references for the rest)' at a concrete destination — e.g., the 'Going deeper' section or node_modules/compromise/docs/match-syntax.md — since no references/ bundle file ships with the skill.
If the match-syntax cheat sheet grows further, move the full operator table into a bundled reference file (e.g., references/match-syntax.md) and keep SKILL.md as the lean overview, which would also give the inline pointer a real target.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries library-specific, non-obvious knowledge — in-place mutation semantics ('Transforms mutate the document in place'), silent failure of invalid tags ('an invalid #Tag matches nothing, silently'), term-level match syntax, and methods that throw ('.money().currency()… do not exist'). There is no general NLP/JavaScript explanation and no padding; each token earns its place. Not 4 because there are no identifiable over-explanations to trim — even the intro paragraph conveys the library-specific document/View model, not concepts Claude already knows. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready code with expected outputs throughout ('nlp(\'five hundred\').numbers().toNumber().text() // \'500\''), including correct-vs-incorrect contrasts for the mutation rule, exact replacements for nonexistent methods ('Use .money().json() / .fractions().get() instead'), and concrete debugging commands. Matches the anchor-5 pattern of runnable examples covering the common cases; not 4 because no key case is left pseudocode or incomplete. | 5 / 5 |
Workflow Clarity | A single-purpose skill whose flow is unambiguous: internalize the five rules → apply verified patterns → heed sharp edges → follow the explicit error-recovery loop ('doc.debug() // prints how every word was actually tagged — start here', then json(), verbose, then a three-cause checklist for empty matches). The debugging section is a genuine validate→diagnose→retry feedback loop; not 4 because checkpoints for the risky paths (wrong tags, empty matches, throwing methods) are explicit rather than implicit. | 5 / 5 |
Progressive Disclosure | Good structure: a lean cheat-sheet body with a well-signaled 'Going deeper' section pointing one level deep to version-matched package docs, each described by purpose ('match-syntax.md — every match operator', 'tag-definitions.md — the complete, valid tagset'). Not 5 because the inline pointer '(see references for the rest)' does not resolve to a real bundle file — no references/ directory ships with the skill — leaving one navigation target ambiguous; not 3 because all other references are clearly signaled and the content split is otherwise appropriate. | 4 / 5 |
Total | 19 / 20 Passed |