Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with concrete templates and clear sequencing, but it carries redundancy (a duplicated constraints table), lacks a verification feedback loop for a batch operation, and is monolithic rather than progressively disclosed.
Suggestions
Add a post-batch verification step (e.g., re-run lint/typecheck or confirm files still parse) before reporting success, creating a validate→fix→retry loop for this destructive/batch operation.
Remove the 'Constraints and Limits' table or replace it with a one-line pointer to Step 2, since it duplicates the chunking and size limits already stated there.
Move the worker-agent prompt template, full usage examples, and dry-run block into reference files (e.g., references/prompt-template.md, examples.md) and link to them from the overview to enable progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is instruction-dense and not padded with basic concepts, but the 'Constraints and Limits' table duplicates Step 2 rules and the three full usage-example flows add length that could be tightened. | 2 / 3 |
Actionability | Provides copy-paste-ready guidance — a concrete chunking table, a full worker-agent prompt template, explicit glob/exclusion lists, and an exact output format — well beyond pseudocode. | 3 / 3 |
Workflow Clarity | The 5-step sequence is clear with discovery checkpoints (empty-batch abort, 50/100-file warnings), but as a batch/destructive operation it lacks a post-modification validation/verification feedback loop, capping it at 2. | 2 / 3 |
Progressive Disclosure | Sections are well-organized, but the ~295-line skill is monolithic with no bundle files — content like the prompt template, exclusions, and examples is all inline rather than split into one-level-deep references. | 2 / 3 |
Total | 9 / 12 Passed |