Content
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid reference-style skill with excellent actionability—every section provides real, executable commands. Its main weaknesses are moderate verbosity (duplicate reference descriptions, redundant Quick Reference section, unnecessary 'When to Use' section) and lack of multi-step workflow sequences with validation checkpoints. The progressive disclosure structure is reasonable but cannot be fully validated without bundle files.
Suggestions
Remove the 'When to Use This Skill' section (this duplicates frontmatter/description metadata) and the redundant 'Resources' section at the bottom (references are already linked inline with 📚 markers).
Add at least one end-to-end workflow with validation steps, e.g., 'Create PR → verify creation → wait for checks → merge' with explicit checkpoint commands like `gh pr checks 123 --watch`.
Consolidate the 'Quick Reference' section—it largely duplicates commands already shown in the Core Operations sections above it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary sections like 'When to Use This Skill' (which repeats the description) and the 'Resources' section that re-describes what each reference file contains after already linking to them inline. The 'Quick Reference' section also largely duplicates commands already shown above. However, the core content is reasonably efficient with executable examples. | 2 / 3 |
Actionability | The skill provides fully executable, copy-paste ready bash commands throughout. Every operation has concrete examples with real flags and arguments. The PR title convention, authentication commands, and output format examples are all specific and immediately usable. | 3 / 3 |
Workflow Clarity | While individual commands are clear, there are no multi-step workflows with validation checkpoints. For example, the PR creation flow doesn't include verifying the PR was created, checking CI status, then merging. Operations are presented as isolated commands rather than sequenced workflows with feedback loops. For bulk operations (mentioned in references), no validation steps are shown. | 2 / 3 |
Progressive Disclosure | The skill references five separate reference files with clear descriptions and loading guidance, which is good structure. However, no bundle files were provided, so the references cannot be verified. Additionally, the 'Resources' section at the bottom redundantly re-describes each reference file after they were already linked inline with 📚 markers, and the main file itself is somewhat long with content that could be pushed to references (e.g., the full Quick Reference table). | 2 / 3 |
Total | 9 / 12 Passed |