Content
92%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 highly actionable, well-structured skill body: concrete tables for all five contract sections, a copy-paste YAML output format, a sequenced extraction workflow with an explicit no-fabrication/gap-flagging validation gate, and clean separation of worked examples into a single verified reference file. The only trimmable content is the terminology-provenance aside and the external citation list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and information-bearing — field-by-field tables, a complete YAML template, and an anti-patterns table with almost no filler, and it does not explain concepts Claude already knows. Minor over-explanation could be trimmed: the terminology-provenance aside ("'Data contract' is practitioner-emergent terminology (Andrew Jones / Chad Sanderson), not ISTQB-canonical; this skill cites industry-engineering sources") and the References section's ISTQB/ISO citations don't directly advance the task. That places it at the score-4 anchor ('efficient; minor instances of over-explanation that could be trimmed') rather than score 5, and well above score 3. | 4 / 5 |
Actionability | The skill provides a complete, copy-paste-ready YAML output template ("contract_version: 1 ... schema: - name: order_id, type: BIGINT, nullable: false, pk: true ..."), exact field tables for all five contract sections, a concrete gap-question table template, and unambiguous rules like "If only column names are given, flag missing types as gaps; do not guess". This matches the score-5 anchor: fully executable output covering the common cases, not the score-4 anchor with 'minor gaps'. | 5 / 5 |
Workflow Clarity | The 'Step-by-step extraction' section gives a clear 6-step sequence (schema → PII tagging → freshness → volume → distribution → ownership) with per-step source hints, and validation checkpoints are explicit rather than implicit: "Force the data-product author to confirm", "The agent never fabricates contract fields. Every gap becomes an explicit question", and "Until the gaps are filled, the contract is incomplete and the test suite cannot be generated". This matches the score-5 anchor (clear sequence with explicit validation steps and a feedback loop to the human); the destructive/batch cap does not apply since this is documentation extraction, and no destructive or batch operation is involved. | 5 / 5 |
Progressive Disclosure | The body is a well-organized overview (contract structure, output format, workflow, anti-patterns) with the three worked examples correctly split out to a clearly signaled, one-level-deep reference: "Three worked examples (PRD to contract, minimal source with a gap list, and refactor of an existing dataset) are in [references/examples.md](references/examples.md)" — verified to be a real file that back-references SKILL.md without further nesting. This matches the score-5 anchor (clear overview, well-signaled one-level-deep references, appropriately split content) rather than score 4, since the inline YAML is core output format, not content that belongs in a separate file. | 5 / 5 |
Total | 19 / 20 Passed |