Content
58%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 harness-generated redirect stub: maximally lean, but it delegates 100% of the skill's substance to an external path that does not ship with the bundle. As written, it provides no workflow, no task guidance, and no verifiable reference structure. The conciseness is exemplary, but actionability, workflow clarity, and progressive disclosure all suffer from the total absence of in-bundle content.
Suggestions
Inline a concise overview of the scaffolding workflow (key steps and per-language tooling table) in SKILL.md so the skill remains useful when the shared path `~/.agents/skills/new-project/SKILL.md` is unavailable.
Replace the absolute home-directory reference with a bundled, relative reference (e.g., copy the shared content into references/ and link it), and remove or fix the dangling `scripts/agent-harnesses.py` mention so all referenced files actually exist in the skill.
Add a post-scaffold validation step (e.g., run `just` tasks or lint the generated CI) so the workflow includes a checkpoint after the batch file-creation operation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines — a generation comment and a single load instruction — with zero padding and no re-explanation of concepts Claude already knows. Every token present earns its place, matching anchor 5 exactly; anchor 4 would require trimmable over-explanation that does not exist here. | 5 / 5 |
Actionability | The one instruction — "Load and follow the shared skill at `~/.agents/skills/new-project/SKILL.md`" — is concrete and executable, but all guidance for the actual scaffolding task is delegated away, leaving key details absent from the body. This is anchor 3 (some concrete guidance but incomplete) rather than 4, since the body contains no actionable direction for the task itself, and above anchor 2 because the directive is specific, not a high-level hint. | 3 / 5 |
Workflow Clarity | No sequence for the multi-step scaffolding process appears in the body — only a single coherent delegation directive with no validation checkpoints. It sits above anchor 1 because the one instruction present is unambiguous, but below anchor 3 because no actual work steps are listed at all, leaving many gaps as in anchor 2. | 2 / 5 |
Progressive Disclosure | The reference is clearly signaled and one level deep, but the body is a pure redirect with no overview content, and neither referenced path exists in the bundle (`~/.agents/skills/new-project/SKILL.md` is outside the skill and unverifiable; `scripts/agent-harnesses.py` is absent). This matches anchor 3 (some structure, organization concerns) rather than 4, since content is not appropriately placed or split within the skill itself. | 3 / 5 |
Total | 13 / 20 Passed |