Content
92%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 content is exemplary: concise, free of over-explanation, with concrete commands, a real verification checkpoint, and clean delegation to a sibling skill for relationship management. The only notable gap is the absence of the full `gh issue create` invocation alongside the verification command.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and efficient — "Never pass multiline Markdown inline through shell arguments" states the non-obvious rule directly, and every section (titles, bodies, verification, relationships) adds knowledge Claude would not infer. Nothing over-explains known concepts, so it matches the anchor for every token earning its place. | 5 / 5 |
Actionability | Concrete, executable guidance is present: the verification command `gh issue view <number> --json title,body`, the `--body-file` flag, and copy-paste title templates (`@remotion/package`: Issue description). It is not a 5 because the primary `gh issue create --title ... --body-file ...` invocation is never shown, leaving the most common action as an inferred command. | 4 / 5 |
Workflow Clarity | The single action is unambiguous with an explicit validation checkpoint: write the body to a temp file, pass it with `--body-file`, then "verify its title and body" with `gh issue view` and confirm "real newlines rather than literal \n sequences". This satisfies the simple-skill exception with a complete verify step, so it matches the top anchor rather than the minor-validation-gaps anchor below it. | 5 / 5 |
Progressive Disclosure | At ~38 lines with well-organized sections and no bundle files needed, this matches the under-50-line guideline for a top score. The one reference to [`issue-management`](../issue-management/SKILL.md) is clearly signaled and exactly one level deep, correctly delegating relationship work instead of duplicating it. | 5 / 5 |
Total | 19 / 20 Passed |