Content
65%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 concise, well-organized best-practice checklist for modern C++ with specific, actionable guidance and named tooling. Its main weaknesses are generic template boilerplate and the lack of an explicit sequenced workflow with validation checkpoints.
Suggestions
Remove the generic 'Instructions' boilerplate ('Clarify goals, constraints...', 'Apply relevant best practices and validate outcomes') and the tautological 'cpp pro' phrasing in the use/do-not-use sections; replace with C++-specific guidance.
Add one or two short executable code snippets (e.g. a unique_ptr/RAII example or a CMake minimum-standard snippet) to lift actionability toward copy-paste ready.
Restructure 'Approach' into a sequenced workflow with an explicit validation checkpoint (e.g. compile with warnings, then run ASan/TSan, then benchmark) so the steps and feedback loop are unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean lists, but includes generic boilerplate ('Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes.') and tautological 'cpp pro' phrasing in the use/do-not-use sections that could be tightened. | 3 / 5 |
Actionability | Gives concrete, specific directives — 'Use smart pointers when heap allocation is necessary', 'Follow the Rule of Zero/Three/Five', 'Leverage STL algorithms over raw loops' — and names exact tools (Google Test, Google Benchmark, ASan/TSan, perf/VTune), though no executable code blocks are present. | 4 / 5 |
Workflow Clarity | The numbered 'Approach' list gives a priority order but reads as best-practice principles rather than a sequenced workflow; validation checkpoints are only implicit ('AddressSanitizer/ThreadSanitizer clean output') rather than explicit steps. | 3 / 5 |
Progressive Disclosure | Body is under 50 lines with no bundle files and is organized into clear, well-labeled sections (Focus Areas, Approach, Output), satisfying the simple-skill exception for progressive disclosure. | 5 / 5 |
Total | 15 / 20 Passed |