Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-sequenced, highly actionable setup workflow with a strong confirm checkpoint. Its main weakness is progressive disclosure: the body links to five seed-template files that are absent from the skill folder.
Suggestions
Ship the referenced seed templates (issue-tracker-github.md, issue-tracker-gitlab.md, issue-tracker-local.md, triage-labels.md, domain.md) so the body's links resolve, or inline minimal versions and drop the links.
Tighten the user-facing explainer paragraphs and deduplicate the CLAUDE.md/AGENTS.md file-selection rules to improve token efficiency.
Add a brief post-write verification step (e.g. re-read the edited file to confirm the '## Agent skills' block inserted correctly) to strengthen the feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete paths, commands, and decision rules that earn their place, but long user-facing explainer paragraphs (e.g. the 'issue tracker' explainer) and restated file-selection rules could be tightened; not the lean score-3 case. | 2 / 3 |
Actionability | Provides executable specifics — `git remote -v`, exact file paths, default label strings, a copy-paste markdown block, and crisp decision rules ('如果 CLAUDE.md 存在,编辑它') — making the guidance copy-paste ready despite being instruction-only. | 3 / 3 |
Workflow Clarity | A clearly numbered 5-step sequence (Explore → Present → Confirm → Write → Done) with an explicit confirm-before-write checkpoint and guard rules against duplicate blocks and clobbered edits, satisfying the validation-checkpoint requirement for destructive file writes. | 3 / 3 |
Progressive Disclosure | Sections are well organized and seed templates are signaled with one-level-deep markdown links, but the referenced bundle files (issue-tracker-github.md, -gitlab.md, -local.md, triage-labels.md, domain.md) do not exist, so the actual bundle structure does not deliver the promised disclosure. | 2 / 3 |
Total | 10 / 12 Passed |