Content
42%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 buries a thin layer of real guidance (parameters, returns, workflow) under heavy template boilerplate, and its most actionable element — the parameter table — documents a CLI that does not match the packaged script. Structural issues (broken 'see above' references, thrice-repeated commands) further reduce navigability.
Suggestions
Fix the Parameters table to match the actual script interface (--budget/-b, --start, --end, --expenses) and add one complete runnable example with real values, e.g. `python scripts/main.py --budget 150000 --start 2025-01-01 --end 2026-12-31 --expenses expenses.csv`.
Cut the generic governance sections (Risk Assessment, Security Checklist, Evaluation Criteria, Lifecycle Status, Response Template) or move them out of SKILL.md — they consume most of the token budget without skill-specific content.
Repair the broken cross-references ("See ## Prerequisites above" and "See ## Workflow above" point to sections that appear below) and merge the three duplicated command sections (Example Usage, Quick Check, Audit-Ready Commands) into one.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~187-line body is dominated by generic governance boilerplate (Risk Assessment, Security Checklist, Evaluation Criteria, Lifecycle Status, Response Template) that adds no skill-specific knowledge, repeats the frontmatter description verbatim in both "When to Use" and "Key Features", and states the same two commands (py_compile, --help) in three separate sections. Above score 1 because the Parameters, Returns, and Workflow sections do carry real content. | 2 / 5 |
Actionability | Concrete commands exist (py_compile, --help) and a parameter table is provided, but the documented flags (--current-balance, --monthly-burn, --upcoming-costs, --currency, --output/-o) do not match the packaged script's actual interface (--budget/-b, --start, --end, --expenses), the example hardcodes a non-portable path ("20260318/scientific-skills/Data Analytics/lab-budget-forecaster"), and there is no runnable end-to-end example with real values. Below score 4 because the documented interface cannot be executed against the actual script; above score 2 because a genuine command set and structure are present. | 3 / 5 |
Workflow Clarity | The Workflow section gives a 5-step sequence with an early scope-validation stop and an explicit fallback step, but the steps are generic process prose detached from the script (no commands embedded) and there is no output-validation checkpoint (e.g. sanity-checking date ordering, zero burn rate, or verifying the forecast). Fits anchor 3 — sequence present, checkpoints implicit rather than executable. | 3 / 5 |
Progressive Disclosure | The bundle is simple and correctly referenced (scripts/main.py exists and is consistently cited), and the body has section headers — but the file is monolithic with redundant sections, and navigation is broken: "Dependencies" says "See ## Prerequisites above" and "Implementation Details" says "See ## Workflow above" while both target sections actually appear below those references. Below score 4 due to broken cross-references and triple-duplicated command sections; above score 2 because real structure exists and bundle references resolve. | 3 / 5 |
Total | 11 / 20 Passed |