Content
78%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 well-organized, actionable reference with precise IBD rules, decision tables, and an executable CLI —Claude could run this skill directly from it. Its main weaknesses are the un-signaled references/ bundle (two methodology files exist but are never linked, with content partially duplicated inline) and the absence of an error-recovery loop in the workflow.
Suggestions
Add a '## References' section linking the existing bundle files (e.g., '**Methodology details**: See [ibd_distribution_methodology.md](references/ibd_distribution_methodology.md); **Exposure rationale**: See [tqqq_exposure_policy.md](references/tqqq_exposure_policy.md)) so the one-level-deep bundle is discoverable from SKILL.md.
Add an explicit error-recovery step to the workflow, e.g., what to do when the FMP API call fails or data-quality validation rejects sessions (retry, fall back to cached data, or halt with a warning).
Trim implementation-noise from SKILL.md (the '直近 N 取引日' bilingual aside, the ensure_ascii=False detail, and the free-tier note) to tighten token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: rule thresholds, risk/exposure tables, and a CLI command, with no explanation of concepts Claude already knows. Minor trimmable content keeps it below the top anchor — the bilingual aside "rather than '直近 N 取引日' to avoid ambiguity", the free-tier note ("Free tier (250 calls/day) is sufficient"), and implementation details like "ensure_ascii=False" padding the Outputs section. Not score 3 because these are minor instances rather than unnecessary explanations of whole sections. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready CLI command with all flags ("python3 skills/ibd-distribution-day-monitor/scripts/ibd_monitor.py --symbols QQQ,SPY --lookback-days 80 --instrument TQQQ ..."), exact detection thresholds, API-key resolution priority order ("--api-key, config.data.api_key, or FMP_API_KEY env var"), and concrete output file patterns. This matches the anchor for fully executable commands covering the common cases. | 5 / 5 |
Workflow Clarity | The 9-step workflow is clearly sequenced and includes validation checkpoints ("Validate data quality; record skipped sessions in audit", "flag market_below_21ema_or_50ma (None if data insufficient)"). It falls short of the top anchor because there is no explicit error-recovery feedback loop — e.g., what to do when the FMP API call fails or data validation rejects sessions. Not score 3 because checkpoints are present, only the retry/fix guidance is missing. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and the CLI command points at the real scripts/ bundle, but the two reference files in references/ (ibd_distribution_methodology.md, tqqq_exposure_policy.md) are never mentioned or linked anywhere in SKILL.md, and their content (detection rules, exposure policy) is partially duplicated inline. Per the guideline to score against the actual bundle structure, this fits 'references present but not clearly signaled' — the good_overall pattern of well-signaled one-level-deep references is not met, but structure itself is more than minimal. | 3 / 5 |
Total | 16 / 20 Passed |