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.
A highly actionable, well-structured skill body with precise numeric rules and a copy-paste-ready CLI, undermined mainly by navigation: the bundled methodology and exposure-policy references are orphaned (never linked), one referenced config path is dangling, and a few internal/bilingual artifacts leak into the prose. Adding a validation/retry loop for data-fetch failures would round out the workflow.
Suggestions
Add a short '## References' section linking references/ibd_distribution_methodology.md and references/tqqq_exposure_policy.md (e.g., '**Methodology details**: See [ibd_distribution_methodology.md](references/ibd_distribution_methodology.md)') so the bundled detail files are discoverable from SKILL.md.
Fix or remove the dangling `config/default.yaml` reference in Operating Principles — the file is absent from the bundle, so either ship it or point to wherever the rule defaults actually live.
Trim internal artifacts: drop the "直近 N 取引日" comparison in Counting Conventions and the "Japanese explanations preserved" note in Outputs, and replace them with plain-English phrasing; add a one-line fallback for FMP fetch failures in the Workflow to create a validate-retry checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven, assumes competence (never explains what IBD, EMA, or distribution days are), and every table earns its place. Minor trim candidates keep it from score 5: the Purpose paragraph restates the frontmatter description, and the Counting Conventions note referencing the Japanese phrase "直近 N 取引日" plus "Japanese explanations preserved" in Outputs expose internal i18n details irrelevant to executing the skill. | 4 / 5 |
Actionability | Fully executable guidance throughout: a copy-paste-ready CLI invocation with all flags ("python3 skills/ibd-distribution-day-monitor/scripts/ibd_monitor.py --symbols QQQ,SPY --lookback-days 80 ..."), precise numeric detection rules (0.2% decline, higher volume, 25-session expiration, 5% invalidation), API-key resolution priority order, exact output filename patterns, and named pipeline functions. The common case is covered completely, matching the top anchor. | 5 / 5 |
Workflow Clarity | The 9-step workflow is clearly sequenced with named functions and includes a validation checkpoint ("Validate data quality; record skipped sessions in audit") plus explicit handling of insufficient data ("flag market_below_21ema_or_50ma (None if data insufficient)"). It lacks a validate-fix-retry feedback loop (e.g., what to do when the FMP fetch fails or data quality is rejected), so it does not reach score 5; the read-only analysis workflow is not destructive/batch, so the score-3 cap does not apply. | 4 / 5 |
Progressive Disclosure | The body is well sectioned and properly wired to the scripts bundle (CLI path resolves, workflow function names match real modules), but the two reference files in references/ (ibd_distribution_methodology.md, tqqq_exposure_policy.md) are never linked or signaled anywhere in SKILL.md — they are undiscoverable — and line 82 references config/default.yaml, which does not exist in the bundle. This matches "references present but not clearly signaled" (score 3) rather than score 4, whose "references mostly clear" requirement fails outright. | 3 / 5 |
Total | 16 / 20 Passed |