Content
67%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 well-organized, actionable instruction skill with explicit formulas, decision rules, and a clear 8-step workflow with validation gates. It is held back from the top band mainly by repetitive scope restatements and the lack of a concrete worked example or QA-sheet template.
Suggestions
Consolidate the scope line (tag-fires vs value vs R1/R2 routing) to a single statement instead of restating it in the intro, step 1, step 7, and the termination section.
Add a short worked numeric example for net_value and proxy_value derivation, or ship a value-model spec template as a bundled reference file the body links to.
Make the value-vs-count reconciliation step a validate→fix→retry loop (e.g., on mismatch, name the gap and re-run after the margin/proxy fix) to reach the top workflow-clarity band.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of basic-concept padding, but the scope line is restated multiple times (body intro, step 1, step 7, termination) and the Skill Contract/Instructions overlap noticeably, adding tokens that could be tightened. | 3 / 5 |
Actionability | Concrete formulas (net_value = revenue × margin, proxy_value = avg_order_net_value × lead→sale close_rate), explicit value labels (Measured/User-provided/Estimated), and named decision rules give mostly executable guidance; minor gaps are the absence of worked numeric examples and a sample spec/QA-sheet template. | 4 / 5 |
Workflow Clarity | An 8-step numbered sequence with explicit validation/reconciliation gates (needs-input flags, value-vs-count reconciliation, launch-readiness verdict) and clear handoff; just short of a 5 because reconciliation and launch-readiness lack explicit fix-and-retry feedback loops. | 4 / 5 |
Progressive Disclosure | Good structure with well-signaled one-level-deep references (CONNECTORS.md, SECURITY.md, skill-contract.md, sibling skills); however the body has no bundle files (no references/scripts/assets dirs) and inlines some content that could live in a template file, leaving minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |