Content
88%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 mature, action-oriented skill body with strong sequencing, real validation checkpoints, and a sharp 'Never do these' guardrail section. It is concise for its complexity and avoids padding, though some rationale prose and a couple of external-doc pointers could be tightened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and largely assumes Claude's competence (no primer on what forks/rebase are), but a few rationale sentences and external-doc pointers ('See the README source deployment procedure', 'per AGENTS.md') could be trimmed without losing the decision guidance. | 4 / 5 |
Actionability | Provides copy-paste-ready commands with placeholders for both paths — `npm install --save-exact @yc-software/qm@<version>`, the full merge block, `node cli/bin/qm.ts check --config ...`, and `gh pr create --repo <source-fork>` — covering the common cases. | 5 / 5 |
Workflow Clarity | Clear sectioned sequence (identify → merge → resolve → verify → open PR) with explicit validation checkpoints (`npm ci`, typecheck/lint, CLI check/doctor/plan) and feedback loops (Already-up-to-date → delete branch; contract-major mismatch → adapt config). | 5 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections with no nested references, and the external pointers (AGENTS.md, README, upstream-pr skill) are one level deep; however everything is inlined in a ~140-line file with no content split into bundle files. | 4 / 5 |
Total | 18 / 20 Passed |