Content
75%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 well-organized, largely executable skill body with a clear end-to-end workflow and real bundle files backing the references. The main issues are a non-functional `--type "article"` flag in the flagship example, a missing `assets/examples/` directory, and the absence of an explicit validation feedback loop.
Suggestions
Fix the Example Usage command: replace `--type "article"` with a valid query_template.py choice (e.g. `--type journals`) so the flagship example runs as written.
Either create `assets/examples/` with the venue-typical writing samples described in the body, or remove the two references to it (lines 29 and 86) to avoid a dead pointer.
Add an explicit feedback loop after step 4 (e.g. "If validation reports violations, adjust the template/metadata and re-run validate_format.py until it passes") to lift workflow clarity to a 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and assumes Claude's LaTeX competence, but the Key Features and Implementation Details sections restate the template/requirement inventory, and Implementation Details lightly over-explains what the scripts do rather than just pointing to them. | 4 / 5 |
Actionability | Provides copy-paste bash commands for a full query → customize → compile → validate flow with real file paths, but the example uses `--type "article"` which the script rejects (valid choices are journals/posters/grants/all), so the literal command would fail. | 4 / 5 |
Workflow Clarity | Clear numbered sequence with an explicit validation checkpoint (step 4, validate_format.py), but it lacks the explicit "if validation fails, fix and re-run" feedback loop that anchors a 5 for batch/destructive-style operations. | 4 / 5 |
Progressive Disclosure | Well-signaled one-level-deep references into references/ and assets/ with organized sections, but `assets/examples/` is referenced twice in the body and does not exist, leaving a broken navigation pointer. | 4 / 5 |
Total | 16 / 20 Passed |