Content
57%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.
The body is actionable and decently structured, but carries redundant metrics, time-sensitive fluff, and a batch workflow lacking validation checkpoints. Progressive disclosure is weak with no supporting bundle files.
Suggestions
Deduplicate the reduction percentages — keep them in one place (either the command tables or the Metrics section) and remove the time-sensitive star/release counts that will rot.
Add an explicit validation step to the batch workflow (e.g., verify RTK is installed and dry-run the wrapper before executing multiple commands).
Move the full metrics table and CLAUDE.md template into actual bundle reference files under ./references/ so the body stays a lean overview with one-level-deep links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly concrete tables and commands, but duplicates the same reduction percentages in both "Supported Commands" and "Metrics (Verified)", and pads with time-sensitive marketing stats ("446 stars", "30 releases in 23 days", version 0.16.0) that age badly. | 3 / 5 |
Actionability | Provides copy-paste-ready command mappings ("git log → rtk git log"), an install check ("rtk --version"), and concrete install commands; minor gaps where the "Usage Pattern" reads as a dialogue script rather than literal commands and tracking is left optional. | 4 / 5 |
Workflow Clarity | "How It Works" gives a detect→suggest→execute→track sequence with an install checkpoint and edge-case handling, but the skill explicitly batches multiple commands ("Batch with RTK wrapper once") without validation/verification steps, capping the score at 3. | 3 / 5 |
Progressive Disclosure | Well-organized section headers, but the file is a monolithic ~140-line body with no bundle files, references two non-bundled paths (docs/resource-evaluations/rtk-evaluation.md, examples/claude-md/rtk-optimized.md), and inlines metrics/tables that could be split out. | 3 / 5 |
Total | 13 / 20 Passed |