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 excellent, tightly written skill body: lean, concrete, and with a genuine validation feedback loop — the holdout-thread check is stronger than most skills manage. The one real gap is that the bundled scripts/fetch_sent.py is never mentioned in the body, so the corpus-pull step reads as manual work despite an existing automation script.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence throughout: no explanations of what email or Gmail is, no library intros, no padding. Every paragraph carries non-obvious operational knowledge — e.g., "only `--`-delimited signatures are stripped, so a plain signature ... survives at the end of many bodies" and "patterns a generic professional emailer would not share" — so every token earns its place. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: exact paths ("voice/corpus/corpus.jsonl", "voice/email-voice-profile.md"), numeric thresholds ("up to 300", "if fewer than ~50 usable emails survive"), a required output format ("one JSON line per email ... tagged `internal` or `external`"), an exact seven-section profile template, an evidence format with frequencies ("uses 'Best,' in 80% of external mail"), and a validation protocol ("Hold out 3 real threads"). Nothing reads as vague direction. | 5 / 5 |
Workflow Clarity | The four numbered sections give a clear pull → study → write → validate sequence with explicit validation and feedback loops: section 4 ("Validate before declaring done") requires holdout-thread drafting, comparison against what was actually sent, and tightening the profile where the real email diverges, plus a user review loop ("ask what feels wrong; their corrections go in as hard rules"). Section 1 adds an early checkpoint ("if fewer than ~50 usable emails survive, tell the user the profile will be rough and ask whether to continue"). | 5 / 5 |
Progressive Disclosure | The body is well organized with clear sections sized appropriately for a single-file skill, but the bundle actually contains scripts/fetch_sent.py — which implements exactly section 1's work (fetch up to 300 sent messages, strip quotes/signatures, drop automated mail, write tagged JSONL) — and the body never references it, instead saying "Use the selected email access skill to retrieve". Scored against the actual bundle structure, that is a missed navigation opportunity: a Claude reading this skill would redo manually what the bundled script already automates. | 4 / 5 |
Total | 19 / 20 Passed |