Content
81%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 a strong, highly actionable runbook with explicit validation and error-recovery loops — among the better executable skills. Its main weaknesses are mild token inefficiency (redundant explanations of known GitHub concepts and repeated @-mention behavior) and a single-file structure that is slightly long for a SKILL.md overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, direct instruction, but contains unnecessary explanation: "GitHub has 'repositories' containing 'pull requests' and 'issues'" teaches concepts Claude already knows, the nc:prompt/vault design rationale is tangential, and the GITHUB_BOT_USERNAME @-mention behavior is explained twice (Wiring and Channel Info). Not 4: there are several, not just minor, instances that could be trimmed. | 3 / 5 |
Actionability | Fully executable throughout: concrete nc: directive fences, a pinned dependency (@chat-adapter/github@4.41.1), real ncl/gh/launchctl/systemctl commands, and specific token permissions ("Pull requests (Read & Write), Issues (Read & Write)"). Placeholders like <policy> and <mg-id> are appropriate parameterization, and copy-paste-ready commands cover the common cases. | 5 / 5 |
Workflow Clarity | Clear sequence (Apply → Credentials → Wiring → Next Steps) with explicit validation checkpoints: the build guards the typed core call and the vitest run proves the barrel import and dependency are intact. Troubleshooting provides feedback loops (red registration test → re-run Apply steps; webhook redelivery to retest). Not 4: validation is explicit and error recovery is covered end-to-end. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the skill is a single self-contained runbook with well-organized sections (Apply, Credentials, Wiring, Channel Info, Troubleshooting) and no nested references. Not 5: at ~185 lines it exceeds overview scope — the Troubleshooting and Channel Info sections could plausibly live in a referenced file; not 3: structure is genuinely good and navigation is easy. | 4 / 5 |
Total | 17 / 20 Passed |