Content
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured with a clear workflow and useful code examples, but it is verbose (explaining domain concepts Claude already knows and restating the workflow), references a missing analyzer script, and points to bundle files that are absent from the package.
Suggestions
Trim domain background and repeated extension/library lists that Claude already knows; keep only the format-to-reference-file mapping and the per-format analysis steps.
Add an explicit validation/verification checkpoint (e.g., confirm detected format against the reference, retry on parse errors) to the main workflow for batch file analysis.
Either ship the referenced bundle files (references/*.md, scripts/eda_analyzer.py, assets/report_template.md) or remove the references to them so signaled navigation resolves to real content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is heavily padded with concepts Claude already knows (enumerated file extensions per domain, what each domain contains, repeated library-install patterns) and restates the workflow as comment pseudocode in the Examples section, plus a self-promotional K-Dense Web plug; it earns the verbose anchor rather than the mostly-efficient level-2 anchor. | 1 / 3 |
Actionability | Provides a concrete script invocation and real code snippets (SeqIO, pandas read_csv, ND2Reader), but the referenced analyzer script does not exist on disk and several examples are comment-style rather than fully executable, leaving guidance incomplete. | 2 / 3 |
Workflow Clarity | A clear five-step sequence is present (detect, load reference, analyze, report, save), but the batch/analysis workflow has no explicit validation checkpoints or fix-and-retry feedback loop, which caps it at 2 per the batch-operations guideline. | 2 / 3 |
Progressive Disclosure | The markdown is well organized with one-level-deep reference signals per category, but the referenced bundle files (references/*.md, scripts/eda_analyzer.py, assets/report_template.md) do not exist on disk, so the signaled navigation cannot actually be followed. | 2 / 3 |
Total | 7 / 12 Passed |