Content
60%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.
The body is a dense, well-structured compliance manual with concrete regulatory guidance and clear decision workflows, but it is noticeably verbose for a SKILL.md and inlines encyclopedic detail that would be better split into the existing reference files.
Suggestions
Move the full GRI breakdown, penalty-tier framework, escalation table, and performance-indicator table into reference files, keeping SKILL.md a lean overview that links to them.
Trim general-knowledge explanations Claude already has (e.g., what the Harmonized System is, what a Bill of Lading is) and retain only the specific regulatory citations, deadlines, thresholds, and formulas.
Add explicit validation gates to the classification and valuation workflows (e.g., 'Verify binding-ruling alignment before filing') to close the remaining workflow-checkpoint gaps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~235-line body inlines large encyclopedic sections (full GRI breakdown, penalty-tier framework, escalation table, performance-indicator table) and explains concepts Claude already knows (what the Harmonized System is, what a Bill of Lading is), making it noticeably verbose even though much of the regulatory detail is accurate. | 2 / 5 |
Actionability | It provides concrete, specific guidance — numbered decision procedures (7-step classification, 6-step FTA qualification, 6-method valuation with 'Fails when' conditions), exact regulatory citations (19 CFR §141.86, 19 USC §1592, 19 CFR §162.74), penalty multipliers, filing deadlines, and an 85% screening threshold — which is highly actionable for an instruction skill, with only minor gaps where steps reference external databases (CROSS, BTI). | 4 / 5 |
Workflow Clarity | Multi-step processes (classification, FTA qualification, valuation selection, screening assessment) are clearly numbered with documentation-as-validation checkpoints ('Document the rationale', 'Check for binding rulings') and explicit fail conditions, but a few workflows lack an explicit 'verify before proceeding' gate, leaving it just below the full-feedback-loop anchor of 5. | 4 / 5 |
Progressive Disclosure | All three bundle files (decision-frameworks.md, edge-cases.md, communication-templates.md) exist and are clearly signaled with one-level-deep links, but the SKILL.md itself is a full manual rather than a lean overview — substantial detail (escalation tables, performance indicators, full GRI list) is inlined that could live in references, leaving minor organization gaps. | 4 / 5 |
Total | 14 / 20 Passed |