Content
56%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 highly actionable and has a clear, validated recalc workflow, but it is verbose with redundant and elementary explanations and is structured as a single 290-line file that references a script not present in the bundle.
Suggestions
Trim the elementary pandas/openpyxl tutorials (df.head/info/describe, basic load_workbook) to assume Claude's competence, and consolidate the three recalc.py descriptions into one section.
Provide the referenced recalc.py in a scripts/ bundle directory (or inline its contents), since the workflow depends on a file that does not currently exist.
Move the detailed financial-modeling color/number/formula standards and the recalc.py JSON output schema into separate reference files linked from the overview, leaving SKILL.md as a concise entry point.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~290-line body teaches concepts Claude already knows (pandas df.head/info/describe, basic openpyxl load_workbook, what #REF!/#DIV/0! errors are) and repeats the recalc.py instructions across three separate sections, making it noticeably padded. | 2 / 5 |
Actionability | Concrete executable code (pandas read/write, openpyxl create/edit), explicit commands (`python recalc.py output.xlsx 30`), and exact RGB values and format strings make the guidance mostly copy-paste ready; the gap is that the referenced recalc.py is not present in any bundle. | 4 / 5 |
Workflow Clarity | The numbered Common Workflow includes a mandatory recalculation step and a verify-and-fix feedback loop ("Fix the identified errors and recalculate again"), plus a Formula Verification Checklist, but the workflow is scattered across three redundant recalc sections rather than one canonical sequence. | 4 / 5 |
Progressive Disclosure | No bundle files exist yet the body references recalc.py as if provided, and the large monolith inlines distinct domains (financial-modeling standards, general Excel ops, recalc output schema) that have section headers but no file-level separation. | 3 / 5 |
Total | 13 / 20 Passed |