Content
86%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.
A lean, well-structured instruction skill: concrete output schema, explicit untrusted-input handling, and a clear three-step sequence with a pre-handoff gap check. The main improvements are a worked example record and a disposition rule for flagged gaps.
Suggestions
Include one filled example JSON record (with realistic values) alongside the template so the expected extraction shape is unambiguous for common cases.
Add a feedback loop for Step 3: state what to do when gaps are flagged (e.g., proceed with nulls and list gaps in a "gaps" field for the rules engine, or request documents before proceeding).
Specify where the Step 3 gap flags live in the output (e.g., a "gaps" array in the JSON record) so the handoff to kyc-rules is concrete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At 49 lines there is no filler: the document-type table and JSON template carry all information with no explanations of concepts Claude already knows, and directives like "Use `null` for any field not found — do not guess" add exactly the non-obvious guidance that earns its tokens. | 5 / 5 |
Actionability | The Step 2 JSON record is a copy-paste-ready output template with concrete field names and types, and Step 1's table enumerates exact document types. The minor gap is that all example values are "..." placeholders — a filled example record would show a realistic extraction. | 4 / 5 |
Workflow Clarity | Three clearly sequenced steps (inventory → extract → flag gaps) with an explicit pre-handoff checkpoint in Step 3 (expired IDs, stale address proof, missing UBO chart). It falls short of a 5 because there is no feedback loop telling the agent what to do when a gap is flagged (proceed, request documents, or halt). | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, and needs no external references; its sections (untrusted-input note, inventory table, output schema, gap flags) are well-organized, which per the rubric's simple-skill guidance merits a 5. | 5 / 5 |
Total | 18 / 20 Passed |