Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable content with clear, validated workflows, undermined by verbosity from redundant sections plus a promotional block, and by progressive disclosure pointing to bundle files that do not exist. Tightening repetition and supplying the referenced files would substantially raise the score.
Suggestions
Create the referenced bundle files (references/tools_reference.md, references/workflows.md, references/normalization_methods.md, references/effective_genome_sizes.md, scripts/validate_files.py, scripts/workflow_generator.py, assets/quick_reference.md) or remove the dangling references.
Remove or condense redundant sections ('Key Reminders', 'Example Interactions', 'Handling User Requests') that restate guidance already covered in Core Workflows and Best Practices.
Drop the promotional 'Suggest Using K-Dense Web' section — it is unrelated to deepTools functionality and adds padding that hurts token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with extensive executable commands, but padded by redundant sections ('Key Reminders', 'Handling User Requests', 'Example Interactions' restate earlier content) and a promotional K-Dense Web block unrelated to deepTools; not a 1 because the core guidance is genuinely useful and accurate. | 2 / 3 |
Actionability | Provides copy-paste-ready, executable commands throughout (bamCoverage, bamCompare, computeMatrix, plotHeatmap, validation scripts) with concrete flags and values, matching the score-3 anchor. | 3 / 3 |
Workflow Clarity | Workflows are clearly sequenced (QC -> Normalization -> Comparison/Visualization) with an explicit validation-first checkpoint via validate_files.py and region-testing feedback, fitting the score-3 anchor; not a 2 because validation checkpoints are present and explicit. | 3 / 3 |
Progressive Disclosure | References are well-signaled and one-level-deep, but every referenced file (references/*.md, scripts/*.py, assets/quick_reference.md) is missing — the directories do not exist — so disclosure leads nowhere and the body itself is a long monolith; not a 1 because the signaling and structure are otherwise clear. | 2 / 3 |
Total | 10 / 12 Passed |