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.
An exemplary compact instruction skill: dense, policy-specific, and honest about safety boundaries (untrusted inputs, draft-only JE). The remaining gaps are minor — a worked example and an explicit tie-out/balance check would complete it.
Suggestions
Add a one-row worked example with real numbers (basis, period portion, already booked, resulting accrual) to make the derivation table fully copy-paste-ready.
Add a validation checkpoint before output, e.g. "Confirm each JE's Dr equals Cr and each this-period accrual ties to the schedule rows".
Clarify the deferred formula path — state how to resolve "or the policy's specific formula" when the policy list defines a non-standard calculation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 33-line body is lean and assumes competence: a field-derivation table, a JE template, and firm-specific policy (untrusted invoices, auto-reversing memos, do-not-post) that Claude cannot already know. No concept explanations or padding; every token earns its place. | 5 / 5 |
Actionability | Concrete per-field derivations ("Basis × (days in period ÷ days in basis period)"), an exact Dr/Cr/memo template, and an explicit data source ("from internal-gl MCP") make the guidance mostly executable. Minor gaps: no worked numeric example, and "or the policy's specific formula" defers one calculation path. | 4 / 5 |
Workflow Clarity | The sequence is clear — derive fields per accrual, draft JEs for non-zero rows, output schedule plus JE block — with an explicit control ("Do not post — this is staged for controller sign-off"). It is a draft-only (non-destructive) skill, so the batch-cap does not apply, but validation is thinner than the top anchor: no tie-out/reconciliation check against GL totals and no Dr-equals-Cr confirmation. | 4 / 5 |
Progressive Disclosure | Under 50 lines, no external references needed, and well-organized sections (derivation table, JE draft, output). No bundle files exist and none are referenced, so per the simple-skill note the well-organized single file matches the top anchor. | 5 / 5 |
Total | 18 / 20 Passed |