Content
65%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 compact, well-sectioned router skill with no token waste on known concepts. Its weaknesses are the contradictory invocation instructions (slash command vs. /prompts route) and purely descriptive capability bullets, which together leave the executor uncertain of the exact action to take.
Suggestions
Resolve the conflicting invocation paths: state one canonical way to trigger the skill (e.g., only "/prompts:git-master with the user task") and remove or clarify the other.
Consolidate the Usage and Routing sections — they repeat the same instruction — into a single section showing the exact command with a concrete example task.
Add one line of routing guidance (what kinds of requests belong here vs. plain git answers) so the router makes a defensible dispatch decision.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanations of concepts Claude already knows, but the single routing instruction is stated three times — "Routes to the git-master agent for git operations", the Usage block "/git-master <git task>", and the Routing block "Use /prompts:git-master with the user task" — which is minor redundancy that could be trimmed. It is above 3 because there is no padding or unnecessary explanation, but short of 5 since the duplication does not earn its tokens. | 4 / 5 |
Actionability | Concrete commands are present ("/git-master <git task>", "Use /prompts:git-master with the user task") but the two invocation syntaxes conflict without reconciliation, leaving key details missing — which one actually triggers the agent, and what a well-formed task input looks like. It is not 2 because real commands are given, not just high-level hints, and not 4 because the ambiguity is more than a minor gap. | 3 / 5 |
Workflow Clarity | This is a simple single-step routing skill, but the single action is ambiguous: the Usage section shows a slash command while the Routing section shows a "/prompts:" route, with no statement of which applies or how they relate. The simple-skill exception (score 5 for an unambiguous single action) therefore does not hold; it is not 2 because a rough sequence (invoke the command with the task) is still discernible. | 3 / 5 |
Progressive Disclosure | The skill is under 50 lines, has no need for external references, and is organized into clear, well-labeled sections (Usage, Routing, Capabilities). Per the scoring notes for short, single-purpose skills with no external reference needs, this earns a 5. | 5 / 5 |
Total | 15 / 20 Passed |