Content
61%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 highly actionable, well-structured operational guide whose main weaknesses are a missing post-batch verification step (which caps workflow clarity) and duplicated constraint/repetition content that inflates token usage. Progressive disclosure is solid for a single-file skill, though the length invites splitting.
Suggestions
Add an explicit post-batch validation step (e.g., spot-check a sample of edited files, run relevant tests, or re-read modified files to confirm agent-reported successes) to lift the batch-operation workflow cap.
Deduplicate the chunking limits — the Constraints table repeats the Step 2 table and algorithm verbatim; keep one canonical location and reference it.
Collapse the three-fold repeated Example Invocation block into a single annotated example plus a note that N chunks mean N parallel calls, and move usage examples or the output-format template to a reference file to reduce SKILL.md size.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient operational content, but the chunking limits are stated twice (the Step 2 table/algorithm and again verbatim in the Constraints table), and the Example Invocation block repeats the same agent call three times. Not 4 because the duplication is genuine tightening work; not 2 because there is no conceptual over-explanation — everything is operational. | 3 / 5 |
Actionability | Concrete, usable guidance throughout: exact glob patterns, an explicit exclusion list, a numeric chunking table, a complete copy-paste agent prompt template, and three worked usage examples with flows. Not 5 because the Example Invocation Pattern uses illustrative `<Agent tool call>` pseudo-blocks rather than literal parameters, and template placeholders like [file1.ts] leave minor gaps for edge cases. | 4 / 5 |
Workflow Clarity | The 5-step sequence is clearly ordered with some checkpoints (empty-match handling, >50/>100 file warnings, per-file failure continuation), but this is a batch operation with no post-run validation or verification step — no spot-check of edited files, test run, or re-read to confirm agent-reported success. The rubric's cap for batch operations without validation holds it at 3 despite the otherwise strong sequencing. Not 2 because steps are well defined with error-handling checkpoints, far above the anchor's 'validation absent and steps poorly defined'. | 3 / 5 |
Progressive Disclosure | No bundle files exist and the body references none (no dangling references to nonexistent files), and sections are well organized with clear headers, tables, and templates. Not 5 because at ~296 lines, content that could live in a separate reference file (usage examples, output format template) is inlined; not 3 because structure and navigation are good and nothing is buried. | 4 / 5 |
Total | 14 / 20 Passed |