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-structured, highly actionable skill with real commands, documented parameters, quantified decision thresholds, and honest disclosure of the unimplemented script. Weaknesses are moderate redundancy across sections, one inconsistent script path, and interpretive detail inlined in SKILL.md that belongs in the existing references.
Suggestions
Fix the inconsistent path in Step 3 ("institutional-flow-tracker/scripts/analyze_single_stock.py") to match the "scripts/" prefix used everywhere else.
Deduplicate: list the WhaleWisdom/SEC EDGAR/DataRoma external resources once, and merge the Step 5 "Screening workflow integration" list into the "Integration with Other Skills" section.
Move the detailed Signal Strength Framework, Limitations, and Advanced Use Cases into the existing references (e.g., interpretation_framework.md), leaving brief signposts in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational and efficient, but there is measurable redundancy: the WhaleWisdom/SEC EDGAR/DataRoma list appears twice (Step 3 and the track_institution_portfolio.py section), "Screening workflow integration" in Step 5 duplicates the "Integration with Other Skills" section, and the "Why coverage, not per-holder reconciliation" paragraph is API-rationale detail that could be trimmed or moved to a reference. Not a 2 because none of it is generic padding or explanation of concepts Claude already knows; not a 4 because the duplication is more than minor. | 3 / 5 |
Actionability | Concrete, copy-paste-ready commands throughout — quick scan, sector scan, custom screening, single-stock deep dive — with full parameter documentation, defaults, output formats, and quantified interpretation thresholds (>15% QoQ, top-10 >50% concentration). Not a 5 because of a minor gap: the Step 3 example invokes "python3 institutional-flow-tracker/scripts/analyze_single_stock.py AAPL" while every other command uses "scripts/...", so one example is not executable as written from the skill directory. | 4 / 5 |
Workflow Clarity | A clearly sequenced 5-step workflow with most checkpoints present: each step's output is specified, and data validation is built in via the A/B/C reliability grades with automatic Grade-C exclusion from screening. Not a 5 because there are no explicit error-recovery loops (e.g., what to do when the API key is missing, rate-limited, or a ticker returns no data); not a 3 because validation checkpoints are explicit and prominent rather than implicit. | 4 / 5 |
Progressive Disclosure | Good structure against the actual bundle: the three reference files exist, are one level deep, and are clearly signaled twice (Step 4 and the References section with per-file descriptions); scripts and their parameters are documented inline. Not a 5 because the SKILL.md is a ~380-line body carrying substantial interpretive bulk — the full Signal Strength Framework, Limitations, and Advanced Use Cases — that overlaps the interpretation_framework.md reference and could be split out. | 4 / 5 |
Total | 15 / 20 Passed |