Content
71%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 compact, well-structured, non-padded skill body with clear sequencing and validation gates. Its main weakness is actionability: it tells Claude what to do but not how, lacking concrete EDGAR endpoints or example requests, and the Purpose section duplicates the frontmatter description.
Suggestions
Add concrete endpoint examples, e.g. fetching https://data.sec.gov/submissions/CIK##########.json for filing indexes and https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json for XBRL facts.
Drop the 'Purpose' section or differentiate it from the frontmatter description to remove verbatim duplication.
Add a short feedback loop under Completion gates (e.g., 'If values do not reconcile, re-fetch the filing index and check amendment status before proceeding').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence ('Normalize units and taxonomy concepts carefully', 'Reconcile extracted values to the filing tables and scale'), but the 'Purpose' section repeats the frontmatter description verbatim, a minor redundancy that keeps it below anchor 5. | 4 / 5 |
Actionability | The tool-routing table and citation requirements ('Cite form, filing date, period, accession number, and SEC URL') provide some concrete guidance, but no executable specifics are given — e.g., the actual EDGAR endpoints like data.sec.gov/submissions/CIK##########.json or companyfacts URLs. This lands between the high-level-hints anchor (2) and the mostly-executable anchor (4). | 3 / 5 |
Workflow Clarity | The 5-step workflow is clearly sequenced and the 'Completion gates' section supplies validation checkpoints (amended filings/restatements, reconciling values to tables and scale), matching the 'clear sequence with most checkpoints' anchor. It falls short of anchor 5 because there is no feedback loop describing what to do when a gate check fails. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, has no external reference files (no references/, scripts/, or assets/ directories exist, and the body makes no reference to any), and is organized into well-labeled sections, which per the simple-skill guideline merits a 5. | 5 / 5 |
Total | 16 / 20 Passed |